Venue Maps API Developer's Guide

POI Models

POI Venue Models provide venue information and Points of Interest (POI) data in JSON format with various output file types options. A Model is useful if you would like to use Venue Maps fully yet, Maintain your own user-experience and Look-and-Feel. It offers a fully customizable approach with maximum information usage. On how to get venue ID for a certain venue please click here

Request A POI Venue Model

Table 1. Basic elements of request to Venue Maps API - Models POI
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-poi
Resource

models-poi

GET only, specify request details via query parameters

Venue ID - Output File Type DM_7171.json

DM_ is a required prefix

7171 is an example of a Venue ID

.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 Example

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

Following is the beginning part of the response, for the full detailed list of the response attributes, please check Venue Model Structure

{"content":
  {"category":
    {
    "id":"shopping","nt":"6512"
    },
    
    "phoneNumber":"+49 (30) 2693400",
    "placeId":"",
    "names":{"GER":"Alexa Shopping Center"},
    "addresses":
      {"GER":{"postalCode":"10179",
      "countryCode":"DEU",
      "houseNumber":"20",
      "streetName":"Gruner strasse",
      "district":"DE","city":"Berlin"},
      "ENG":{"postalCode":"10179",
      "countryCode":"DEU",
      "houseNumber":"20",
      "streetName":"Gruner strasse",
      "district":"DE","city":"Berlin"}},
    "contentId":"814985"},
  
  "connectors":[{
    "destination2":"Lv15003Ds_2486040",
    "connectorClass":"ELEVATOR",
    "destination1":"Lv15004Ds_2486057"}, ... 
           == Content Truncated == 

Output File Types

The resource models-poi contains

Resource Compression type File suffix
venue models with POI data uncompressed .json
compressed venue models with POI data zip compression .json.zip
compressed venue models with POI data gzip compression .json.gz
venue models with POI data wrapped in JavaScript function call JSON.venues uncompressed .js
compressed venue models with POI data wrapped in JavaScript function call JSON.venues zip compression .js.zip
compressed venue models with POI data 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.