Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Canonical common names found in OSM.
JavaScript
branch: master

README.md

Name Suggestion Index

The goal of this project is to maintain a canonical list of commonly used name values for suggesting correct spelling and/or formatting that might otherwise diverge from common usage on OSM. When editing a place name like Walmart, users create many different spellings such as Wal-Mart, WalMart, Walmart Supercenter. In iD we want to help suggest the most common names with the correct formatting and spelling.

This index can also be used for passing additional values for a selected name. For example, it's known that McDonald's serves hamburgers so we can use that knowledge to fill in cuisine=burger or any other tags that are always associated with a specific name.

Contributing

We need help finding all the 'incorrect' names in topNames.json and mapping them to the correct equivalent so the incorrect name is not suggested. By 'correct', we only mean the most common usage on OSM. Check with filter.json to make sure we are using that tag combination and are not ignoring that name already. For example, "Papa John's" has been used 144 times, but has also been entered as "Papa John's Pizza" (62) and "Papa Johns" (68). Mapping them to a singular value is done in canonical.json:

"Papa John's": {
    "matches": [
        "Papa John's Pizza",
        "Papa Johns"
    ]
}
  • make necessary changes to canonical.json or filter.json ("what to edit" below)
  • run make
    • this will run build.js against topNames.json using the rules defined in filter.json and canonical.json
    • name-suggestions.json and name-suggestions.min.json will be updated

What to edit

  • canonical.json is a list of the most correct names, any possible similar matches to them, and any known tags.
  • filter.json determines which tag combinations are included and which names are completely ignored
  • name-suggestions.json and name-suggestions.min.json are compiled, any changes made to them directly will be overwritten

Updating topNames.json from planet

  • git clone https://github.com/osmlab/name-suggestion-index.git && cd name-suggestion-index
  • download the planet
    • wget http://planet.osm.org/pbf/planet-latest.osm.pbf
  • Ubuntu install (install recent nodejs):
    • sudo apt-get update
    • sudo apt-get install -y python-software-properties python g++ make
    • sudo apt-get install nodejs npm
    • sudo ln -s /usr/bin/nodejs /usr/bin/node
    • npm install
  • node getRaw yourOSMfile
    • results will go in topNames.json
Something went wrong with that request. Please try again.