You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Julian Simioni d4b20beb7f
Add known issues
8 years ago
images crop png, switch png for jpg 9 years ago
.gitignore Stop tracking OSX .DS_Store files 9 years ago
.lgtm Add LGTM config 9 years ago
LICENSE.md Changes license from MIT (which applies to code only) to CC-BY-4.0 to apply to creative works 9 years ago
README.md 🔭 experiment to see if our README can be a symlink 9 years ago
add-search-to-a-map.md change real key to placeholder for tutorial - reverts earlier edits 9 years ago
api-keys-rate-limits.md remove pushed head symbols 9 years ago
autocomplete.md Merge pull request #133 from pelias/katie-revision 8 years ago
data-sources.md Correct order of layers 8 years ago
get-started.md remove free, add bullet list to index 9 years ago
glossary.md fix typo in api key definition 9 years ago
http-status-codes.md Retext Simplified Documentation 9 years ago
index.md Fix leaflet link (http, not https) 8 years ago
installing.md 2.x for heapsize link 8 years ago
place.md replace all keys 9 years ago
release-notes.md Add known issues 8 years ago
response.md replace all keys 9 years ago
reverse.md Correct definition of coarse layer alias 8 years ago
search.md Correct definition of coarse layer alias 8 years ago
transition-from-beta.md remove free, add bullet list to index 9 years ago
transition.md Another symlink, so we don't break old inbound links to transition.md 9 years ago
use-cors.md formatting, add w3c link, we to mapzen 9 years ago

README.md

Mapzen 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 Mapzen developer API key. You might use this functionality in any app that has a geographic element, including ones that deliver goods, locate hotels or venues, or even provide local weather forecasts.

Through a process known as geocoding, 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 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, 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, 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.

  • 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 map
  • API with generous rate limits