Venue Maps API Developer's Guide

Interaction Tiles

A Venue Interaction 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

http://static-{1-4}.venue.maps.cit.api.here.com

Production environment

Customer Integration Testing 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.cit.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