Venue Maps API Developer's Guide

Request an Interaction Tile with Base64 Encoded Image

The user wants to see venue information for Union Station in Chicago, USA but they also want to be able to interact with the map. They want to be able to click or touch parts of the map to get more information about specific areas.

However, you might want to make as fewer requests as possible to fulfill this requirement. Ideally, you want to get the image and medata in one request.

In this case, you need to request an interaction tile with a base64 encoded image.

Request

This is an example on how to get an Interaction Tile with base64 encoded image.

http://static-3.venue.maps.cit.api.here.com/0/tiles-ia-b64/L0/03022223103013033.js?
  Policy={YOUR_GENERATED_POLICY}
  &Signature={YOUR_GENERATED_SIGNATURE}
  &Key-Pair-Id={YOUR_GENERATED_KEY_PAIR_ID}
  &app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}

Response

This request returns a similar JSON response to the request for a pure interaction tile. However, it also contains that a property for the base64 encoded image.

Additionally, it includes objects for "area" and "object". The area object contains coordinates for polygon vertices . This polgyon defines the shape of each area. The "object" object contains metadata about area such as the type and category.

JSON.venues("0_17_33627_48715", {
  "image": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAABccqhmAAAhuklEQVR4nO2dS/AdxXXGvf...",
  "members": [
    {
      "area": [
        182, 69, 182, 85, ...
      ],
      "object": {
        "id": "Lv25710Ds_1914895",
        "preview": "Platform 21",
        "placeId": "",
        "type": "space/polygon"
      }
    },
    {
      "area": [
        74, 145, ...
      ],
      "object": {
        "id": "Lv25710Ds_1914919",
        "preview": "Shoe Shine Service",
        "placeId": "",
        "type": "space/polygon"
      }
    },
    ...
    {
      "area": [
        109, 191, 128, 190, 128, 205, 130, 205, 130, 190, 134, ...
      ],
      "object": {
        "id": "Lv25710Ds_1908939_d",
        "center": [
          41.878688,
          -87.6397015
        ],
        "preview": "Concourse Level",
        "minZoomLevel": 17,
        "placeId": "",
        "buildingPreview": "Union Station Chicago",
        "buildingMaxLevel": 1,
        "buildingMinLevel": 0,
        "type": "floor/polygon",
        "buildingId": "DM_12321"
      }
    }
  ]
});

Related Information