Source: https://developers.woosmap.com/api-reference/what3words-api/get-what3words-convert-to-3wa/

> For clean Markdown of any page, append `.md` to the page URL.

> For a complete documentation index, see https://developers.woosmap.com/llms.txt

# Convert To What 3 Words



# 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`](#authorization-external-api-wrapper-what3words-publicapikey)
apiKeyquery

Public key of the project usually starts with `woos-`

[`private_key`](#authorization-external-api-wrapper-what3words-privateapikey)
apiKeyquery

Private key with or without write permission.

[`X-Api-Key`](#authorization-external-api-wrapper-what3words-privateapikeyheader)
apiKeyheader

Private key with or without write permission.

### Query Parameters

[`coordinates`](#query-coordinates)
stringrequired

Coordinates as a comma separated string of latitude and longitude

Example:`48.858304,2.294514`

[`format`](#query-format)
stringDefaults to `json`

Return data format type; can be either json or geojson

Available options:`json`, `geojson`

[`language`](#query-language)
stringDefaults to `en`

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

### Response

200application/json

Successful Response

Any ofJsonCoordinatesResponseGeoJsonCoordinatesResponse

[`country`](#resp-200-variant1--country)
stringrequired

Country Code

[`nearestPlace`](#resp-200-variant1--nearestplace)
stringrequired

Nearest Place

[`words`](#resp-200-variant1--words)
stringrequired

The what3words address

[`language`](#resp-200-variant1--language)
stringrequired

Language Code

[`locale`](#resp-200-variant1--locale)
string

Language Locale

[`map`](#resp-200-variant1--map)
stringrequired

Link to what3words address on a map

[`square`](#resp-200-variant1--square)
objectrequired

Lat Lng coordinate Square

#Show 2 propertiesHide 2 properties

square.[`southwest`](#resp-200-variant1--square-southwest)
objectrequired

Lat Lng coordinate

Show 2 propertiesHide 2 properties

square.southwest.[`lng`](#resp-200-variant1--square-southwest-lng)
numberrequired

Longitude

square.southwest.[`lat`](#resp-200-variant1--square-southwest-lat)
numberrequired

Latitude

square.[`northeast`](#resp-200-variant1--square-northeast)
objectrequired

Lat Lng coordinate

Show 2 propertiesHide 2 properties

square.northeast.[`lng`](#resp-200-variant1--square-northeast-lng)
numberrequired

Longitude

square.northeast.[`lat`](#resp-200-variant1--square-northeast-lat)
numberrequired

Latitude

[`coordinates`](#resp-200-variant1--coordinates)
objectrequired

Lat Lng coordinate

#Show 2 propertiesHide 2 properties

coordinates.[`lng`](#resp-200-variant1--coordinates-lng)
numberrequired

Longitude

coordinates.[`lat`](#resp-200-variant1--coordinates-lat)
numberrequired

Latitude

[`features`](#resp-200-variant2--features)
object[]required

GeoJSON Features

#Show 4 propertiesHide 4 properties

features.[`bbox`](#resp-200-variant2--features-bbox)
number[]required

Bounding Box

features.[`geometry`](#resp-200-variant2--features-geometry)
objectrequired

Geometry

features.[`type`](#resp-200-variant2--features-type)
stringrequired

GeoJSON type

features.[`properties`](#resp-200-variant2--features-properties)
objectrequired

Feature Properties

Show 6 propertiesHide 6 properties

features.properties.[`country`](#resp-200-variant2--features-properties-country)
stringrequired

Country Code

features.properties.[`nearestPlace`](#resp-200-variant2--features-properties-nearestplace)
stringrequired

Nearest Place

features.properties.[`words`](#resp-200-variant2--features-properties-words)
stringrequired

The what3words address

features.properties.[`language`](#resp-200-variant2--features-properties-language)
stringrequired

Language Code

features.properties.[`locale`](#resp-200-variant2--features-properties-locale)
string

Language Locale

features.properties.[`map`](#resp-200-variant2--features-properties-map)
stringrequired

Link to what3words address on a map

[`type`](#resp-200-variant2--type)
stringrequired

GeoJSON Type

### Errors

#401

Unable to locate credentials.

 

`application/json`

[`detail`](#err-401-detail)
stringrequired

#402

Out of free quota.

 

`application/json`

[`detail`](#err-402-detail)
stringrequired

#403

Credentials found, but not matching.

 

`application/json`

[`detail`](#err-403-detail)
stringrequired

#422

Validation Error

 

`application/json`

[`detail`](#err-422-detail)
object[]

Show 3 propertiesHide 3 properties

detail.[`loc`](#err-422-detail-loc)
any[]required

detail.[`msg`](#err-422-detail-msg)
stringrequired

detail.[`type`](#err-422-detail-type)
stringrequired

#429

Rate limit reached

 

`application/json`

[`details`](#err-429-details)
stringrequired

```shell
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'
```

```python
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)
```

```javascript
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));
```

```json
{
  "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"
}
```