diff --git a/api-keys-rate-limits.md b/api-keys-rate-limits.md index 7b191a3..480da01 100644 --- a/api-keys-rate-limits.md +++ b/api-keys-rate-limits.md @@ -2,7 +2,7 @@ ## Get an API key -To use the Mapzen Search service, you must first get a free developer API key. Sign in at https://mapzen.com/developers to create and manage your API keys. +To use the Mapzen Search service, you must first get a developer API key. Sign in at https://mapzen.com/developers to create and manage your API keys. 1. Go to https://mapzen.com/developers. 2. Sign in with your GitHub account. If you have not done this before, you need to agree to the terms first. @@ -10,7 +10,7 @@ To use the Mapzen Search service, you must first get a free developer API key. S 4. Copy the key into your code. ## Rate limits -Because Mapzen Search is a free, shared service, there are limitations on the numbers of requests to prevent individual users from degrading system performance. +Because Mapzen Search is a shared service, there are limitations on the numbers of requests to prevent individual users from degrading system performance. Mapzen Search allows you a maximum of: diff --git a/autocomplete.md b/autocomplete.md index 5b9bbf7..f7d2345 100644 --- a/autocomplete.md +++ b/autocomplete.md @@ -2,7 +2,7 @@ If you are building an end-user application, you can use the `/autocomplete` endpoint alongside `/search` to enable real-time feedback. This type-ahead functionality helps users find what they are looking for, without requiring them to fully specify their search term. Typically, the user starts typing and a drop-down list appears where they can choose the term from the list below. -To build a query with autocomplete, you need [a free, API developer key](https://mapzen.com/developers) and a `text` parameter, representing what a user has typed into your application so far. Optionally, you can specify a geographic point where the search is focused, this will allow users to see more local places in the results. +To build a query with autocomplete, you need an [API key](https://mapzen.com/developers) and a `text` parameter, representing what a user has typed into your application so far. Optionally, you can specify a geographic point where the search is focused, this will allow users to see more local places in the results. ## User experience guidelines diff --git a/get-started.md b/get-started.md index fc32aba..0f50fa8 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 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 part, 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 an [API key](api-keys-rate-limits.md). You might use this functionality in any app that has a geographic part, 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. diff --git a/glossary.md b/glossary.md index a619fcf..88a9e92 100644 --- a/glossary.md +++ b/glossary.md @@ -10,7 +10,7 @@ ## Mapzen Search API and developer terms - **API endpoint** - an architectural style for accessing web resources through a URL. In Mapzen Search, available endpoints include `search`, `reverse`, and `autocomplete`. You can construct a URL to send queries and receive responses from Mapzen Search. -- **API key** - an code that identifies the developer account without providing a password. Mapzen Search requires a free, API key to interact with the search service. +- **API key** - an code that identifies the developer account without providing a password. Mapzen Search requires an API key to interact with the search service. - **autocomplete** - enables real-time feedback when entering text for a search, typically, where users start typing and a drop-down list appears where they can choose the term from the list below. Use the `autocomplete` endpoint to do this. - **data source** - the datasets available to Mapzen Search. Only data sources that have open-source licenses are used. - **focus** - option to make places closer to a particular location be prioritized and appear higher in the search results list. After all nearby results have been found, additional results will come from the rest of the world, without any further location-based prioritization. diff --git a/index.md b/index.md index 71d3332..2eb86b3 100644 --- a/index.md +++ b/index.md @@ -3,3 +3,13 @@ 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 position on the map to learn which business is located there. + +## Features of Mapzen Search + +- Forward geocoding to find a place by searching for an address or name +- Reverse geocoding to find what is located at a certain coordinate location +- Autocomplete to give real-time result suggestions without having to type the whole location +- Global coverage with prioritized local results +- Open-source software using open data sources +- Plug-in for embedding search in a Leaflet-based maps +- API with generous rate limits diff --git a/search.md b/search.md index fb77ca0..288c2cb 100644 --- a/search.md +++ b/search.md @@ -4,7 +4,7 @@ Geospatial search, commonly referred to as geocoding, is the process of matching There's nothing inherent in the language we use to describe a physical address that allows us to convert that human readable sentence in to a format that a computer can understand, such as latitude & longitude. -Making the leap from text to coordinates is an intricate and challenging process. Lucky for you, Mapzen has done all the hard work and made it accessible though a free web service. +Making the leap from text to coordinates is an intricate and challenging process. Lucky for you, Mapzen has done all the hard work and made it accessible though a web service. All Mapzen Search requests share the same format: diff --git a/transition-from-beta.md b/transition-from-beta.md index 9643385..7ab5b7b 100644 --- a/transition-from-beta.md +++ b/transition-from-beta.md @@ -9,7 +9,7 @@ The changes aren't too drastic and should be implementable in an afternoon or a These changes also affect self-hosted users of Pelias upgrading from the beta to 1.0 (leaving aside API key restrictions), but these users can make the upgrade on their own time. ## API keys -The first big change is the introduction of API keys. Like all other Mapzen APIs, Search now requires a free API key. You can register at the [Mapzen Developer Portal](https://mapzen.com/developers) and generate one (or more) for all your search needs. +The first big change is the introduction of API keys. Like all other Mapzen APIs, Search now requires an API key. You can register at the [Mapzen Developer Portal](https://mapzen.com/developers) and generate one (or more) for all your search needs. Mapzen Search API keys allow you: