HERE Public Transit API 3
In maintenance
Public Transit API v3 Developer's Guide

# All Next Departures By Geocoord

Use the multiboard/by_geocoord resource to request the multiple next departures at a certain location.

This section provides information on the resources and request parameters for the multiple next departures functionality using geo coordinates.

.../v3/multiboard/by_geocoord.{format}?<parameter>=<value>...
Table 1. Mandatory Parameters
Parameter Data Type Description
app_id String

Typically, but not guaranteed to be, 20
bytes Base64 URL-safe encoded string used for the authentication of
the client application. If you use the app ID/app code option, you
need to include an app_id and
app_code with every request. For the available authentication options, see the Identity & Access Management Developer Guide.

app_code String

Typically, but not guaranteed to be, 20
bytes Base64 URL-safe encoded string used for the authentication of
the client application. If you use the app ID/app code option, you
need to include an app_id and
app_code with every request. For the available authentication options, see the Identity & Access Management Developer Guide.

apiKey String

A 43-byte Base64 URL-safe encoded string used for the authentication of the client
application. As a logged in user, you can generate it at
https://developer.here.com/projects.
API Keys never expire but you can invalidate your API Keys at any time. You cannot have more
than two API Keys for one app at the same time. You must include an apiKey with every request. For the full authentication story, see the Identity & Access Management Developer Guide.

center Double,Double Specifies the latitude and the longitude of the center point of your search separated by a comma. Where the latitude is in WGS 84-compliant degrees between -90 and 90 and the longitude in WGS 84-compliant degrees between -180 and 180.
time DateTime Specifies the time in ISO 8601 (for example, 2020-10-24T01:23:45) format.
• When the optional timezone offset is not specified time is assumed to be local. All xs:dateTime in the response are also returned without timezone.
• When timezone offset is specified, the time will get converted to local time valid at the requested geo coordinates. All xs:dateTime in the response will also contain timezone offset.
Table 2. Optional Parameters
Parameter Data Type Description
callbackFunc String Specifies an arbitrary string used to wrap the JSON object in the response.
callbackId Integer If you specify the parameter callbackId, specifies the first argument to the function specified by the callbackFunc.
lang String Specifies the language of the response. The value complies with the ISO 639-1 standard and defaults to en.
modes String

Specifies the transit type filter used to determine which types of transit to include in the response.
By default the parameter is omitted, meaning all supported transit types are permitted.

radius Integer Specifies a radius in meters that when combined with a centerpoint defines the area of the search.

The default value is 500m. The minimum value is 0 and the maximum value is not limited.

max Integer Specifies the maximum number of next departures per station the response should include.

The default value is 40. The minimum value is 1 and the maximum value is 100.

maxStn Integer Specifies the maximum number of stations the response should include.

The default value is 40. The minimum value is 1 and the maximum value is 40.

maxPerTransport Integer Define the maximum number of results per transport returned in the response. A transport is identified by his name, direction and mode. When not set, all departures are returned, otherwise the first maxPerTransport departures for each transport in chronological order are returned.

Range: 1-10

sort Enum Define how the departures are sorted. By default the departures are returned sorted by scheduled time. When sort=transport, the departures are sorted first by transport and then by scheduled time.
• sort=time: means sorted by Dep@time
• sort=transport: means that we sort by name, direction and mode in this order, i.e. Dep/Transport@name, Dep/Transport@dir, Dep/Transport@mode, Dep@time

The default is sort=time.

timespan Integer Limit the next departures to the defined time window and starting from the time provided in the request. When not set, this filter is not applied and a maximum of 24 hours of departures can be returned. The filter will remove all departures outside the interval defined by time and timespan.

Range: 1-1440 minutes

The default is none.