From 0ec1bf3ec18486b845c971d08e80efdaf5cbcb3f Mon Sep 17 00:00:00 2001 From: Riordan Date: Tue, 29 Mar 2016 16:15:52 -0400 Subject: [PATCH] Run through Retext. All same as before now passing --- data-sources.md | 12 ++++++------ place.md | 2 +- search.md | 2 +- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/data-sources.md b/data-sources.md index 7158322..0fb411a 100644 --- a/data-sources.md +++ b/data-sources.md @@ -28,17 +28,17 @@ Layers: - `locality` - `localadmin` - `neighbourhood` -- `coarse` (alias for simultaneously using all of the above) +- `coarse` (alias for simultaneously using all the above) [Who's on First](https://whosonfirst.mapzen.com) is an open data directory of worldwide "administrative places" created by Mapzen. It is our primary provider of: - Countries -- Regions (e.g. States, Provinces) +- Regions (for example: States, Provinces) - Counties - Localities (cities, towns, hamlets) - Neighbourhoods -Additionally, for addresses and venues (POI's) coming from OpenStreetMap, Geonames, and OpenAddresses, we use Who's on First to provide standardized fields for the country, region, locality, and neighbourhood (in addition to any other matching levels the place may fall within like counties or macro-regions). +Additionally, for addresses and venues (POI's) coming from OpenStreetMap, Geonames, and OpenAddresses, we use Who's on First to provide standardized fields for the country, region, locality, and neighbourhood. Other matching levels the place may fall within `macro-county` or `macro-region` taxonomy from Who's on Firsts. [License](https://github.com/whosonfirst/whosonfirst-data/blob/master/LICENSE.md) @@ -71,7 +71,7 @@ Layers: - `locality` - `localadmin` - `neighbourhood` -- `coarse` (alias for simultaneously using all of the above) +- `coarse` (alias for simultaneously using all the above) [Geonames](http://www.geonames.org/) is an aggregation of many authoritative and non-authoritative datasets. It contains information on everything from country borders to airport names to geographical features. While Geonames does not contain any shape data (such as country borders), it does have a powerful and well defined hierarchy to describe the relationships between different records. This custom hierarchy makes it harder to use in combination with data from other sources, but the Mapzen [Who's On First](http://whosonfirst.mapzen.com/) project will help by providing concordance between Geonames and other datasets. @@ -81,13 +81,13 @@ Geonames data is licensed [CC-BY-3.0](http://creativecommons.org/licenses/by/3.0 # Deprecated Sources -Certain data sources have previously been supported by Mapzen Search but are no longer offered part of the core service and have been superseded by a new data source. +Certain data sources used to be supported by Mapzen Search but are no longer offered part of the core service and have been superseded by a new data source. ## Quattroshapes `sources=quattroshapes` | `sources=qs` -Quattroshapes was previously used by Mapzen Search and its use was discontinued in April 2016. +Quattroshapes used to be supported by Mapzen Search and its use was discontinued in April 2016. It has been replaced by Who's on First, which continues to provide global administrative place data (countries, regions, counties, cities) and administrative lookup (_"what country, region, and city is this address part of?"_). diff --git a/place.md b/place.md index 93defdd..fbac615 100644 --- a/place.md +++ b/place.md @@ -16,7 +16,7 @@ https://search.mapzen.com/v1/place?api_key=search-XXXXXXX&ids=osm:venue:5013364 ## Search for multiple places in a query -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: +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 OpenStreetMap and `30 West 26th St, New York, NY` in OpenAddresses: https://search.mapzen.com/v1/place?api_key=search-XXXXXXX&ids=osm:venue:5013364,oa:address:65cf57e4eb5548eca9bb548fb1461633 diff --git a/search.md b/search.md index b960993..fb77ca0 100644 --- a/search.md +++ b/search.md @@ -160,7 +160,7 @@ For example, to find a YMCA within the state of Texas, you can set the `boundary Sometimes you don't have a rectangle to work with, but rather you have a point on earth—for example, your location coordinates—and a maximum distance within which acceptable results can be located. -In this example, you want to find all YMCA locations within a 35-kilometer radius of a location in Ontario, Canada. This time, you can use the `boundary.circle.*` parameter group, where `boundary.circle.lat` and `boundary.circle.lon` represents your location in Ontario and `boundary.circle.radius` is the acceptable distance from that location. Note that the `boundary.circle.radius` parameter is always specified in kilometers. +In this example, you want to find all YMCA locations within a 35-kilometer radius of a location in Ontario, Canada. This time, you can use the `boundary.circle.*` parameter group, where `boundary.circle.lat` and `boundary.circle.lon` is your location in Ontario and `boundary.circle.radius` is the acceptable distance from that location. Note that the `boundary.circle.radius` parameter is always specified in kilometers. > [/v1/search?api_key=search-XXXXXXX&text=YMCA&__boundary.circle.lon=-79.186484&boundary.circle.lat=43.818156&boundary.circle.radius=35__](https://search.mapzen.com/v1/search?api_key=search-XXXXXXX&text=YMCA&boundary.circle.lon=-79.186484&boundary.circle.lat=43.818156&boundary.circle.radius=35)