Reverse Geocoding API

Request

Naurt data can be reverse-searched via a POST request to the final-destination endpoint. Again, data should be provided as a JSON in the body of the request and not in the URL.

JSON

POST  https://api.naurt.net/final-destination/v1
Content-Type: application/json
Authorization: <API_KEY_HERE>
{
    "latitude": Option<Float>,
    "longitude": Option<Float>,
    "country": Option<String>,
    "distance_filter": Option<Float>,
    "additional_matches": Option<Bool>,
}

Parameters

Parameter	Type	Optional	Default	Description
latitude	float	Yes	None	A valid latitude in WGS84 degrees. Range: -90 <= lat <= 90.
longitude	float	Yes	None	A valid longitude in WGS84 degrees. Range: -180 <= lon < 180.
distance_filter	float	Yes	5000	A distance in metres (larger than 0) within which you wish to search for POIs. When a filter is applied a latitude and longitude must also be provided. Maximum value of 25000 metres
additional_matches	Boolean	Yes	False	Provides up to 4 results beyond what Naurt classifies as the `best_match`.
country	String	Yes	None	Optional but strongly suggested two digit country code which helps with performance.

Currently supported country tags are

AE: UAE (Preview)
AT: Austria
AU: Australia
BE: Belgium (BETA)
BR: Brazil (BETA)
CA: Canada
CH: Switzerland (BETA)
CZ: Czechia (BETA)
DE: Germany
DK: Denmark
EG: Egypt (Preview)
ES: Spain
FI: Finland
FR: France (Please note that Naurt currently only covers Metropolitan France)
GB: United Kingdom
- UK: United Kingdom (alternative ISO Country code)
GG: Guernsey (British Crown Dependency)
HK: Hong Kong (Preview)
IE: Ireland
IM: Isle of Man (British Crown Dependency)
IT: Italy
JE: Jersey (British Crown Dependency)
JP: Japan (Preview)
KR: South Korea (Preview)
LU: Luxemboug (BETA)
NL: Netherlands
NO: Norway
NZ: New Zealand
PL: Poland (BETA)
PT: Portugal
TW: Taiwan (Preview)
US: United States
SA: Saudi Arabia (Preview)
SE: Sweden
SG: Singapore
SI: Slovenia (BETA)

Example

CURL

curl -XPOST \
-H "Content-type: application/json" \
-H "Authorization: <API_KEY_HERE>"  \
-d '{"latitude": 52.0, "longitude": 0.0, "country": "UK"}' \
'https://api.naurt.net/final-destination/v1'

Response

Success

A 200 response code indicates a successful response with the format as follows.

JSON

{
    "best_match": Optional<Object<HitData>>,
    "additional_matches": Optional<List<Object<HitData>>>,
    "version": Optional<String>
}

Naurt's best match will be the closest destination to the requested location. You will only have an additional_matches field if you set additional_matches to true in the request.

The HitData format is

JSON

{
    "id": String,
    "address": String,
    "geojson": Object<GeoJSON>,
    "distance": Option<Float>
}

Distance will only be present if you search with a latitude and longitude and will be the distance of the destination from that position in metres.

For GeoJSON please see the spec.

Failure

A response code other than 200 indicates a failure to retrieve the requested destination. Please see this page for more information on error codes.

If there are no destinations available which match the search term, the response JSON will not contain any results, but instead a "naurt_info" message.

JSON

{"naurt_info":"Successful request. No destinations match search conditions."}

Search Restrictions

Destinations requested via the API are subject to some restrictions.

No more than 300 requests per minute can be sent to this endpoint per API key. This limit can be adjusted by speaking to our support team.
Currently there is a maximum return of 5 destinations per request.

Full Examples

POST  https://api.naurt.net/final-destination/v1
Content-Type: application/json
Authorization: <API_KEY_HERE>
{
    "latitude": 50.835551,
    "longitude": -0.127613,
    "country": "UK"
}

