Fuel Prices API Developer's Guide

Fuel Stations Response

The FuelStationsResultType structure is the top-level element in the responses to requests for 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: 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 example 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"
  }
]

This example is in XML format:


<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.

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"
  }
]

This example is in XML format:


<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.