Fuel Prices API Developer's Guide

Stations by PVID or station id

The stations/bulk resource allows you to retrieve dynamic and static information about a specific fuel stations.

Requests against this resource use the HTTP GET method.

Request Example

The code block below shows a search request for a station with a specific pvid or pds id.


https://fuel-v2.cc.api.here.com/fuel/stations/bulk.xml
    ?id=1099721199&apiKey={YOUR_API_KEY}

Request Parameters

The table below documents both mandatory and optional request parameters supported by the stations by PVID or station id resource.

Parameter Required Description
app_id - legacy Yes

A-20 byte 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. For more information on authentication, see the Identity & Access Management Developer Guide.

app_code - legacy Yes

A-20 byte 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. For more information on authentication, see the Identity & Access Management Developer Guide.

apiKey Yes 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 more information on authentication, see the Identity & Access Management Developer Guide.
id yes

List of required fuel stations PVIDs or station ids. Items order in the response is not guaranteed. Might not match with order of requested IDs.

Non-existing PVIDs and station ids are ignored.

Maximum limit is 50 ids per request.

content no

Limit the content in the response.

The possible values are:

  • dynamic (returns only dynamic data)
  • all (return both, static and dynamic, data)

Default: dynamic

imagedimensions No Request specific maximum size of brand icon image to match UI and bandwidth requirements

The format is that specifies dimension for a scaled image by providing either the desired width, desired heigh, or both

Valid elements are:

  • w\d+
  • h\d+
  • w\d+-h\d+

Examples:

  • imagedimensions=w32-h32
  • imagedimensions=w300
  • imagedimensions=h200
Note: The provided values are used as upper boundaries for the dimensions of the returned image. The solution will never scale up small image and will maintain the aspect ratio of the original image.

Response to this Request

Note: In case query parametercontent is omitted or is set to 'dynamic', response will contain ONLY dynamic data for each requested fuel station - FuelPriceType element.

For more information on responses to queries for a specific station, see Fuel Stations Response.