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.hereapi.com/v3/stations
        ?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 app. You must include authentication with every request. For more information on authentication, see the Identity and Access Management Developer Guide.
`app_code` - legacy	Yes	A-20 byte Base64 URL-safe encoded string used for the authentication of the client app. You must include authentication with every request. For more information on authentication, see the Identity and Access Management Developer Guide.
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 invalidate 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.
`id`	yes	List of required fuel stations PVIDs or station ids. The item's order in the response isn't guaranteed and might not match the order of the 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 specifies dimension for a scaled image by providing either the desired width, desired height, or both. Valid elements are: • w\d+ • h\d+ Examples:• imagedimensions=w32-h32 • imagedimensions=w300 • imagedimensions=h200 The provided values are upper boundaries for the dimensions of the returned image. The solution never scales up small image and maintains the aspect ratio of the original image.

Response

📘
Note
If the query parametercontent is omitted, or 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 FuelStationsResultType response.