Geocoding

Turn your coordinates into addresses or your addresses into coordinates. Our geocoding API offers worldwide forward and reverse permanent geocoding. Run batch queries, store the results, and use them on a Mapbox map or anywhere you want.

Features
Data
Coverage
For developers
Pricing
Get started

We offer two geocoder options: free and enterprise. Use our free geocoder with any Mapbox plan as long as the results are displayed on a Mapbox map. Need more flexibility? Our enterprise geocoder supports higher rates and allows you to store results forever as part of your own private database.

Features

Autocomplete: Returns possible matches as you type.

Proximity bias: When enabled, results nearby are prioritized, making autocomplete more accurate.

Batch geocoding: Query up to 50 locations per request.

High performance: The free API supports 600 requests per minute. Enterprise throughput starts at 1,200 reqs/min, and scales to 30,000+.

Store results: Enterprise customers can retain results forever.

Filter by type: Filter results to include only countries, POIs, places, and more.

Excellent data

Global places

Worldwide coverage of cities and towns.
Address-level results

Precise results for individual addresses in 12 countries.
POIs

Support for business names, landmarks, and other points of interest.

Data from industry leaders

Including global suppliers and national authorities.
Open data

When new data is released, our customers get it in days, not weeks.

Coverage

We have precise, address-level geocoding around the globe.

Map Table

Country	Region	Place	Postcode	Address*	POI
`at`Austria
`au`Australia
`be`Belgium
`br`Brazil
`ca`Canada
`ch`Switzerland
`cl`Chile
`cn`China
`de`Germany
`dk`Denmark
`es`Spain
`fi`Finland
`fr`France
`gb`Great Britain
`hk`Hong Kong
`ie`Ireland
`in`India
`it`Italy
`kr`South Korea
`mx`Mexico
`nl`Netherlands
`no`Norway
`nz`New Zealand
`pe`Peru
`se`Sweden
`sg`Singapore
`us`United States

* Addresses Street names

Additional place coverage: Andorra, United Arab Emirates, Albania, Angola, Argentina, Bosnia and Herzegovina, Bulgaria, Bahrain, Brunei, Botswana, Belarus, Colombia, Cuba, Cyprus, Czech Republic, Algeria, Estonia, Egypt, French Guiana, Greenland, Guadeloupe, Greece, Croatia, Hungary, Indonesia, Iceland, Jordan, Japan, Kenya, Kuwait, Lebanon, Lithuania, Luxembourg, Latvia, Morocco, Moldova, Montenegro, Macedonia, Malta, Malaysia, Philippines, Poland, Portugal, Romania, Serbia, Russia, Slovenia, Slovakia, San Marino, Thailand, Turkey, Taiwan, Ukraine, Uruguay, Venezuela, Vietnam, South Africa

Additional neighborhood coverage: Canada, United States

Additional district coverage: China, United States

Additional locality coverage: Australia, New Zealand

Read our Terms of Service for details on using results from the Geocoding API

