Venue Maps API Developer's Guide

Full Models

Full Venue Models provide venue information, geometry data, metadata, Points of Interest (POI) data and routing 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. For instructions on how to get venue ID for a certain venue, see resource-models.html#how-get-id.

Request A Full Venue Model

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

models-full

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-full/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, see 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-full contains

Resource Compression type File suffix
venue models with POI data, metadata and geometries uncompressed .json
compressed venue models with POI data, metadata and geometries zip compression .json.zip
compressed venue models with POI data, metadata and geometries gzip compression .json.gz
venue models with POI data, metadata and geometries wrapped in JavaScript function call JSON.venues uncompressed .js
compressed venue models with POI data, metadata and geometries wrapped in JavaScript function call JSON.venues zip compression .js.zip
compressed venue models with POI data, metadata and geometries wrapped in JavaScript function call JSON.venues gzip compression .js.gz