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

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

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"
}

    