Fuel Prices API Developer's Guide

Constructing a Request

A request to the Fuel Prices API includes the basic elements shown in the following table and resource-specific parameters.

Note: This example uses a HERE token to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide
Table 1. Basic request elements
Element Value/Example Description
Base URL
https://fuel-v2.cc.api.here.com/

Environment: see HERE Server Environments

Path
 fuel/
 
Resource

fueltypes

stations

stations

stations/bulk

stations/{id}

Uses HTTP GET.

Uses HTTP GET.

Uses HTTP POST (corridor search only).

Uses HTTP GET.

Uses HTTP GET.

Format specified
.xml
.json

We recommend that you specify whether you expect XML or JSON output.

The default output format is XML.

Parameters (examples)

prox

fueltype

See sub-sections of Resources for lists of supported parameters per resource.
Authorization header
-H "Authorization: Bearer {YOUR_TOKEN}"
                

Substitute your own unique token. For more details on authentication, see the Identity & Access Management Developer Guide.

Application Code - legacy
&app_code={YOUR_APP_CODE}

Substitute your own unique app_code

Application Id - legacy
&app_id={YOUR_APP_ID}

Substitute your own unique app_id

The following example query uses the HTTP GET method to request stations within 5km of a point in Berlin.


https://fuel-v2.cc.api.here.com/fuel/stations.xml
?prox=52.516667,13.383333,5000
-H "Authorization: Bearer {YOUR_TOKEN}"