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

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

Production environment

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

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.