Stations by PVID or station id
The stations/bulk resource allows you to retrieve dynamic and static information about a specific fuel station, using a PVID (A PVID is a Published Version Identifier which is a unique reference mechanism used to identify a map feature.) or a pds id (the station id).
.
Requests for this resource use the HTTP GET method.
Request
This code block 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
This table 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 authentication 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 authentication 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:
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:
Examples:
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
content is omitted or is set to 'dynamic', the response contains 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.
