GETAPI key

Position from a share link

GETroad.navo24.com/v1/road/parse-link

Coordinates from a Google Maps, Apple Maps, OpenStreetMap or geo: link, as sent by drivers and telematics portals.

Query parameters

urlstringrequired

The shared link.

Response schema

3 fields

Derived from the example response, nested as the JSON is.

dataobject

The payload. Everything an endpoint returns sits under this key.

latnumber

Latitude.

lngnumber

Longitude.

Errors

A failure carries { "ok": false, "error": { "code", "message", "severity" } }. Branch on the code, and log the message.

missing_key401

No key in Authorization or x-api-key.

invalid_key401

The key is unknown or revoked.

no_position422

No coordinates in the link.

rate_limited429

More than 40 requests in one minute from one client.

upstream_error502

A source did not answer. Retry in a minute.

curl 'https://road.navo24.com/v1/road/parse-link?url=https%3A%2F%2Fmaps.google.com%2F%3Fq%3D52.1%2C19.4' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"

const res = await fetch("https://road.navo24.com/v1/road/parse-link?url=https%3A%2F%2Fmaps.google.com%2F%3Fq%3D52.1%2C19.4", {
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY"
  }
});
const data = await res.json();

import requests

res = requests.get(
    "https://road.navo24.com/v1/road/parse-link?url=https%3A%2F%2Fmaps.google.com%2F%3Fq%3D52.1%2C19.4",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
)
data = res.json()

Response

{
  "data": {
    "lat": 52.1,
    "lng": 19.4
  }
}