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.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.