Skip to main content

​
Natural Language Endpoints

The natural language endpoints accept unstructured input and return structured geospatial results. Send plain text or messy address data, get back clean coordinates, routes, and corrected addresses.

​
Endpoints

EndpointDescription
POST /v1/ai/queryNatural language to structured geospatial results. Send text like “Walking route from Kings Cross to Tower Bridge” and get back a route.
POST /v1/ai/parse-addressCorrect, standardize, and structure messy addresses. Fixes typos, expands abbreviations, infers missing fields.

​
Route narratives

The standard route and optimise endpoints also support natural language summaries. Pass narrative: true to get a human-readable description of the route: 
{
  "locations": [...],
  "narrative": true
}
The response includes a narrative field: 
{
  "route": {
    "distance_meters": 5765,
    "duration_seconds": 812,
    "narrative": "A 5.8km drive south through central London, about 14 minutes. Mostly flat with 12m total ascent. No tolls or motorways.",
    "terrain": { ... }
  }
}

​
Authentication

All endpoints require an API key via the x-api-key header. See the authentication guide for details.