Venue Maps API Developer's Guide

Discovery Service Request

The Discovery Service allows to obtain a list of venues available in given geographical area. A typical request includes the basic elements shown in the following table and may contain resource-specific parameters or data.

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

Production environment

Customer Integration Testing environment

Service Path venues
Feature Path discovery
Version v1 Version number of Venue Maps API
Application Code &app_code={YOUR_APP_CODE} Substitute your own unique app_code
Application ID &app_id={YOUR_APP_ID} Substitute your own unique app_id
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

For further information, see Examples.

The Discovery Service enables discovery of venues. This is usually the second API to call in the venues data consuption process. Bounding box can be used as a request parameter to only return venues falling inside specified bounding box. The maximum diameter (diagonal length) of provided bounding box is 100 000 meters. If no bounding box is given, all venues matching additional filtering parameters are returned.

By default, discovery service returns both public and private content. Filtering parameter ns can be used to provide a list of namespaces to which discovered items should be matched against. Special namespace keywords public and private can be used to refer all public and all private items respectively. Keyword public expands to full list of private namespaces matching authorizations provided in request.

As an alternative, if you just want a list of all venues in a specific name space, you can request an index file with all venues.

For more informaton on private venues, see

Note: The CIT environment is limited to venues in Chicago (US), Boston (US), Berlin (DE) and San Francisco (US).


Example Request:

Example Response:

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

For details on request and response parameters, see Discovery Service.