diff --git a/data-sources.md b/data-sources.md index 580893b..6df2a8e 100644 --- a/data-sources.md +++ b/data-sources.md @@ -31,7 +31,7 @@ Quattroshapes data is licensed [CC BY](http://creativecommons.org/licenses/by/2. OpenAddresses is by far the largest dataset by number of records used by Mapzen Search, so even though it only contains address data (i.e. no building names or other metadata), it's a great resource for global geocoding. -As Openaddresses is sourced from regional governments, its data is in the public domain. +As OpenAddresses is sourced from regional governments, its data is in the public domain. ## Geonames diff --git a/get-started.md b/get-started.md index 5531582..4f732d4 100644 --- a/get-started.md +++ b/get-started.md @@ -1,6 +1,6 @@ # Get started with Mapzen Search -[Mapzen Search](https://mapzen.com/projects/search) is a modern geographic search service based entirely on open-source tools and powered by entirely open data. +[Mapzen Search](https://mapzen.com/projects/search) is a modern geographic search service based entirely on open-source tools and powered entirely by open data. The [source code is open](https://github.com/pelias/pelias) to view, modify, and contribute to. It's called Pelias, an experimental, community focused geocoder from Mapzen. Pelias is available for free and licensed for both commercial and non-commercial use. @@ -20,5 +20,5 @@ Mapzen Search offers: - Focusing a search: Searches all known places, but prioritizes places closer to the user (when the user's current location or approximate location is known) - Autocomplete searches for forward geocoding: Allows a developer to build interfaces where an end-user can search for places and match against Mapzen Search's data in real-time - Limiting results to a particular country: Allows the scoping of results to a particular country -- Reverse geocoding addresses + venues: Tries to find the name/address of the closest matching place to a geographic coordinate pair (a longitude and latitude). This can be used to take abstract location data (e.g. an end-user's device location) and find the closest address (often used in a weather or deliver app on someone's phone) -- Coarse reverse geocoding: Converts a geographic coordinate pair into the regional hiearchy for that particular place (e.g neighbourhood > locality (city/town) > Local Administrative Area (County, Prefecture) > Region (state/province) > country). This can be used to determine the general region of geographic data and can be quite useful in filtering for places in non-geographic databases that represent things that happen in places +- Reverse geocoding addresses + venues: Tries to find the name/address of the closest matching place to a geographic coordinate pair (a longitude and latitude). This can be used to take abstract location data (e.g. an end-user's device location) and find the closest address (often used in a weather or delivery app on someone's phone) +- Coarse reverse geocoding: Converts a geographic coordinate pair into the regional hierarchy for that particular place (e.g neighbourhood > locality (city/town) > Local Administrative Area (County, Prefecture) > Region (state/province) > country). This can be used to determine the general region of geographic data and can be quite useful in filtering for places in non-geographic databases that represent things that happen in places diff --git a/place.md b/place.md index 4901ec3..5222f69 100644 --- a/place.md +++ b/place.md @@ -8,7 +8,7 @@ To get started with a `/place` search, you need a [free, developer API key](http * layer - the type of place, such as a venue, address, or country. * id - the identification number of the item -If you have all of those, join them together with semicolon and pass them in with the `ids` parameter. +If you have all of those, join them together with semicolons and pass them in with the `ids` parameter. For example, this `/place` query looks up the Eiffel Tower in OpenStreetMap (OSM): @@ -18,7 +18,7 @@ https://search.mapzen.com/v1/place?api_key=search-XXXXXXX&ids=osm:venue:5013364 To search for more than one `/place` in a request, join multiple values together and separate them with a comma. For example, this /place query looks up the Eiffel Tower in OSM and `30 West 26th St, New York, NY` in OpenAddresses: -https://search.mapzen.com/v1/place?api_key=search-XXXXXXX&ids=osm:country:5013364,oa:address:65cf57e4eb5548eca9bb548fb1461633 +https://search.mapzen.com/v1/place?api_key=search-XXXXXXX&ids=osm:venue:5013364,oa:address:65cf57e4eb5548eca9bb548fb1461633 The results are returned in the order requested.