Requesting a Venue Route
A user wants to find their way around a venue and get the best route from A to B. The might be on foot, navigating the venue with their smartphone or driving though the car park with the aid of their navigation system.
Request
A typical request to the routing service would look like this:
https://indoor-routing.venue.maps.api.here.com/venues/routing/v1
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&waypoint0=geo!52.52036235819847,13.419705296325674,0&waypoint1=geo!52.51824714580289,13.41655101852416,0&venueRouteOptions=fastest&mode=fastest;car
This request generates a route from inside a venue to a point outside the venue. The option fastest
relates to both the indoor and outdoor segments. Additionally, the option car
affects the outside part. As a result, the generated route consists of a pedestrian route inside the venue and a car route outside the venue.
IMPORTANT! Venue Maps routing uses an API feature called Matrix Routing. Matrix routing is part of Advanced features, and you need a suitable license to use this feature.
Example Response:
{
"id": "01890ea9-4d5c-4f13-bb91-7aa9c7b2c774",
"strategy": "VENUE_TO_OUTDOOR",
"response": {
"metaInfo": {
"timestamp": "",
"mapVersion": "2.11",
"moduleVersion": "1",
"interfaceVersion": "v1"
},
"route": [
{
"waypoint": [
{
"mappedPosition": {
"latitude": 52.5183647,
"longitude": 13.4170875
},
"originalPosition": {
"latitude": 52.5183647,
"longitude": 13.4170875
}
},
{
"mappedPosition": {
"latitude": 13.4091529,
"longitude": 52.5186552
},
"originalPosition": {
"latitude": 52.5186584,
"longitude": 13.4091589
}
}
],
"mode": {
"type": "fastest",
"transportModes": [
"car"
],
"trafficMode": "disabled",
"feature": []
},
"indoorMode": {
"type": "fastest",
"transportModes": [
"pedestrian"
],
"feature": []
},
"shape": [
52.5183647,
13.4170875,
52.5185981,
13.4165819,
52.5187124,
13.4166366,
52.5187739,
13.4166589,
52.5188483,
13.4169414,
52.5188483,
13.4169414,
52.5189218,
13.4171959,
52.5195622,
13.4166348,
52.5199807,
13.4161413,
52.5207853,
13.4151006,
52.5209141,
13.4150362,
52.5205493,
13.4145749,
52.5202918,
13.4142101,
52.5200665,
13.4137702,
52.5198197,
13.4131908,
52.5191009,
13.4117424,
52.5187147,
13.4111309,
52.518425,
13.4107447,
52.5179636,
13.4100795,
52.5182748,
13.4096825,
52.5186552,
13.4091529
],
"level": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"boundingBox": {
"topLeft": {
"latitude": 52.5209141,
"longitude": 13.4091529
},
"bottomRight": {
"latitude": 13.4096825,
"longitude": 52.5209141
}
},
"leg": [
{
"start": {
"mappedPosition": {
"latitude": 52.5183647,
"longitude": 13.4170875,
"level": 0
},
"originalPosition": {
"latitude": 52.5183647,
"longitude": 13.4170875,
"level": 0
},
"type": "stopOver",
"sideOfStreet": "neither"
},
"end": {
"mappedPosition": {
"latitude": 52.5188483,
"longitude": 13.4169414,
"level": 0
},
"originalPosition": {
"latitude": 52.5188483,
"longitude": 13.4169414,
"level": 0
},
"type": "stopOver",
"sideOfStreet": "neither"
},
"length": 84.02,
"travelTime": 85.36,
"maneuver": [
{
"position": {
"latitude": 52.5183647,
"longitude": 13.4170875,
"level": 0
},
"id": "V_7171Lv15001Ds1200460",
"connectorType": "NO_CONNECTOR",
"actionType": "START"
},
{
"position": {
"latitude": 52.5183647,
"longitude": 13.4170875,
"level": 0
},
"id": "V_7171Lv15001Ds1200460",
"connectorType": "ENTRANCE",
"actionType": "NO_ACTION"
},
{
"position": {
"latitude": 52.5188483,
"longitude": 13.4169414,
"level": 0
},
"connectorType": "NO_CONNECTOR",
"actionType": "STOP"
}
],
"link": [],
"boundingBox": {
"topLeft": {
"latitude": 52.5188483,
"longitude": 13.4165819
},
"bottomRight": {
"latitude": 52.5183647,
"longitude": 13.4170875
}
},
"shape": [
52.5183647,
13.4170875,
52.5185981,
13.4165819,
52.5187124,
13.4166366,
52.5187739,
13.4166589,
52.5188483,
13.4169414,
52.5188483,
13.4169414
],
"level": [
0,
0,
0,
0,
0,
0
],
"firstPoint": 0,
"lastPoint": 0,
"type": "INDOOR"
},
{
"start": {
"linkId": "+704285110",
"mappedPosition": {
"latitude": 52.5189218,
"longitude": 13.4171959
},
"originalPosition": {
"latitude": 52.5188483,
"longitude": 13.4169413
},
"type": "stopOver",
"spot": "0.7160494",
"sideOfStreet": "left",
"mappedRoadName": "Alexanderstraße",
"label": "Alexanderstraße",
"shapeIndex": "0"
},
"end": {
"linkId": "+709804830",
"mappedPosition": {
"latitude": 52.5186552,
"longitude": 13.4091529
},
"originalPosition": {
"latitude": 52.5186584,
"longitude": 13.4091588
},
"type": "stopOver",
"spot": "0.4741379",
"sideOfStreet": "neither",
"mappedRoadName": "Jüdenstraße",
"label": "Jüdenstraße",
"shapeIndex": "14"
},
"length": 838,
"travelTime": 863,
"maneuver": [
{
"position": {
"latitude": 52.5189218,
"longitude": 13.4171959
},
"instruction": "Head <span class=\"heading\">northwest</span> on <span class=\"street\">Alexanderstraße</span>. <span class=\"distance-description\">Go for <span class=\"length\">266 m</span>.</span>",
"travelTime": "280",
"length": "266",
"id": "M1",
"connectorType": "NO_CONNECTOR",
"actionType": "NO_ACTION"
},
{
"position": {
"latitude": 52.5209141,
"longitude": 13.4150362
},
"instruction": "Turn <span class=\"direction\">left</span> onto <span class=\"next-street\">Grunerstraße</span>. <span class=\"distance-description\">Go for <span class=\"length\">472 m</span>.</span>",
"travelTime": "483",
"length": "472",
"id": "M2",
"connectorType": "NO_CONNECTOR",
"actionType": "NO_ACTION"
},
{
"position": {
"latitude": 52.5179636,
"longitude": 13.4100795
},
"instruction": "Turn <span class=\"direction\">right</span> onto <span class=\"next-street\">Jüdenstraße</span>. <span class=\"distance-description\">Go for <span class=\"length\">100 m</span>.</span>",
"travelTime": "100",
"length": "100",
"id": "M3",
"connectorType": "NO_CONNECTOR",
"actionType": "NO_ACTION"
},
{
"position": {
"latitude": 52.5186552,
"longitude": 13.4091529
},
"instruction": "Arrive at <span class=\"street\">Jüdenstraße</span>.",
"travelTime": "0",
"length": "0",
"id": "M4",
"connectorType": "NO_CONNECTOR",
"actionType": "NO_ACTION"
}
],
"link": [],
"boundingBox": {},
"shape": [
52.5189218,
13.4171959,
52.5195622,
13.4166348,
52.5199807,
13.4161413,
52.5207853,
13.4151006,
52.5209141,
13.4150362,
52.5205493,
13.4145749,
52.5202918,
13.4142101,
52.5200665,
13.4137702,
52.5198197,
13.4131908,
52.5191009,
13.4117424,
52.5187147,
13.4111309,
52.518425,
13.4107447,
52.5179636,
13.4100795,
52.5182748,
13.4096825,
52.5186552,
13.4091529
],
"level": [],
"firstPoint": 0,
"lastPoint": 0,
"type": "OUTDOOR"
}
],
"note": [],
"summary": {
"distance": 922.02,
"travelTime": 948.36,
"flags": []
},
"label": [],
"type": "INDOOR_OUTDOOR"
}
]
}
}
For a detailed breakdown of the response, see Requesting a Venue Route.