The Locate service provides detailed information about streets and intersections close to an input point with some added matching criteria. This allows for tight integration in routing and navigation applications on web or mobile.
Locate result.
Incorrect request parameters.
API key is incorrect or not provided.
Subscription daily limit exceeded.
Subscription suspended.
{- "locations": [
- {
- "lat": -90,
- "lon": -180
}, - {
- "lat": -90,
- "lon": -180
}
], - "costing": "auto",
- "costing_options": {
- "auto": {
- "maneuver_penalty": 5,
- "gate_cost": 30,
- "gate_penalty": 300,
- "private_access_penalty": 450,
- "toll_booth_cost": 15,
- "toll_booth_penalty": 0,
- "ferry_cost": 300,
- "use_ferry": 0.5,
- "use_highways": 1,
- "use_tolls": 0.5,
- "use_living_streets": 1,
- "use_tracks": 1,
- "service_penalty": 0,
- "service_factor": 1,
- "country_crossing_cost": 600,
- "country_crossing_penalty": 1,
- "shortest": false,
- "disable_hierarchy_pruning": false,
- "top_speed": 140,
- "fixed_speed": 0,
- "ignore_closures": true,
- "closure_factor": 9,
- "height": 0,
- "width": 0,
- "exclude_unpaved": true,
- "exclude_cash_only_tolls": false,
- "include_hov2": false,
- "include_hov3": false,
- "include_hot": false
}, - "bus": {
- "maneuver_penalty": 5,
- "gate_cost": 30,
- "gate_penalty": 300,
- "private_access_penalty": 450,
- "toll_booth_cost": 15,
- "toll_booth_penalty": 0,
- "ferry_cost": 300,
- "use_ferry": 0.5,
- "use_highways": 1,
- "use_tolls": 0.5,
- "use_living_streets": 1,
- "use_tracks": 1,
- "service_penalty": 0,
- "service_factor": 1,
- "country_crossing_cost": 600,
- "country_crossing_penalty": 1,
- "shortest": false,
- "disable_hierarchy_pruning": false,
- "top_speed": 140,
- "fixed_speed": 0,
- "ignore_closures": true,
- "closure_factor": 9,
- "height": 0,
- "width": 0,
- "exclude_unpaved": true,
- "exclude_cash_only_tolls": false,
- "include_hov2": false,
- "include_hov3": false,
- "include_hot": false
}, - "truck": {
- "maneuver_penalty": 5,
- "gate_cost": 30,
- "gate_penalty": 300,
- "private_access_penalty": 450,
- "toll_booth_cost": 15,
- "toll_booth_penalty": 0,
- "ferry_cost": 300,
- "use_ferry": 0.5,
- "use_highways": 1,
- "use_tolls": 0.5,
- "use_living_streets": 1,
- "use_tracks": 1,
- "service_penalty": 0,
- "service_factor": 1,
- "country_crossing_cost": 600,
- "country_crossing_penalty": 1,
- "shortest": false,
- "disable_hierarchy_pruning": false,
- "top_speed": 140,
- "fixed_speed": 0,
- "ignore_closures": true,
- "closure_factor": 9,
- "height": 0,
- "width": 0,
- "exclude_unpaved": true,
- "exclude_cash_only_tolls": false,
- "include_hov2": false,
- "include_hov3": false,
- "include_hot": false,
- "length": 21.64,
- "weight": 21.77,
- "axle_load": 9.07,
- "axle_count": 5,
- "hazmat": false
}, - "taxi": {
- "height": 0,
- "width": 0,
- "exclude_unpaved": true,
- "exclude_cash_only_tolls": false,
- "include_hov2": false,
- "include_hov3": false,
- "include_hot": false
}, - "bicycle": {
- "bicycle_type": "Road",
- "cycling_speed": 18,
- "use_roads": 0.5,
- "use_hills": 0.5,
- "use_ferry": 0.5,
- "use_living_streets": 0.5,
- "avoid_bad_surfaces": 0.25,
- "bss_return_cost": 120,
- "shortest": false
}, - "bikeshare": {
- "walking_speed": 5.1,
- "walkway_factor": 1,
- "sidewalk_factor": 1,
- "alley_factor": 2,
- "driveway_factor": 5,
- "step_penalty": 0,
- "use_ferry": 0.5,
- "use_living_streets": 0.5,
- "use_tracks": 0.5,
- "use_hills": 0.5,
- "use_lit": 0,
- "service_penalty": 0,
- "service_factor": 1,
- "max_hiking_difficulty": 1,
- "bss_rent_cost": 120,
- "shortest": false,
- "transit_start_end_max_distance": 2145,
- "transit_transfer_max_distance": 800,
- "bicycle_type": "Road",
- "cycling_speed": 18,
- "use_roads": 0.5,
- "avoid_bad_surfaces": 0.25,
- "bss_return_cost": 120
}, - "motor_scooter": {
- "top_speed": 45,
- "use_primary": 0.5,
- "use_hills": 0.5,
- "shortest": false,
- "disable_hierarchy_pruning": false
}, - "motorcycle": {
- "use_highways": 1,
- "use_trails": 0,
- "shortest": false,
- "disable_hierarchy_pruning": false
}, - "pedestrian": {
- "walking_speed": 5.1,
- "walkway_factor": 1,
- "sidewalk_factor": 1,
- "alley_factor": 2,
- "driveway_factor": 5,
- "step_penalty": 0,
- "use_ferry": 0.5,
- "use_living_streets": 0.6,
- "use_tracks": 0.5,
- "use_hills": 0.5,
- "use_lit": 0,
- "service_penalty": 0,
- "service_factor": 1,
- "max_hiking_difficulty": 1,
- "bss_rent_cost": 120,
- "shortest": false,
- "transit_start_end_max_distance": 2145,
- "transit_transfer_max_distance": 800
}, - "transit": {
- "use_bus": 1,
- "use_rail": 1,
- "use_transfers": 1,
- "filters": {
- "routes": {
- "ids": [
- "NYC_AUR"
], - "action": "exclude"
}, - "operators": {
- "ids": [
- "paris_CFG"
], - "action": "exclude"
}
}
}, - "multimodal": {
- "use_bus": 1,
- "use_rail": 1,
- "use_transfers": 1,
- "filters": {
- "routes": {
- "ids": [
- "NYC_AUR"
], - "action": "exclude"
}, - "operators": {
- "ids": [
- "paris_CFG"
], - "action": "exclude"
}
}
}
}, - "verbose": true,
- "directions_options": {
- "units": "km"
}
}
[- {
- "reason": "string",
- "input_lat": 0,
- "input_lon": 0,
- "nodes": [
- {
- "lat": 0,
- "lon": 0
}
], - "edges": [
- {
- "side_of_street": "string",
- "correlated_lat": 0,
- "correlated_lon": 0,
- "percent_along": 0,
- "way_id": 0
}
]
}
]