Venue Maps API Developer's Guide

POI Models

POI venue models provide venue information and Points of Interest (POI) data in JSON format with options for various output file types.

A full model is useful if you want to use all the features of the Venue Maps API while maintaining your own user experience and look-and-feel. It offers a fully customizable approach with maximum information usage.

To find out how to get the venue ID for a certain venue, see the introduction to models.

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:

Below is the beginning part of the response. For the full detailed list of the response attributes, see 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