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`	Production 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.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`