Stations Along the Route

This resource retrieves a list of fuel stations that match the specified criteria.
Requests for this resource use the HTTP POST method. This supports only corridor searches. Maximum corridor area is 5000 km2

Request

This code block shows a search request for fuel stations along the route from Hamburg, Stormarnplatz to Hamburg, Sommerpfad.

https://fuel.hereapi.com/v3/stations
?apiKey=\{YOUR\_API\_KEY\}

Request Parameters

The following table documents both mandatory and optional request parameters supported by the stations resource.

Parameter	Required	Description
apiKey	Yes	A 43-byte Base64 URL-safe encoded string used for the authentication of the client app. API Keys never expire but you can disable your API Keys at any time. You can't have more than two API Keys for one app at the same time. You must include an apiKey with every request. For more information on authentication, see the Identity and Access Management Developer Guide.
`fuelTypes`	No	Comma separated integers identifying the fuel types or categories included in the response. There are an unlimited number of values. By default, the result set excludes Stations with unknown price information. When the `showallstations` parameter is set to "true," then all stations within the search area are in the result. For more information on available fuel types and categories, see Fuel Types and Categories.
`limit`	No	The maximum number of results a response can contain. This parameter together with the `offset` parameter in the query and count in the response, can be used for pagination. Default: 50.
`offset`	No	A value specifying the index of the first result. This parameter together with the `limit` parameter in the query and count in the response can be used for pagination. Default: 0.
`returnAllStations`	No	Fuel stations with unknown price or fuel type information are in the result set. This parameter works together with `fuelTypes` parameter. The possible values are:• true • false Default: false .
`iconSize`	No	Request specific maximum size of `brand icon` image - in pixels - to match UI and bandwidth requirements. Valid values are: • 8 • 16 • 20 • 24 • 32 • 40 • 48
`brands`	No	A-list of brands to filter the stations in the response. Separate the brand names in the station matching one in the list. The matching is case-insensitive.

The following code block provides an example of a required CorridorSearchRequest with search criteria. The Content-Type is set to application/json in this case. For more information about this object, see CorridorSearchRequest

{
  "corridor": [
    {
      "lat": 52.5310898,
      "lng": 13.3849497
    },
    {
      "lat": 52.5378799,
      "lng": 13.3735304
    },
    {
      "lat": 52.5476799,
      "lng": 13.3569899
    },
    {
      "lat": 52.5622292,
      "lng": 13.3263397
    }
  ],
  "width": 5000
}

Response

For more information on the responses to queries for the stations resource, see FuelStationsResultType response.