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 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 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:

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