Venue Maps API Developer's Guide

Venues Index

An index of all Venue IDs of available venues and their bounding boxes.

Request A Venue Index

Table 1. Basic elements of request to Venue Maps API - Venue Index
Element	Value/Example	Description
Base URL	`http://static-{1-4}.venue.maps.api.here.com`	Production environment
Access	`1`	`1` - provides access to premium features in resources hence: models-full and models-poi Venue Index
Resource	models-full or models-poi	GET only, specify request details via query parameters
File Name - Output File Type	`index_bb.json`	`index_bb` is a constant name for the file. `.json` is one of the following possible Output File Types: `.json`, `.json.zip`, `.json.gz`, `.js`, `.js.zip`, `.js.gz`
Application Id	`app_id={YOUR_APP_ID}`	Substitute your own unique Application Id
Application Code	`app_code={YOUR_APP_CODE}`	Substitute your own unique Application Code
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

Request Venue Index Example

Venue Index is available for Full Models and POI Models, thus two requests are possible:

Request Venue Index using models-full

http://static-3.venue.maps.api.here.com/1/models-full/index_bb.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:

JSON.venues([{
    "gml:id": "DM_6718",
    "bb": [[
        51.7133798,
        5.3122028
      ], [
        51.7117037,
        5.3145374
    ]]
  }, {
    "gml:id": "DM_9466",
    "bb": [[
        -6.1498306,
        106.8906024
      ], [
        -6.1520246,
        106.8934705
    ]]
  }, {
    "gml:id": "DM_6846",
    "bb": [[
        36.7249491,
        -4.3148679
      ], [
        36.7227017,
        -4.3105854
    ]]
  },
  ...
]);

Request Venue Index using models-poi

http://static-3.venue.maps.api.here.com/1/models-poi/index_bb.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

JSON.venues([{
    "gml:id": "DM_6718",
    "bb": [[
        51.7133798,
        5.3122028
      ], [
        51.7117037,
        5.3145374
    ]]
  }, {
    "gml:id": "DM_9466",
    "bb": [[
        -6.1498306,
        106.8906024
      ], [
        -6.1520246,
        106.8934705
    ]]
  }, {
    "gml:id": "DM_6846",
    "bb": [[
        36.7249491,
        -4.3148679
      ], [
        36.7227017,
        -4.3105854
    ]]
  },
  ...
]);

Response Attributes

All venue objects are stored in a JavaScript array and each item has the following attributes:

Attribute	Type	Description
gml:id	String	Unique identifier of the venue
bb	[ Point , Point ]	Union of bounding boxes of all levels of the venue

Available Output File Types

Resource	Compression type	File suffix
venue index	Uncompressed	`.json`
Compressed venue index	zip compression	`.json.zip`
Compressed venue index	gzip compression	`.json.gz`
venue index wrapped in JavaScript function call `JSON.venues`	Uncompressed	`.js`
Compressed venue index wrapped in JavaScript function call `JSON.venues`	zip compression	`.js.zip`
Compressed venue index wrapped in JavaScript function call `JSON.venues`	gzip compression	`.js.gz`