From 26a15d3e26eb2811b091b62e5e918f2603a3f4c3 Mon Sep 17 00:00:00 2001 From: Lou Huang Date: Thu, 15 Oct 2015 11:25:47 -0400 Subject: [PATCH 1/5] Change absolute links to other md files to relative --- get-started.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/get-started.md b/get-started.md index eed51c5..2262c65 100644 --- a/get-started.md +++ b/get-started.md @@ -1,10 +1,10 @@ # 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 entirely by open data. To start integrating Mapzen Search to your apps, you need a [free, developer API key](/api-keys-rate-limits.md). You might use this functionality in any app that has a geographic component, including ones that deliver goods, locate hotels or venues, or even provide local weather forecasts. +[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. To start integrating Mapzen Search to your apps, you need a [free, developer API key](api-keys-rate-limits.md). You might use this functionality in any app that has a geographic component, including ones that deliver goods, locate hotels or venues, or even provide local weather forecasts. -Through a process known as [geocoding](/search.md), Mapzen Search allows you to use natural language to find a particular place by entering an address or the name of a landmark or business, and then translates the result in to the geographic coordinates used by computers. Mapzen Search accesses [global databases](/data-sources.md) of place names and locations, but you can receive more locally relevant search results by limiting the search to a particular radius around a location (such as a cell phone), region, or country. With text [autocompletion capabilities](/autocomplete.md), you can search for places and match against Mapzen Search data in real-time. +Through a process known as [geocoding](search.md), Mapzen Search allows you to use natural language to find a particular place by entering an address or the name of a landmark or business, and then translates the result in to the geographic coordinates used by computers. Mapzen Search accesses [global databases](data-sources.md) of place names and locations, but you can receive more locally relevant search results by limiting the search to a particular radius around a location (such as a cell phone), region, or country. With text [autocompletion capabilities](autocomplete.md), you can search for places and match against Mapzen Search data in real-time. -Mapzen Search also enables the opposite workflow, known as [reverse geocoding](/reverse.md), to transform latitude and longitude values in to a list of places. This process attempts to find the name and address of the place nearest a longitude and latitude pair. For example, you can click a postion on the map to learn which business is located there. +Mapzen Search also enables the opposite workflow, known as [reverse geocoding](reverse.md), to transform latitude and longitude values in to a list of places. This process attempts to find the name and address of the place nearest a longitude and latitude pair. For example, you can click a postion on the map to learn which business is located there. Behind the scenes of your app, Mapzen Search can improve the quality of your own data by augmenting it with information where your users are located. You can pass the coordinates returned from Mapzen Search to other services, such as [Mapzen Turn-by-Turn](https://mapzen.com/projects/valhalla) that enables navigation and routing directions between points. Mapzen Search can also convert a geographic coordinate pair into the administrative boundary hierarchy containing it, such as a from the neighbourhood to the local administrative area, and on up to the country level. Getting this information can be useful when filtering for places in non-geographic databases. From 6e8941013d038cb0a34318df85ffb26959100629 Mon Sep 17 00:00:00 2001 From: Lou Huang Date: Thu, 15 Oct 2015 11:27:23 -0400 Subject: [PATCH 2/5] Change absolute links to other md files to relative --- search.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/search.md b/search.md index cc5319e..d3ec6c6 100644 --- a/search.md +++ b/search.md @@ -327,7 +327,7 @@ If you wanted to combine several data sources together, set `sources` to a comma | `text` | YMCA | | `sources` | osm,gn | -Each of these data sources has properties, licenses, and strengths. You can learn more about the [data sources for Mapzen Search](/data-sources.md). +Each of these data sources has properties, licenses, and strengths. You can learn more about the [data sources for Mapzen Search](data-sources.md). ### Filter by data type In Mapzen Search, place types are referred to as `layers`, ranging from fine to coarse. The Mapzen Search layers are derived from the hierarchy created by the gazetteer [Who's on First](https://github.com/whosonfirst/whosonfirst-placetypes/blob/master/README.md) and can be used to facilitate coarse geocoding. Here's a list of the types of places you could find in the results, sorted by granularity: From 1fcb9d1238d0792ca283e88cedfd7769d2d84ffc Mon Sep 17 00:00:00 2001 From: Lou Huang Date: Thu, 15 Oct 2015 11:27:43 -0400 Subject: [PATCH 3/5] Change absolute links to other md files to relative --- reverse.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reverse.md b/reverse.md index 7531b0d..0fc561c 100644 --- a/reverse.md +++ b/reverse.md @@ -42,7 +42,7 @@ The default value for `size` is `10` and the maximum value is `40`. Specifying a ### Filter by data source -By default, reverse geocoding returns results from any [data source](/data-sources.md) available to Mapzen Search. To filter results by source, specify one or more valid source names in a comma-delimited list using the `sources` parameter. For example, the following request returns only results from OpenStreetMap: +By default, reverse geocoding returns results from any [data source](data-sources.md) available to Mapzen Search. To filter results by source, specify one or more valid source names in a comma-delimited list using the `sources` parameter. For example, the following request returns only results from OpenStreetMap: >[/v1/reverse?api_key=search-XXXXXXX&point.lat=48.858268&point.lon=2.294471&___sources=osm___](https://search.mapzen.com/v1/reverse?api_key=search-XXXXXXX&point.lat=48.858268&point.lon=2.294471&sources=osm) From c74f8a8a3a2c814662bb590ff15b67ed7b1bb4e2 Mon Sep 17 00:00:00 2001 From: Lou Huang Date: Thu, 15 Oct 2015 11:28:08 -0400 Subject: [PATCH 4/5] Change absolute links to other md files to relative --- response.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/response.md b/response.md index 8dfb19b..d9d329e 100644 --- a/response.md +++ b/response.md @@ -56,7 +56,7 @@ Each item in this list will contain all the information needed to identify it in ## Notable features ### GID -This is a "global id" that can be used to reference a result with the [/place](/place.md) endpoint. It consists of an identifier for the dataset, a layer, and finally an `id` for the individual record. This `id` corresponds to stable ids from datasets wherever possible (such as the ID of an OpenStreetMap Node or Way), but not all datasets have them. +This is a "global id" that can be used to reference a result with the [/place](place.md) endpoint. It consists of an identifier for the dataset, a layer, and finally an `id` for the individual record. This `id` corresponds to stable ids from datasets wherever possible (such as the ID of an OpenStreetMap Node or Way), but not all datasets have them. ### Label The `label` is a human-friendly representation of the place, ready to be displayed to an end user. The label field attempts to use a format that is appropriate for the region the result is in, although Mapzen Search only supports a few countries at the moment. From fbaee61f7b107954590aaa8865240edb52e549a5 Mon Sep 17 00:00:00 2001 From: Lou Huang Date: Thu, 15 Oct 2015 11:28:25 -0400 Subject: [PATCH 5/5] Change absolute links to other md files to relative --- http-status-codes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/http-status-codes.md b/http-status-codes.md index 97e14eb..c72364f 100644 --- a/http-status-codes.md +++ b/http-status-codes.md @@ -16,4 +16,4 @@ In all cases above, the response body will be valid geoJSON. ## Rate limiter The rate limiter returns the status codes `403 Forbidden` and `429 Too Many Requests`. -See [API keys and rate limits](/api-keys-rate-limits.md) for more information. +See [API keys and rate limits](api-keys-rate-limits.md) for more information.