How to convert a what3words address to coordinates

This function converts a 3 word address to a latitude and longitude. It also returns country, the bounds of the grid square, a nearest place (such as a local town) and a link to our map site.

curl --request GET --url 'https://what3words.search.hereapi.com/v3/convert-to-coordinates?words=browser.knitted.elaborate&apiKey=[YOUR-API-KEY]&format=json

Resource URL

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

Parameters

Parameter	Required/optional	Description	Example
`key`	required	A valid API key; if not supplied as a parameter, a key must be supplied as a request header	`key=[API-KEY]`
`words`	required	A 3 word address as a string. It must be three words separated with dots or a japanese middle dot character (・). Words separated by spaces will be rejected. Optionally, the 3 word address can be prefixed with /// (which would be encoded as %2F%2F%2F)	`words=index.home.raft` or `words=///browser.knitted.elaborate`
`format`	optional	Return data format type; can be either `json` (the default) or `geojson`	`format=geojson`
`locale`	optional	Locale 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-coordinates?words=browser.knitted.elaborate&apiKey=[API-KEY]&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"
}