Venue Maps API Developer's Guide

Display All Venues Using Models Full

This use case is a step-by-step guide to displaying all venues in Venue Maps API, using the models-full resource.

Get a List with All the Venues Available in the Venue Maps API

To get a list of all the venues available in Venue Maps API, we send a request to Venue Index resource as follows:

http://static-3.venue.maps.api.here.com/1/models-full/index_bb.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}

The result shows a list of all the venues available in Venue Maps API

JSON.venues([{
    "gml:id": "DM_6718",
    "bb": [[
        51.7133798,
        5.3122028
      ], [
        51.7117037,
        5.3145374
    ]]
  }, {
    "gml:id": "DM_9466",
    "bb": [[
        -6.1498306,
        106.8906024
      ], [
        -6.1520246,
        106.8934705
    ]]
  }, {
    "gml:id": "DM_6846",
    "bb": [[
        36.7249491,
        -4.3148679
      ], [
        36.7227017,
        -4.3105854
    ]]
  },
  ...
]);

To simplify the process, we're going to take one sample venue ID from the previous response. You can repeat the following steps for each venue that you're interested in.

Retrieving the Full Model

Let's take the Venue ID DM_7171 and send a request to models-full resource for all information about the venue.

http://static-3.venue.maps.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}

The result shows that Venue ID of DM_7171 is Alexa Shopping Mall in Berlin, Germany.

{"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 == 

Displaying Union Train Station

The Full Model contains all the information that you need to draw the venue with another technology or platform. This information includes data about points of interest and routing options within the venue so that you can provide a rich user experience.

You can retrieve all Venue Maps API models in the JSON format which is completely language-independent.