Geocoding API

High Accuracy

Convert addresses to coordinates and look up addresses from coordinates. Explore geocoding and reverse-geocoding requests, responses and coverage.

Get your API key Open full docs

GET/api/1/geocode

Overview

The Geocoding API converts free-text addresses into precise coordinates (forward) and coordinates back into readable addresses (reverse). Forward search runs on a self-hosted Photon engine for fast, typo-tolerant, multilingual autocomplete that covers streets, addresses and points of interest; reverse runs on Nominatim for accurate structured results. Relevance controls — location bias, bounding box, category and strict country and city filters — let you tune results for any use case.

Forward geocoding (address to coordinate)

Reverse geocoding (coordinate to address)

Fast search suggestions (auto-complete)

High address accuracy

API reference

GET/api/1/geocode

Parameter	Type	Status	Description
q	string	Optional	The address to search (e.g. "Nizami Street, Baku").
reverse	boolean	Optional	Must be true to perform reverse geocoding (searching from coordinate to address).
point	string	Optional	Coordinate (lat,lng) to reverse geocode into an address. Required when reverse=true.
limit	integer	Optional	Maximum number of results to return (1–20, default 5).
lang	string	Optional	Preferred language for result names (e.g. en, az, ru). Defaults to en.
lat	number	Optional	Latitude to bias results toward (nearby matches rank first). Pair with lon.
lon	number	Optional	Longitude to bias results toward. Pair with lat.
bbox	string	Optional	Restrict results to a bounding box: minLon,minLat,maxLon,maxLat.
osm_tag	string	Optional	Filter by OSM tag, e.g. place (settlements) or amenity:cafe. Prefix with ! to exclude.
country	string	Optional	ISO 3166-1 alpha-2 country code, for example AZ. Returns results only within that country.
city	string	Optional	Strict city filter, for example Baku. Requires exactly one country code.
elastic	boolean	Optional	Elastic (fuzzy, high-recall) search — default true. Tolerates typos, missing diacritics (ə↔e), reordered words, generic words (metro, rayonu) and house numbers. Set false for strict exact matching.

Example request

Credit cost: 1 credit

curl "https://osrmroute.com/api/1/geocode?q=Nizami&country=AZ&city=Bak%C4%B1&lang=az&key=YOUR_KEY"

Industries

Use cases

Get started

SDKs & tools

API guides

Geocoding API

Overview

API reference

Example request

Other services

OSRMRoute Support

How can we help?