Reverse Geocoding

Find the nearest address to a latitude, longitude coordinate with Swiftcomplete's Reverse Geocoding API

Get startedRead more

Try it now

Countries

    What is reverse geocoding?

    Reverse geocoding is the process of turning coordinates into a readable address, street or place. For example, "51.499403,-0.127362" becomes "Westminster Abbey, London, SW1P 3PA, United Kingdom".

    Using the Swiftcomplete Reverse Geocoding API, you can convert a latitude, longitude into an accurate postal address, or generate a list of the closest addresses or places to a GPS coordinate.

    How it works

    Swiftcomplete's reverse geocoder works by searching for the closest matches to your provided coordinates. This is either calculated by straight-line distance, or by checking whether the coordinates are situated within a polygon (e.g. a country).

    Depending on your use-case, reverse geocoding can operate at different levels of resolution or accuracy:

    Address level


    Exact address

    Exact address level reverse geocoding
    • Coordinates for each individual property
    • Best possible data accuracy
    • Returns nearest postal address to your coordinates

    Address range

    Address range reverse geocoding
    • Range of house numbers on a street
    • Finds approximate house number
    • Works best where houses are spaced evenly on the street

    Street level


    Street

    Street level reverse geocoding
    • Finds the closest street to your coordinates
    • More accurate in countries where street polylines are available rather than centre-point coordinates

    Place level


    Place

    City & town reverse geocoding
    • Nearest city, town, village or suburb
    • Measured by distance to the centre-point of the locality

    Postcode

    Postcode & ZIP code reverse geocoding
    • Closest postal code or ZIP code
    • Measured by distance to the centre-point of the postcode

    Region level


    Region

    State, county & admin area reverse geocoding
    • Nearest state, county or admin area
    • More accurate in countries where polygons are available rather than centre-point coordinates

    Country

    Country reverse geocoding
    • Nearest country
    • More accurate where polygons are available rather than centre-point coordinates

    Data availability varies by region. Less granular datasets (such as region level or place level) are more cost effective, whereas high-resolution address level datasets provide the best possible accuracy.

    If you need help choosing the best data for your project, contact us and we will be happy to help.

    Get started

    Make your first reverse geocoding request in under 2 minutes

    1. Create an account

    2. Generate a reverse geocoding API key

    3. Make your first API request

    Integrate Swiftcomplete Reverse Geocoding

    Swiftcomplete's reverse geocoding is available through a simple API, or via a npm package:

    @swiftcomplete/reverse-geocode


    Installation

    npm install @swiftcomplete/reverse-geocode

    Making a request

    const swiftcompleteReverseGeocoder = require('@swiftcomplete/reverse-geocode');
    
    swiftcompleteReverseGeocoder.setAPIKey('INSERT-KEY-HERE');
    
    swiftcompleteReverseGeocoder.reverseGeocode('51.499403,-0.127362').then(function(results) {
        console.log(results);
    });

    Response

    [
      {
        "primary":{
          "text":"Westminster Abbey",
          "highlights":[]
        },
        "secondary":{
          "text":"London",
          "highlights":[]
        },
        "type":"address.residential.building.data.emptyroad",
        "isContainer":false,
        "geometry":{
          "centre":{
            "lat":51.499462,
            "lon":-0.127448,
            "type":"address"
          }
        },
        "distance":{
          "units":"m",
          "measurement":9,
          "type":"biasTowards",
          "geometry":{
            "centre":{
              "lat":51.499403,
              "lon":-0.127362
            }
          }
        },
        "populatedRecord":{
          "lines":[
            "Westminster Abbey",
            "",
            "London",
            "SW1P 3PA",
            "United Kingdom"
          ],
          "label":"Westminster Abbey\nLondon\nSW1P 3PA\nUnited Kingdom"
        }
      }
    ]

    Data coverage

    At the moment, our reverse geocoding is available in the following countries:

      We regularly expand and improve our data coverage.

      Do you have a requirement for a particular country or dataset? Get in touch and we'll let you know where it is on our priority list.

      Pricing

      Our pay-as-you-go pricing is a quick and easy way to get started - simply pay between 4.8p & 6p per address returned (+VAT), with cheaper lookups for higher usage.

      We also offer growth & enterprise plans for high-volume usage - get in touch and we'll be happy to help.


      Pay-as-you-go credit packs are valid for 12 months, all prices exclude VAT.

      £25 - 416 addresses

      6p / address

      £50 - 862 addresses

      5.8p / address

      £100 - 1818 addresses

      5.5p / address

      £225 - 4326 addresses

      5.2p / address

      £400 - 8000 addresses

      5p / address

      £900 - 18750 addresses

      4.8p / address