GuidesAPI Reference
API Reference

Fuel stations search

get
https://fuel-v2.cc.api.here.com/fuel/stations

Retrieves fuel stations within geospatial area

Query Params
string

A circular search area defined by the latitude and longitude of its center (compliant with WGS 84) and an integer representing the radius of the area in meters, all separated by commas.

string

Bounding box defined by the latitude and longitude (compliant with WGS 84) of its top left and bottom right corners. The top left and bottom right pairs are separated by a semicolon and the latitude and longitude pairs are separated by commas.

string

A strip defined as a semicolon-separated list of points (pairs of comma-separated latitude and longitude WGS 84

int32
Defaults to 5000

The width of the corridor in meters. This parameter takes effect only if corridor are included in the request.

int32

An integer identifying the fuel type or category included in the response. Available types (all can be retrieved from /fuel/fueltypes endpoint):

Fuel type IDName
-1All Truck Diesel
-2All Diesel
-3All Petrol"
-4All LPG
-5All CNG
-6All Ethanol
-7All Methanol
-8All Additives
1Diesel
2Regular
3Mid-grade
4Premium
5E-85
6Bio-Diesel
7Bio-Diesel 10
8Bio-Diesel 15
9Bio-Diesel 20
10Diesel plus
11Truck-Diesel
12Red-Diesel
13E-10
14LPG-GLP
15LRP
16Methane
17Midgrade-self
18Diesel-self
19AdBlue
20V-Power-95
21CNG
22Ethanol
23Ethanol w. additives
24GPL self
25Premium self
26Leaded Four
27Super Unleaded
28Super Unleaded Ultimate
29Diesel-plus self
30Methanol self
31Mid-grade E10
32Super-Diesel
33Unleaded E5
34Unleaded E25
35Unleaded
36Unleaded 91
37Unleaded 93
38Unleaded 97
39Unleaded 99
40Unleaded 100
41Unleaded 102
42Methanol
43Unleaded E10
44Shell V-Power Racing
45Shell V-Power 100
46Shell V-Power Diesel
47Aral Ultimate 102
48Aral Ultimate Diesel
49BP Ultimate Super
50BP Ultimate Diesel
51Blue One 95
52Diesel Cleanline
53Super E5
54Super E10
55Premium Diesel
56Unleaded 95
57Simple gasoline
58Simple diesel
59Super Unleaded 98
60Unleaded 98
61Premium gasoline
62Synergy Supreme+ Diesel
63Supreme Diesel
64Unleaded 92
65Unleaded 80
66Super Unleaded 95
67Super Unleaded 92
68LNG
69Super E5 Premium
70Heating oil
71AdBlue Car
72AdBlue Truck
73Hydrotreated vegetable oil
74Hydrogen
75E-85 cash (US ONLY)
76Diesel cash (US ONLY)
77Mid-grade cash (US ONLY)
78Regular cash (US ONLY)
79Regular clear - without ethanol (US ONLY)
80Premium cash (US ONLY)
81Two stroke petrol
82Unleaded 87
83Unleaded 89
84GTL - Gas to liquid fuel
85HVO 30 - Diesel with 30% of hydrotreated vegetable oil
86Premium Diesel cash
87Red-Diesel cash
88Bio-Diesel 20 cash
89Super E15
90Heating oil cash
91AdBlue cash
92AdBlue Truck cash
93Bio-Diesel cash
94Bio-Diesel 10 cash
95LPG-GLP cash
96CNG cash
97Truck Diesel cash
int32
Defaults to 50

The maximum number of results a response can contain. This parameter together with the offset parameter in the query and HasMore in the response can be used for pagination.

int32
Defaults to 0

A value specifying the index of the first result. This parameter together with the maxresults parameter in the query and HasMore in the response can be used for pagination.

string
enum

Criteria for sorting a list of search results.

Allowed:
string
enum

The sort order of the results.

Allowed:
brand
array of strings

| List of brands to filter the stations in the response. The brand names in the list are separated with commas. The result will contain only the stations that have brand field that match to the one of those specified in the list. The matching is caseinsensitive. List of brands can be retireved using /fuel/fuelbrands endpoint

brand
boolean
Defaults to false

Also fuel stations with unknown price or fuel type information will be included in the result set. This parameter works together with fueltype parameter.

string

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

Headers
string

User-provided token that can be used to trace a request or a group of requests sent to the service.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 2 months ago

Language
Credentials
Bearer
JWT
URL
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 2 months ago