Sign in

v1

latestOpenAPI 3.1.02026-08-0420183200.9 KB
Routing

Find the nearest roads to the set of input locations.

The nearest roads API allows you query for detailed information about streets and intersections near the input locations.

post/nearest_roads/v1

Request body

costing'auto' | 'bus' | 'taxi' | 'truck' | 'bicycle' | 'bikeshare' | 'motor_scooter' | 'motorcycle' | 'pedestrian' | 'low_speed_vehicle'

A routing profile that determines which roads are eligible for matching (e.g. trucks probably aren't on sidewalks, so the search will snap to the nearest truck-accessible road).

verboseboolean

Example request

{
  "locations": [
    {
      "lat": 59.436884,
      "lon": 24.742595
    }
  ],
  "verbose": true
}

Response

A list of streets and intersections that match the query.

idstring

An identifier to disambiguate requests (echoed by the server).

input_latnumber double

The input (searched) latitude.

input_lonnumber double

The input (searched) longitude.

Example response

[
  {
    "edges": [
      {
        "correlated_lat": 59.436875,
        "correlated_lon": 24.74263,
        "distance": 2.2,
        "edge": {
          "access": {
            "HOV": true,
            "bicycle": true,
            "bus": true,
            "car": true,
            "emergency": false,
            "golf_cart": true,
            "moped": true,
            "motorcycle": true,
            "pedestrian": true,
            "taxi": true,
            "truck": true,
            "wheelchair": true
          },
          "access_restriction": false,
          "bike_network": false,
          "bridge": false,
          "classification": {
            "classification": "service_other",
            "internal": false,
            "link": false,
            "surface": "paved",
            "use": "living_street"
          },
          "country_crossing": false,
          "cycle_lane": "none",
          "destination_only": false,
          "end_node": {
            "id": 2895,
            "level": 2,
            "tile_id": 860498,
            "value": 97146964626
          },
          "end_restriction": {
            "HOV": false,
            "bicycle": false,
            "bus": false,
            "car": false,
            "emergency": false,
            "moped": false,
            "motorcycle": false,
            "pedestrian": false,
            "taxi": false,
            "truck": false,
            "wheelchair": false
          },
          "forward": false,
          "geo_attributes": {
            "curvature": 5,
            "length": 32,
            "max_down_slope": -7,
            "max_up_slope": 0,
            "weighted_grade": -6.67
          },
          "has_sign": false,
          "lane_count": 1,
          "not_thru": false,
          "part_of_complex_restriction": false,
          "round_about": false,
          "seasonal": false,
          "sidewalk_left": false,
          "sidewalk_right": false,
          "speeds": {
            "constrained_flow": 0,
            "default": 20,
            "free_flow": 0,
            "predicted": false,
            "type": "classified"
          },
          "start_restriction": {
            "HOV": false,
            "bicycle": false,
            "bus": false,
            "car": false,
            "emergency": false,
            "moped": false,
            "motorcycle": false,
            "pedestrian": false,
            "taxi": false,
            "truck": false,
            "wheelchair": false
          },
          "toll": false,
          "traffic_signal": false,
          "truck_route": false,
          "tunnel": false
        },
        "edge_id": {
          "id": 1800,
          "level": 2,
          "tile_id": 860498,
          "value": 60404861586
        },
        "edge_info": {
          "bike_network": {
            "local": false,
            "mountain": false,
            "national": false,
            "regional": false
          },
          "mean_elevation": 36,
          "names": [
            "Rataskaevu"
          ],
          "shape": "{zvjpBwtden@zG`H~EdG",
          "speed_limit": 0,
          "way_id": 4853850
        },
        "inbound_reach": 50,
        "linear_reference": "KxGYOypEIXriAAAcABo6Uow=",
        "live_speed": {},
        "outbound_reach": 50,
        "percent_along": 0.54802,
        "predicted_speeds": [],
        "side_of_street": "neither"
      },
      {
        "correlated_lat": 59.436875,
        "correlated_lon": 24.74263,
        "distance": 2.2,
        "edge": {
          "access": {
            "HOV": true,
            "bicycle": true,
            "bus": true,
            "car": true,
            "emergency": false,
            "moped": true,
            "motorcycle": true,
            "pedestrian": true,
            "taxi": true,
            "truck": true,
            "wheelchair": true
          },
          "access_restriction": false,
          "bike_network": false,
          "bridge": false,
          "classification": {
            "classification": "service_other",
            "internal": false,
            "link": false,
            "surface": "paved",
            "use": "living_street"
          },
          "country_crossing": false,
          "cycle_lane": "none",
          "destination_only": false,
          "end_node": {
            "id": 819,
            "level": 2,
            "tile_id": 860498,
            "value": 27487963794
          },
          "end_restriction": {
            "HOV": false,
            "bicycle": false,
            "bus": false,
            "car": false,
            "emergency": false,
            "moped": false,
            "motorcycle": false,
            "pedestrian": false,
            "taxi": false,
            "truck": false,
            "wheelchair": false
          },
          "forward": true,
          "geo_attributes": {
            "curvature": 5,
            "length": 32,
            "max_down_slope": 0,
            "max_up_slope": 7,
            "weighted_grade": 6.67
          },
          "has_sign": false,
          "lane_count": 1,
          "not_thru": false,
          "part_of_complex_restriction": false,
          "round_about": false,
          "seasonal": false,
          "sidewalk_left": false,
          "sidewalk_right": false,
          "speeds": {
            "constrained_flow": 0,
            "default": 20,
            "free_flow": 0,
            "predicted": false,
            "type": "classified"
          },
          "start_restriction": {
            "HOV": false,
            "bicycle": false,
            "bus": false,
            "car": false,
            "emergency": false,
            "moped": false,
            "motorcycle": false,
            "pedestrian": false,
            "taxi": false,
            "truck": false,
            "wheelchair": false
          },
          "toll": false,
          "traffic_signal": false,
          "truck_route": false,
          "tunnel": false
        },
        "edge_id": {
          "id": 7368,
          "level": 2,
          "tile_id": 860498,
          "value": 247235938962
        },
        "edge_info": {
          "bike_network": {
            "local": false,
            "mountain": false,
            "national": false,
            "regional": false
          },
          "mean_elevation": 36,
          "names": [
            "Rataskaevu"
          ],
          "shape": "{zvjpBwtden@zG`H~EdG",
          "speed_limit": 0,
          "way_id": 4853850
        },
        "inbound_reach": 50,
        "linear_reference": "KxGYSCpELHryAP/l/+k6QnM=",
        "live_speed": {},
        "outbound_reach": 50,
        "percent_along": 0.45198,
        "predicted_speeds": [],
        "side_of_street": "neither"
      }
    ],
    "input_lat": 59.436884,
    "input_lon": 24.742595,
    "nodes": []
  }
]