Geocode
Forward geocode an address
Forward geocode an address
Reverse geocode a coordinate
Reverse geocode a coordinate
Autocomplete a partial address
Autocomplete a partial address
Batch geocode multiple addresses
ModelsExpand Collapse
AutocompleteResult = object { features, type } GeoJSON FeatureCollection of autocomplete suggestions for partial address input. Optimized for low-latency type-ahead UIs. Content-Type: application/geo+json.
GeoJSON FeatureCollection of autocomplete suggestions for partial address input. Optimized for low-latency type-ahead UIs. Content-Type: application/geo+json.
Autocomplete suggestions ordered by relevance
Autocomplete suggestions ordered by relevance
GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.
GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.
coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of numberCoordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.
Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.
properties: object { display_name, category, city, 18 more } Geocoding result properties
Geocoding result properties
Interpolation confidence (0-1). Present only for interpolated results.
Complete formatted address from the database. Present for reverse geocode address results.
House or building number. Present for address and interpolated results.
Whether this result was estimated by address interpolation rather than an exact database match.
Relevance score (higher is better). Incorporates text match quality, spatial proximity boost, and popularity signals. Not bounded to 0-1.
source: optional "structured" or "bm25" or "fuzzy" or 3 moreResult source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)
Result source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)
GeocodeResult = object { features, type } GeoJSON FeatureCollection of forward geocoding results, ordered by relevance. Content-Type: application/geo+json.
GeoJSON FeatureCollection of forward geocoding results, ordered by relevance. Content-Type: application/geo+json.
Geocoding results ordered by relevance score
Geocoding results ordered by relevance score
GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.
GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.
coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of numberCoordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.
Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.
properties: object { display_name, category, city, 18 more } Geocoding result properties
Geocoding result properties
Interpolation confidence (0-1). Present only for interpolated results.
Complete formatted address from the database. Present for reverse geocode address results.
House or building number. Present for address and interpolated results.
Whether this result was estimated by address interpolation rather than an exact database match.
Relevance score (higher is better). Incorporates text match quality, spatial proximity boost, and popularity signals. Not bounded to 0-1.
source: optional "structured" or "bm25" or "fuzzy" or 3 moreResult source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)
Result source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)
GeocodingFeature = object { geometry, properties, type } GeoJSON Feature representing a geocoding result. The geometry is always a Point. Properties include the formatted display name, OSM metadata, confidence score, and source type.
GeoJSON Feature representing a geocoding result. The geometry is always a Point. Properties include the formatted display name, OSM metadata, confidence score, and source type.
GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.
GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.
coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of numberCoordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.
Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.
properties: object { display_name, category, city, 18 more } Geocoding result properties
Geocoding result properties
Interpolation confidence (0-1). Present only for interpolated results.
Complete formatted address from the database. Present for reverse geocode address results.
House or building number. Present for address and interpolated results.
Whether this result was estimated by address interpolation rather than an exact database match.
Relevance score (higher is better). Incorporates text match quality, spatial proximity boost, and popularity signals. Not bounded to 0-1.
source: optional "structured" or "bm25" or "fuzzy" or 3 moreResult source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)
Result source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)
ReverseGeocodeResult = object { features, type } GeoJSON FeatureCollection of reverse geocoding results, ordered by distance from the query point. Content-Type: application/geo+json.
GeoJSON FeatureCollection of reverse geocoding results, ordered by distance from the query point. Content-Type: application/geo+json.
Reverse geocoding results ordered by distance
Reverse geocoding results ordered by distance
GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.
GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints.
coordinates: array of number or array of array of number or array of array of array of number or array of array of array of array of numberCoordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.
Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc.
properties: object { display_name, category, city, 18 more } Geocoding result properties
Geocoding result properties
Interpolation confidence (0-1). Present only for interpolated results.
Complete formatted address from the database. Present for reverse geocode address results.
House or building number. Present for address and interpolated results.
Whether this result was estimated by address interpolation rather than an exact database match.
Relevance score (higher is better). Incorporates text match quality, spatial proximity boost, and popularity signals. Not bounded to 0-1.
source: optional "structured" or "bm25" or "fuzzy" or 3 moreResult source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)
Result source indicating how the result was found: structured (exact field match), bm25 (full-text search), fuzzy (trigram similarity), address (reverse geocode address), place (reverse geocode POI), interpolation (estimated from neighboring addresses)