GuidesAPI Reference
Guides

Fuel stations response

The FuelStationsResultType structure is the top-level element in the responses to requests for the stations resource.

ElementData TypeMandatoryDescription
hasMoreBooleanYesBoolean, indicates if the query has additional results that weren't included in the response. This parameter together with the offset and maxresults parameters in the query can be used for pagination.
fuelStationsFuelStationsListTypeNoList of fuel stations.

Real-time fuel prices in the response

If the real-time prices are available for the fuel station in the response, the following attributes represent the price:

  • price: The reported price for the fuel.
  • deltaPrice: The difference between the price and the price for the cheapest station/fuel type pair for the specified geometry.
  • indexScore: The relative ranking of the fuel station for the specified area.

This sample is in JSON format:

"fuelPrice": [
 {
  "price": 0.739,
  "deltaPrice": 0.05,
  "indexScore": 3,
  "fuelType": "14",
  "unit": "l",
  "currency": "EUR",
  "lastUpdateTimestamp": "2014-02-01T07:05:59.000Z"
 }
]

Estimated fuel prices in the response

For the stations without real prices use price estimates. The estimated prices are in the response with:

  • deltaPrice: The difference between the price, and the price for the cheapest station/fuel type pair for the specified geometry.
  • indexScore: The relative ranking for the fuel station for the specified area.
  • errorMargin: The difference between estimated and real-time prices averaged over all reported fuel prices for the specified fuel type and for this particular station.

This example is in JSON format:

"fuelPrice": [
  {
    "deltaPrice": 0.05,
    "indexScore": 3,
    "errorMargin": 0.01,
    "fuelType": "14",
    "unit": "l",
    "currency": "EUR",
    "lastUpdateTimestamp": "2014-02-01T07:05:59.000Z"
  }
]

For more information about the price representation in the responses, refer to FuelPriceType.