{
    "best_match": {
        "address": "The Martha Gunn, 100, Upper Lewes Road, Brighton, East Sussex, England, United Kingdom, BN2 3FE",
        "distance": 5.26,
        "geojson": {
        "features": [
            {
            "geometry": {
                "coordinates": [
                [
                    -0.127653,
                    50.835511
                ]
                ],
                "type": "MultiPoint"
            },
            "properties": {
                "accuracy": {
                    "quality": "high"
                },
               "naurt_type": "naurt_door"
            },
            "type": "Feature"
            },
            {
            "geometry": {
                "coordinates": [
                [
                    [
                    -0.127597,
                    50.835464
                    ],
                    [
                    -0.12773,
                    50.8354
                    ],
                    [
                    -0.127757,
                    50.835423
                    ],
                    [
                    -0.127775,
                    50.835415
                    ],
                    [
                    -0.12786,
                    50.835484
                    ],
                    [
                    -0.127709,
                    50.835556
                    ],
                    [
                    -0.127597,
                    50.835464
                    ]
                ]
                ],
                "type": "Polygon"
            },
            "properties": {
                "naurt_type": "naurt_building",
                "contributors": [
                     "© OpenStreetMap contributors"
                ]
            },
            "type": "Feature"
            },
            {
            "geometry": {
                "coordinates": [
                [
                    [
                    -0.12752,
                    50.83547
                    ],
                    [
                    -0.127566,
                    50.835447
                    ],
                    [
                    -0.127697,
                    50.835555
                    ],
                    [
                    -0.127652,
                    50.835577
                    ],
                    [
                    -0.12752,
                    50.83547
                    ]
                ]
                ],
                "type": "Polygon"
            },
            "properties": {
                "accuracy": {
                    "quality": "high"
                },
               "naurt_type": "naurt_parking"
            },
            "type": "Feature"
            }
        ],
        "type": "FeatureCollection"
        },
        "id": "3b32df10-4fd2-cc33-a3c6-3e4bd657e8ec"
    },
    "version": "1.3.0",
    "request_id": "47cdd308-39c8-4ff4-a982-8f6782ca51ab"
}

To limit the search to a specific radius, you can apply a distance_filter up to a maximum of 25000m. If unused, it defaults to 5000m.

POST  https://api.naurt.net/final-destination/v1
Content-Type: application/json
Authorization: <API_KEY_HERE>
{
  "latitude": 51.0,
  "longitude": 0.0,
  "distance_filter": 1000.0,
  "country": "UK"
}

{
    "best_match": {
        "address": "Bolton Buildings Ltd, Unit 5, Bluebell Business Estate, Sheffield Park, Uckfield, East Sussex, England, United Kingdom, TN22 3HQ",
        "distance": 431.03,
        "geojson": {
        "features": [
            {
            "geometry": {
                "coordinates": [
                [
                    -0.002799,
                    50.996547
                ]
                ],
                "type": "MultiPoint"
            },
            "properties": {
                "accuracy": {
                    "quality": "high"
                },
               "naurt_type": "naurt_door"
            },
            "type": "Feature"
            },
            {
            "geometry": {
                "coordinates": [
                [
                    [
                    -0.00289,
                    50.996513
                    ],
                    [
                    -0.003138,
                    50.996788
                    ],
                    [
                    -0.002915,
                    50.996868
                    ],
                    [
                    -0.002857,
                    50.996803
                    ],
                    [
                    -0.002759,
                    50.996841
                    ],
                    [
                    -0.002568,
                    50.996632
                    ],
                    [
                    -0.00289,
                    50.996513
                    ]
                ]
                ],
                "type": "Polygon"
            },
            "properties": {
                "naurt_type": "naurt_building",
                "contributors": [
                     "© OpenStreetMap contributors"
                ]
            },
            "type": "Feature"
            },
            {
            "geometry": {
                "coordinates": [
                [
                    [
                    -0.002698,
                    50.996516
                    ],
                    [
                    -0.002667,
                    50.996485
                    ],
                    [
                    -0.002849,
                    50.996412
                    ],
                    [
                    -0.00288,
                    50.996443
                    ],
                    [
                    -0.002698,
                    50.996516
                    ]
                ]
                ],
                "type": "Polygon"
            },
            "properties": {
                "accuracy": {
                    "quality": "high"
                },
               "naurt_type": "naurt_parking"
            },
            "type": "Feature"
            }
        ],
        "type": "FeatureCollection"
        },
        "id": "f3d2bf89-af4d-2d45-425b-b49dafc57b89"
    },
    "version": "1.3.0",
    "request_id": "47cdd308-39c8-4ff4-a982-8f6782ca51ab"
}

Final DestinationStructured Request - Beta

Final DestinationSearch by ID