Venue Maps API Developer's Guide

Requesting a Venue Route

A typical request to the routing service would look like this:

Table 1. Basic elements of request to routing service
Attribute Value/Example Description
Base

https://indoor-routing.venue.maps.api.here.com

https://indoor-routing.venue.maps.cit.api.here.com

Production environment

Customer Integration Testing environment

Service venues
Feature routing
Version v1 Version number of Venue Maps API
Application Id app_id={YOUR_APP_ID} Substitute with your unique Application Id
Application Code app_code={YOUR_APP_CODE} Substitute with your unique Application Code
waypoint0 geo!52.52036235819847,13.419705296325674,0 The first waypoint on the desired route - the starting point. A set of WGS 84 coordinates and a level index.
waypoint1 geo!52.51824714580289,13.41655101852416,0 The second waypoint on the desired route - the destination point. A set of WGS 84 coordinates and a level index.
venueRouteOptions fastest Route options for the indoor part (in this case: select fastest route)
mode fastest;car Route options for the outdoor part (in this case: select fastest route, use car routing)

Examples

Example Request:

https://indoor-routing.venue.maps.cit.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.

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.