Convert To What 3 Words

GET

https://api.woosmap.com/what3words/convert-to-3wa

This function will convert 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, a nearby place (such as a local town) and a link to the what3words map site.

Rate limit: 20/1s

Ratelimit: 20/1s

Authorization

key

apiKey query

Public key of the project usually starts with woos-

private_key

apiKey query

Private key with or without write permission.

X-Api-Key

apiKey header

Private key with or without write permission.

Query Parameters

coordinates

string required

Coordinates as a comma separated string of latitude and longitude

Example: 48.858304,2.294514

format

string Defaults to json

Return data format type; can be either json or geojson

Available options: json, geojson

language

string Defaults to en

A supported address language as an ISO 639-1 2 letter code.

Response

200 application/json

Successful Response

Any of

country

string required

Country Code

nearestPlace

string required

Nearest Place

words

string required

The what3words address

language

string required

Language Code

locale

string | null

Language Locale

map

string required

Link to what3words address on a map

square

object required

Lat Lng coordinate Square

Show 2 propertiesHide 2 properties

square. southwest

object required

Lat Lng coordinate

Show 2 propertiesHide 2 properties

square.southwest. lng

number required

Longitude

square.southwest. lat

number required

Latitude

square. northeast

object required

Lat Lng coordinate

Show 2 propertiesHide 2 properties

square.northeast. lng

number required

Longitude

square.northeast. lat

number required

Latitude

coordinates

object required

Lat Lng coordinate

Show 2 propertiesHide 2 properties

coordinates. lng

number required

Longitude

coordinates. lat

number required

Latitude

features

object[] required

GeoJSON Features

Show 4 propertiesHide 4 properties

features. bbox

number[] required

Bounding Box

features. geometry

object required

Geometry

features. type

string required

GeoJSON type

features. properties

object required

Feature Properties

Show 6 propertiesHide 6 properties

features.properties. country

string required

Country Code

features.properties. nearestPlace

string required

Nearest Place

features.properties. words

string required

The what3words address

features.properties. language

string required

Language Code

features.properties. locale

string | null

Language Locale

features.properties. map

string required

Link to what3words address on a map

type

string required

GeoJSON Type

Errors

401

Unable to locate credentials.

application/json

detail

string required

402

Out of free quota.

application/json

detail

string required

403

Credentials found, but not matching.

application/json

detail

string required

422

Validation Error

application/json

detail

object[]

Show 3 propertiesHide 3 properties

detail. loc

any[] required

detail. msg

string required

detail. type

string required

429

Rate limit reached

application/json

details

string required

            curl -L -X GET 'https://api.woosmap.com/what3words/convert-to-3wa?coordinates=48.858304,2.294514&key=YOUR_PUBLIC_API_KEY' \
-H 'Referer: http://localhost'

            import requests

url = "https://api.woosmap.com/what3words/convert-to-3wa?coordinates=48.858304,2.294514&key=YOUR_PUBLIC_API_KEY"

payload={}
headers = {
    'Referer': 'http://localhost'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

            var requestOptions = {
  method: 'GET',
  redirect: 'follow'
};

fetch("https://api.woosmap.com/what3words/convert-to-3wa?coordinates=48.858304,2.294514&key=YOUR_PUBLIC_API_KEY", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

            {
  "coordinates": {
    "lat": 48.858304,
    "lng": 2.294514
  },
  "country": "FR",
  "language": "en",
  "map": "https://w3w.co/couch.spotted.amended",
  "nearestPlace": "Paris",
  "square": {
    "northeast": {
      "lat": 48.858317,
      "lng": 2.294535
    },
    "southwest": {
      "lat": 48.85829,
      "lng": 2.294494
    }
  },
  "words": "couch.spotted.amended"
}

    