Fuel Prices API Developer's Guide

Fuel Stations Response

The FuelStationsResultType structure is the top-level element in the responses to requests against the stations resource. The name of the top-level element in an XML response is FuelStationsResult.

Table 1. Response elements
Element Data Type Mandatory Description
hasMore Boolean Yes Boolean, indicates if the query has additional results that were not included in the response.

This parameter together with the offset and maxresults parameters in the query can be used for pagination.

fuelStations FuelStationsListType No List of fuel stations.

Real-time fuel prices in the response

In case the real-time prices are available for the fuel station in the response, the price is represented by the following attributes:

  • price - 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

The example in JSON format is as follows:


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

The example in XML format is as follows:


<fuelPrice lastUpdateTimestamp="2014-02-01T07:05:59.000Z" currency="EUR" unit="l" fuelType="14">
  <price>0.739</price>
  <deltaPrice>0.05</deltaPrice>
  <indexScore>3</indexScore>
</fuelPrice>

Estimated fuel prices in the response

For the stations without real prices the price is estimated. The estimated prices are represented 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

The example in JSON format is as follows:


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

The example in XML format is as follows:


<fuelPrice lastUpdateTimestamp="2014-02-01T07:05:59.000Z" currency="EUR" unit="l" fuelType="14">
  <deltaPrice>0.05</deltaPrice>
  <indexScore>3</indexScore>
  <errorMargin>0.01</errorMargin>
</fuelPrice>

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