routing/car

Get high-performance car routing providing fast route calculations

Previousdistance/point Nextrouting/maritime

Last updated 1 month ago

Get car routing information

post

Get high-performance car route calculations

Authorizations

Query parameters

alternativesbooleanOptional

Search for alternative routes and return as well.

Default: false

geometriesstring · enumOptional

Returned route geometry format (influences overview and per step)

Default: polylinePossible values:

overviewstring · enumOptional

Add overview geometry either full, simplified according to highest zoom level it could be display on, or not at all

Default: simplifiedPossible values:

stepsbooleanOptional

Return route steps for each route leg

Default: false

Body

Responses

200

application/json

Responseall of

400

Bad Request - Invalid request

404

Not Found - Valid request but location not found

post

POST /api/v2/route/car HTTP/1.1
Host: api.distance.tools
X-Billing-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "route": [
    {
      "lat": 1,
      "lng": 1
    }
  ]
}

{
  "code": "Ok",
  "message": "text",
  "data_version": "2025-06-04T04:04:51.703Z",
  "waypoints": [
    {
      "name": "text",
      "location": [
        1
      ],
      "distance": 1,
      "hint": "text"
    }
  ],
  "routes": [
    {
      "distance": 1,
      "duration": 1,
      "geometry": {},
      "weight": 1,
      "weight_name": "text",
      "legs": [
        {
          "distance": 1,
          "duration": 1,
          "weight": 1,
          "summary": "text",
          "steps": [
            {
              "distance": 1,
              "duration": 1,
              "geometry": {},
              "weight": 1,
              "name": "text",
              "ref": "text",
              "pronunciation": "text",
              "destinations": {},
              "exits": {},
              "mode": "text",
              "maneuver": {
                "location": [
                  1
                ],
                "bearing_before": 1,
                "bearing_after": 1,
                "type": "text",
                "modifier": "text",
                "exit": 1
              },
              "intersections": [
                {
                  "location": [
                    1
                  ],
                  "bearings": [
                    1
                  ],
                  "classes": [
                    "text"
                  ],
                  "entry": [
                    null
                  ],
                  "in": 1,
                  "out": 1,
                  "lanes": [
                    {
                      "indications": [
                        "text"
                      ],
                      "valid": true
                    }
                  ]
                }
              ],
              "rotary_name": "text",
              "rotary_pronunciation": "text",
              "driving_side": "left"
            }
          ],
          "annotation": {
            "distance": [
              1
            ],
            "duration": [
              1
            ],
            "datasources": [
              1
            ],
            "nodes": [
              1
            ],
            "weight": [
              1
            ],
            "speed": [
              1
            ],
            "metadata": {
              "datasource_names": [
                "text"
              ]
            }
          }
        }
      ]
    }
  ]
}