Venue Maps API Developer's Guide

Requesting a List of Venues in an Area

The user wants to see a list of venues in a given geographical area that are covered by the Venue Maps API.

Request

The following request retrieves venues within a bounding box that encloses Berlin, Germany:

https://indoor-discovery.venue.maps.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

Response

The response provides a list of venues contained within a results object:

{
  "hostname": "ip-xx",
  "type": "venues",
  "status": {
    "code": "OK",
    "reason": "DISCOVERY_SUCCESSFULL"
  },
  "paging": {
    "after": "1"
  },
  "results": {
    "items": [...venue items...]
  }
}

Request

The following request includes a static callback and retrieves venues within a bounding box that encloses Berlin, Germany:

https://indoor-discovery.venue.maps.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

Response

The response is returned as a JSON object and provides a list of venues contained within a results object:

JSON.venues({
  "hostname": "ip...",
  "type": "venues",
  "status": {
    "code": "OK",
    "reason": "DISCOVERY_SUCCESSFULL"
  },
  "results": {
    "items": [{
      "id": "DM_18568",
      "title": "LP12 Mall of Berlin",
      "address": {
        "countryCode": "DEU",
        "city": "Berlin",
        "postalCode": "10117",
        "street": "Leipziger Platz",
        "house": "12"
      },
      "position": [52.510570099882194,
      13.381399000013154],
      "distance": 926.2459256454601,
      "type": "urn:nlp-types:venue",
      "vicinity": "Leipziger Platz 12,10117,Berlin,DEU",
      "bbox": [[52.51132166967421,
      13.378926268672588],
      [52.50981862285035,
      13.383871805467322]],
      "minFloor": -4,
      "maxFloor": 2,
      "namespace": "public"
    },
    {
      "id": "DM_16615",
      "title": "Pergamonmuseum",
      "address": {
        "countryCode": "DEU",
        "city": "Berlin",
        "postalCode": "10178",
        "street": "Bode straße",
        "house": "1"
      },
      "position": [52.52092885006327,
      13.396425399977867],
      "distance": 1043.833708066091,
      "type": "urn:nlp-types:venue",
      "vicinity": "Bode straße 1,10178,Berlin,DEU",
      "bbox": [[52.521680707244336,
      13.39517699325204],
      [52.52017700802355,
      13.39767395183927]],
      "minFloor": -1,
      "maxFloor": 0,
      "namespace": "public"
    .... Content Truncated ....