GuidesAPI Reference
Guides

How to convert coordinates to a what3words address

This function converts a latitude and longitude to a 3 word address, in the language of your choice. It also returns country, the bounds of the grid square and a nearby place (such as a local town).

curl --request GET --url 'https://what3words.search.hereapi.com/v3/convert-to-3wa?coordinates=51.44401%2C5.48052&apiKey=[YOUR-API-KEY]&language=en&format=json

Resource URL

https://what3words.search.hereapi.com/v3/convert-to-3wa

Parameters

ParameterRequired/optionalDescriptionExample
coordinatesrequiredCoordinates as a comma separated string of latitude and longitudecoordinates=51.432393,-0.348023
languageoptionalA supported 3 word address language as an ISO 639-1 2 letter code. Defaults to en (english). For a full list of 3 word address languages, see available-languages.language=fr
formatoptionalReturn data format type; can be either json (the default) or geojsonformat=geojson
localeoptionalLocale to specify a variant of a language (see here more details)locale=mn_la

Example request

GET https://what3words.search.hereapi.com/v3/convert-to-3wa?coordinates=51.44401%2C5.48052&apiKey=[YOUR-API-KEY]&language=en&format=json

Example result

{
  "country": "NL",
  "square": {
      "southwest": {
          "lng": 5.480486,
          "lat": 51.443995
      },
      "northeast": {
          "lng": 5.48053,
          "lat": 51.444022
      }
  },
  "nearestPlace": "Eindhoven, North Brabant",
  "coordinates": {
      "lng": 5.480508,
      "lat": 51.444009
  },
  "words": "browser.knitted.elaborate",
  "language": "en",
  "locale": null,
  "map": "https://w3w.co/browser.knitted.elaborate"
}