{
  "type": "FeatureCollection",
  "query": [
    "1600",
    "pennsylvania",
    "ave",
    "washington",
    "dc"
  ],
  "features": [
    {
      "id": "address.170282823806239",
      "type": "Feature",
      "text": "Pennsylvania Ave NW",
      "place_name": "1600 Pennsylvania Ave NW, Washington, 20006, District of Columbia, United States",
      "relevance": 0.8789999999999999,
      "center": [
        -77.036698,
        38.897102
      ],
      "geometry": {
        "type": "Point",
        "coordinates": [
          -77.036698,
          38.897102
        ]
      },
      "bbox": [
        -77.05781199999998,
        38.89252299999999,
        -77.01844799999999,
        38.905058999999994
      ],
      "address": "1600",
      "properties": {},
      "context": [
        {
          "id": "place.10719",
          "text": "Washington"
        },
        {
          "id": "postcode.757789931",
          "text": "20006"
        },
        {
          "id": "region.1190806886",
          "text": "District of Columbia"
        },
        {
          "id": "country.4150104525",
          "text": "United States"
        }
      ]
    },
    {
      "id": "address.224758605991745",
      "type": "Feature",
      "text": "Pennsylvania Ave SE",
      "place_name": "1600 Pennsylvania Ave SE, Washington, 20003, District of Columbia, United States",
      "relevance": 0.8789999999999999,
      "center": [
        -76.982024,
        38.878977
      ],
      "geometry": {
        "type": "Point",
        "coordinates": [
          -76.982024,
          38.878977
        ],
        "interpolated": true
      },
      "bbox": [
        -77.00351899999997,
        38.87312999999999,
        -76.96982099999997,
        38.88761399999998
      ],
      "address": "1600",
      "properties": {},
      "context": [
        {
          "id": "place.10719",
          "text": "Washington"
        },
        {
          "id": "postcode.363597332",
          "text": "20003"
        },
        {
          "id": "region.1190806886",
          "text": "District of Columbia"
        },
        {
          "id": "country.4150104525",
          "text": "United States"
        }
      ]
    },
    {
      "id": "address.69793638887692",
      "type": "Feature",
      "text": "Pennsylvania Ave",
      "place_name": "1600 Pennsylvania Ave, Bremerton, 98337, Washington, United States",
      "relevance": 0.798,
      "center": [
        -122.642074,
        47.575456
      ],
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.642074,
          47.575456
        ],
        "interpolated": true
      },
      "bbox": [
        -122.64210499999997,
        47.56737199999999,
        -122.64204299999996,
        47.577860999999984
      ],
      "address": "1600",
      "properties": {},
      "context": [
        {
          "id": "place.32283",
          "text": "Bremerton"
        },
        {
          "id": "postcode.3839047076",
          "text": "98337"
        },
        {
          "id": "region.429316995",
          "text": "Washington"
        },
        {
          "id": "country.4150104525",
          "text": "United States"
        }
      ]
    },
    {
      "id": "address.42492466560022",
      "type": "Feature",
      "text": "Pennsylvania Ave",
      "place_name": "1600 Pennsylvania Ave, Baltimore, 21217, Maryland, United States",
      "relevance": 0.59,
      "center": [
        -76.634388,
        39.30307
      ],
      "geometry": {
        "type": "Point",
        "coordinates": [
          -76.634388,
          39.30307
        ]
      },
      "bbox": [
        -76.64626799999999,
        39.295034999999984,
        -76.62387699999998,
        39.313258999999995
      ],
      "address": "1600",
      "properties": {},
      "context": [
        {
          "id": "place.10950",
          "text": "Baltimore"
        },
        {
          "id": "postcode.1084729612",
          "text": "21217"
        },
        {
          "id": "region.928365533",
          "text": "Maryland"
        },
        {
          "id": "country.4150104525",
          "text": "United States"
        }
      ]
    },
    {
      "id": "address.207113032549700",
      "type": "Feature",
      "text": "Pennsylvania Ave",
      "place_name": "1600 Pennsylvania Ave, Oreland, 19075, Pennsylvania, United States",
      "relevance": 0.59,
      "center": [
        -75.18526,
        40.120893
      ],
      "geometry": {
        "type": "Point",
        "coordinates": [
          -75.18526,
          40.120893
        ],
        "interpolated": true
      },
      "bbox": [
        -75.20100999999995,
        40.11483199999998,
        -75.17525899999997,
        40.12710399999999
      ],
      "address": "1600",
      "properties": {},
      "context": [
        {
          "id": "place.10547",
          "text": "Oreland"
        },
        {
          "id": "postcode.3010350676",
          "text": "19075"
        },
        {
          "id": "region.2184819983",
          "text": "Pennsylvania"
        },
        {
          "id": "country.4150104525",
          "text": "United States"
        }
      ]
    }
  ],
  "attribution": "NOTICE: © Mapbox and its suppliers. All rights reserved. Use of this data is subject to the Mapbox Terms of Service (https://www.mapbox.com/about/maps/). This response and the information it contains may not be retained."
}

Designed for developers

Our geocoding API has client libraries for:

The API is simple to authenticate and results are returned in GeoJSON format.

Pricing

Free geocoding

Display results on any Mapbox map

Make up to 600 requests per minute

Cache results in your app

Enterprise geocoding

Display and use results anywhere

Increased rate limits, from 2,400 requests per minute to 30,000 requests per minute

Option to store results permanently

Our products

Our platform

Industries

Examples

All developer tools

References

Help

I would like to

Geocoding

Features

Excellent data

Global places

Address-level results

POIs

Data from industry leaders

Open data

Coverage

Designed for developers

Pricing

Free geocoding

Enterprise geocoding

Start using Mapbox now

Create an account or hit us up!

Overview

About us

Help

Map design

Developers

Industries

Our platform

Examples

References

I would like to

Geocoding

Global places

Address-level results

POIs

Data from industry leaders

Open data

Free geocoding

Enterprise geocoding

Start using Mapbox now

Create an account or hit us up!

Overview

About us

Help

Map design

Developers

Industries

Sign up for our newsletter