Public Transit API Developer's Guide

Get Cities

Use the resource city to search for public transit coverage by city.

.../coverage/v1/city.{format}?<parameter>=<value>...
    
Table 1. Mandatory Parameters
Parameter Data Type Description
app_id String

A 20 bytes Base64 URL-safe encoded string used for the authentication of the client application.
You must include an app_id and app_code with every request. To get an app_code assigned to you, please see Acquiring Credentials.

app_code String

A 20 bytes Base64 URL-safe encoded string used for the authentication of the client application.
You must include an app_id and app_code with every request. To get an app_code assigned to you, please see Acquiring Credentials.

chinaconfig Integer

A switch that allows grouping results from Taiwan together with results from China.

When enabled, Taiwan will appear as part of China.
            

Table 2. Optional Parameters: Filter by cities around a point location within a radius (all parameters need to be set)
Parameter Data Type Description
details Integer Specifies the level of detail included in the response. The response only includes the city tag when disabled. When you enable detailed coverage, the response contains population and operators information.

Only applicable to the cities list.

The nearby list never contains details.

0 = disabled, 1 = enabled

The default is 1

nearby_max Integer Enables a separate list for nearby cities. The resulting response contains a separate list of cities without any details.

Cities with zero relevancy are included in the nearby list. All cities with a relevancy greater than 0 are shown in the "main" cities list

radius Integer Specifies a radius in meters that when combined with a centerpoint (as specified by the parameters x and y) defines the area of the search. The default value is 150,000m.
x Double Specifies the longitude of the center point of your search in WGS 84-compliant degrees between -180 and 180.
y Double Specifies the latitude of the center point of your search in WGS 84-compliant degrees between -90 and 90.
Table 3. Optional Parameters: Filter cities by updated or new since a given date and time
Parameter Data Type Description
time DateTime Specifies the date and time to search from in format ISO 8601 (for example, 2016-06-22T06:36:40).

If you specify this parameter in your request, the response contains information filtered by given date. Use the updatetype parameter to specify filtering behavior.

updatetype String

If set to new, the resulting response contains only cities that are new (to HERE transit service) since the given date.

If set to updated, the resulting response contains only cities with updated coverage information since the specified date.

If set to all, the resulting response contains cities that are either updated or new since a given date.

Table 4. Optional Parameters: Other
Parameter Data Type Description
callback_func String Specifies an arbitrary string used to wrap the JSON object in the response.
callback_id Integer If you specify the parameter callback_id, specifies the first argument to the function specified by the callback_func.
lang String Specifies the language of the response. The value complies with the ISO 639-1 standard and defaults to en.

If lang matches the native language of a particular city, state and country, the response contains their native names. Otherwise, the response contains international/English names.

max Integer Limits the number of cities the response can contain.

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.