Geometry Utilities API

Toolkit

Distance, bearing, area, centroid, simplification and polyline encode/decode — spatial math as a service.

Overview

The Geometry Utilities API is spatial math as a service: distance and bearing between points, a destination from a bearing and distance, midpoints, path length, polygon area, centroids, Douglas–Peucker simplification and Google polyline encode/decode. One endpoint, pick the operation with the op field. Pure computation, works worldwide.

API reference

POST/api/1/geometry

Parameter	Type	Status	Description
op	string	Required	Operation: distance, bearing, destination, midpoint, length, area, centroid, simplify, polyline_encode or polyline_decode.
from	array	Optional	Start point [lat,lng] (for distance/bearing/destination/midpoint).
to	array	Optional	End point [lat,lng] (for distance/bearing/midpoint).
path	array	Optional	Array of [lat,lng] (for length/simplify/polyline_encode).
polygon	array	Optional	Array of [lat,lng] ring (for area).

Example request

Credit cost: 1 credit

curl -X POST "https://osrmroute.com/api/1/geometry?key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"distance","from":[40.37,49.85],"to":[40.40,49.86]}'

Geometry Utilities API

Overview

API reference

Example request

Other services