Venue Maps API Developer's Guide

Interaction Tiles

A venue iInteraction tile ("IA Tile") is a set of metadata in JSON format that is associated with a map tile image. It specifies an array of areas and data associated with each area.

Request

Table 1. Basic elements of the request
Element	Value/Example	Description
Base URL	`http://static-{1-4}.venue.maps.api.here.com`	Production environment
Access	`0`	Feature access parameter `0` - provides access to standard feature in resource; hence: tiles-ia
Resource	tiles-ia	GET only, specify request details via query parameters
Level	`L{n}`	n is the number value of the floor level which is requested for the venue.
Application Code	`app_code={YOUR_APP_CODE}`	Substitute your own unique Application Code
Application Id	`app_id={YOUR_APP_ID}`	Substitute your own unique Application Id
Signature	`Signature=<Signature-value>`	Substitute your unique Signature
Key-Pair-Id	`Key-Pair-Id=<Key-Pair-Id-value>`	Substitute your unique Key-Pair-Id
Policy	`Policy=<Policy-value>`	Substitute your unique Policy

Example

http://static-3.venue.maps.api.here.com/0/tiles-ia/L0/03022223103013033.json?
  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:

[
  {"area":[248,254,249,254,250,254,251,254,252,254,253,254,254,253,255,253,
       256,254,260,252,261,253,262,252,265,252,265,251,266,251,267,251,
       268,251,268,252,269,252,270,253,270,252,272,251,271,250,272,249,
       272,248,273,246,271,245,270,245,267,245,266,245,265,246,263,247,
       261,247,259,248,257,249,254,250,252,251,249,252,247,253,246,253,
       247,254],
  
  "object":
  {
    "id":"Lv24319Ds_1795349",
    "category":{"id":"24"},
    "preview":"PlayArea",
    "outerAreaId":"Lv24319Ds_1795319_d",
    "type":"space/polygon",
    "contentId":"1111313"}},
  
  {"area":[237,257,236,258,235,259,236,260,236,261,237,262,238,262,239,262,
       240,262,240,261,241,262,242,261,243,261,244,261,245,259,246,259,
       247,258,247,257,247,256,246,256,246,255,246,254,245,254,244,254,
       243,255,242,256,241,256,240,256,239,257,238,258,238,257],
  
  "object":
  {
    "id":"Lv24319Ds_1795354",
    "category":{"id":"99999"},
    "preview":"Children's BoatingPond",
    "outerAreaId":"Lv24319Ds_1795319_d",
    "type":"space/polygon",
    "contentId":"1110676"
  }
}....

Response Attributes

Type	Description
Array	an array of { Space \| Floor } IATileMember

Output File Types

The resource tiles-ia is offered in

Resource	Compression type	File suffix
Metadata of a map tile in JSON Format	Uncompressed	`.json`
Compressed metadata of a map tile in JSON Format	zip compression	`.json.zip`
Compressed metadata of a map tile in JSON Format	gzip compression	`.json.gz`
Metadata of a map tile in JSON Format wrapped in JavaScript function call `JSON.venues`	Uncompressed	`.js`
Metadata of a map tile in JSON Format wrapped in JavaScript function call `JSON.venues`	zip compression	`.js.zip`
Metadata of a map tile in JSON Format wrapped in JavaScript function call `JSON.venues`	gzip compression	`.js.gz`