Venue Maps API Developer's Guide

Discovery Service request

The Discovery Service allows to obtain list of venues available in given geographical area. Please note that the CIT environment is limited to venues in Chicago (US), Boston (US), Berlin (DE) and San Francisco (US).

Table 1. Basic elements of request to Discovery Service
Element Value/Example Description
Base

https://discovery.venue.maps.api.here.com

https://discovery.venue.maps.cit.api.here.com

Production environment

Customer Integration Testing environment

Service venues
Feature discovery
Version v1 Version number of Venue Maps API
Application Id app_id={YOUR_APP_ID} Substitute with your unique Application Id
Application Code app_code={YOUR_APP_CODE} Substitute with your unique Application Code
Bounding box at=48.103030448017215%2C-93.65234375000001 %2C-3.3445330159738336%2C143.65234375 Bounding box is the geographical box which encompasses a certain area/venue. Bounding box is given as two WGS 84 coordinates topLeftLat, topLeftLon, bottomRightLat, bottomRightLon and URL encoded
JSONP static callback function (optional) cbfn=JSON.venues Substitute with desired static callback URL encoded

Examples

Example Request:

https://discovery.venue.maps.cit.api.here.com/venues/discovery/v1
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
  &at=52.569352,%2013.240772,52.468448,%2013.521953

Example Response:

{"hostname":"ip...",
 "totalHits":11,
 "forecastedHits":0,
 "bboxDiameter":22,
 "status":{"code":"200","message":"Ok"},
 "type":"venues",
 "results":{
  "items":[{
    "id":"DM_8791",
    "title":"Potsdamer Platz Arcaden",
    "address":{
      "countryCode":"DEU",
      "city":"Berlin",
      "postalCode":"10785",
      "street":"Alte Potsdamer Strasse","house":"7"},
    "position":[13.374028800000001,52.50753],
    "distance":"1.3597230050045217",
    "type":"urn:nlp-types:venue",
    "vicinity":"Alte Potsdamer Strasse 7,10785,Berlin,DEU",
    "size":1,
    "level":"13",
    "minFloor":-1,
    "maxFloor":1},
  
  {  "id":"DM_7171",
    "title":"Alexa",
    "address"{
      "countryCode":"DEU",
      "city":"Berlin",
      "postalCode":"10179",
      "street":"Grunerstrabe",
      "house":""},
    "position":[13.41571115,52.51872755],
    "distance":"2.3267883368141047",
    "type":"urn:nlp-types:venue",
    "vicinity":"Grunerstrabe,10179,Berlin,DEU",
    "size":1,"level":"13",
    "minFloor":-1,
    "maxFloor":3},
    .... Content Truncated .. 

Example Request (with static callback):

https://discovery.venue.maps.cit.api.here.com/venues/discovery/v1
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
  &at=52.569352,%2013.240772,52.468448,%2013.521953
  &cbfn=JSON.venues

Example Response:

JSON.venues(
{"hostname":"ip...",
 "totalHits":11,
 "forecastedHits":0,
 "bboxDiameter":22,
 "status":{"code":"200","message":"Ok"},
 "type":"venues",
 "results":{
  "items":[{
    "id":"DM_8791",
    "title":"Potsdamer Platz Arcaden",
    "address":{
      "countryCode":"DEU",
      "city":"Berlin",
      "postalCode":"10785",
      "street":"Alte Potsdamer Strasse","house":"7"},
    "position":[13.374028800000001,52.50753],
    "distance":"1.3597230050045217",
    "type":"urn:nlp-types:venue",
    "vicinity":"Alte Potsdamer Strasse 7,10785,Berlin,DEU",
    "size":1,
    "level":"13",
    "minFloor":-1,
    "maxFloor":1},
  
  {  "id":"DM_7171",
    "title":"Alexa",
    "address"{
      "countryCode":"DEU",
      "city":"Berlin",
      "postalCode":"10179",
      "street":"Grunerstrabe",
      "house":""},
    "position":[13.41571115,52.51872755],
    "distance":"2.3267883368141047",
    "type":"urn:nlp-types:venue",
    "vicinity":"Grunerstrabe,10179,Berlin,DEU",
    "size":1,"level":"13",
    "minFloor":-1,
    "maxFloor":3},
    .... Content Truncated .. 

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.