INRIX documentation logo

The INRIX Fuel Station Service returns data about fuel stations. It can be used to find stations in a specified area, and includes information such as price, fuel type, and location.

Overview

To find fuel stations using the INRIX Fuel Station Service, you can use the APIs that return fuel stations in a specified area. This will return a list of fuel stations, with IDs, along with other information about each station. The main usage scenarios are:

Response Data

The INRIX Fuel Station API requests return information about fuel stations, such as:


Description: Gets price, services offered, and location data for fuel stations in a specified region.

fuel-api.inrix.com/v1/fuelStations

GET Gets price, product, and location data for fuel stations in a specified region.

Parameters

  = required
Name Located In Type Description
accesstoken Query String A valid access token provided from the GET appToken API response. Alternatively, the accesstoken can be added to the request header instead of a url parameter using format 'Authorization: Bearer xxxx.xxx.xxxx'.
box Query String “box” specifies two latitude and longitude pairs (using the WGS 84 datum) that outline a bounding box. The first lat/long pair should be the northwestern most point, and the second pair the southeastern most point. Format- [lat1]|[long1],[lat2]|[long2]. Either box or point and radius parameters are required.
point Query String Used to select a region based on a point and radius. If used, other Location parameters cannot be used. Format- [lat]|[long]. Either box or point and radius parameters are required.
radius Query Double Used to select a region based on a point and radius in meters. If used, other Location parameters cannot be used. Either box or point and radius parameters are required.
producttype Query String The type of fuel product. Multiple product types can be specified in a comma-delimited list.
Value Description
(empty) (default) Return all fuel product types
Biodiesel A fuel used in diesel engines, and made of vegetable oil or animal fat
Diesel Diesel fuel
Dieselplus A diesel fuel with special additives to improve performance
Regular Regular grade gasoline
MidGrade Middle grade gasoline
Premium Premium grade gasoline
E85 E85 Ethanol/gasoline mixture
LPG LPG (liquid petroleum gas, usually propane, also called Autogas)
Methane Natural gas (also called Compressed Natural Gas, or CNG)
normal Leaded gasoline
SP92 Unleaded gasoline, with a 92 octane rating
SP95 Unleaded gasoline, with a 95 octane rating
SP95_E10 Unleaded gasoline, with a 95 octane rating and 10% ethanol
SP98 Unleaded gasoline, with a 98 octane rating
truckdiesel A diesel fuel used by trucks
outputfields Query String List of requested outputfields
Value Description
All Returns all output fields including currency code and services
Brand The brand name of the station
LatLong The latitude and longitude of the station
Address The address of the station (includes Name, Address, City, State, ZipCode, and PhoneNumber)
Products The fuel product types carried by the station
CurrencyCode The currency code for the price value
locale Query String The locale the openingHours text should be returned in. Use the 2 digit ISO 639-1 language codes (es, de, en, etc)
searchName Query String The name or brand of the fuel station to filter the results
adbluetype Query String A comma delimited list of adBlue services to omit from the results
count Query Integer The maximum number of results returned

Requests

Example Get station in radius request
Query
https://fuel-api.inrix.com/v1/fuelstations/?point=47.61121|-122.32538&radius=2&accesstoken={token}

Responses

200 Success
{
    "copyright": "Copyright INRIX Inc. 2017",
    "versionNumber": "v1",
    "createdDate": "2017-05-18T20:21:36.6785643Z",
    "responseId": "4f0bd203-38b7-44da-8e01-49102201d1a5",
    "result": [
        {
            "id": 260721,
            "name": "Shell",
            "country": "US",
            "address": "1500 Broadway",
            "city": "Seattle",
            "state": "WA",
            "zipCode": "98122",
            "brand": "Shell",
            "phoneNumber": "+12063240919",
            "geometry": {
                "coordinates": [
                    -122.3207144,
                    47.6140873
                ],
                "type": "Point"
            },
            "highway": "0",
            "openingHours": "Mon-Sun: 24 Hours",
            "products": [
                {
                    "type": "Regular",
                    "price": 3.099,
                    "updateDate": "2017-05-17T13:43:00",
                    "currencyCode": "USD"
                },
                {
                    "type": "MidGrade",
                    "price": 3.399,
                    "updateDate": "2017-05-12T09:35:00",
                    "currencyCode": "USD"
                },
                {
                    "type": "Premium",
                    "price": 3.359,
                    "updateDate": "2017-05-17T12:48:25",
                    "currencyCode": "USD"
                }
            ],
            "services": [
                {
                    "service": "Automated teller machine"
                },
                {
                    "service": "Grocery store"
                },
                {
                    "service": "Convenience store"
                }
            ]
        },
        {
            "id": 293031,
            "name": "Arco",
            "country": "US",
            "address": "665 23Rd Ave",
            "city": "Seattle",
            "state": "WA",
            "zipCode": "98122",
            "brand": "Arco",
            "phoneNumber": "+12068602171",
            "geometry": {
                "coordinates": [
                    -122.3028,
                    47.60779
                ],
                "type": "Point"
             },
            "highway": "0",
            "openingHours": "Mon-Sun: 24 Hours",
            "products": [
                {
                    "type": "Regular",
                    "price": 3.099,
                    "updateDate": "2017-05-17T08:27:00",
                    "currencyCode": "USD"
                },
                {
                    "type": "MidGrade",
                    "price": 3.199,
                    "updateDate": "2017-05-12T01:47:00",
                    "currencyCode": "USD"
                },
                {
                    "type": "Premium",
                    "price": 3.299,
                    "updateDate": "2017-05-12T01:47:00",
                    "currencyCode": "USD"
                }
            ],
            "services": [
                {
                    "service": "Automated teller machine"
                },
                {
                    "service": "Grocery store"
                },
                {
                    "service": "Convenience store"
                }
            ]
        }
    ]
}

Response Elements

Property Type Description
id Double Unique ID of the station
name String Station name
country String Name of the country
address String Street Address
city String City
state String State or province
zipCode String Zip or postal code
phoneNumber String Phone number
brand String Brand of the station
geometry Geojson Latitude and Longitude of station in geoJSON format. Note this is long first then lat.
openingHours String Hours the station is open. This can be localized to a particular language by using the locale request parameter.
products Array List of types of fuel and prices for the station
Property Type Description
type String The type of fuel such as Diesel, Regular, MidGrade, Premium, etc.
price Double Price of the fuel product. Units (per gallon or liter) of the price is based on the location of the gas station.
updateDate String The date and time that the price data was last verified.
currencyCode String The 3 letter (ISO 4217) currency code for the price value.
services Array Car wash, Car wash with booking, Jet wash, Tyre air line, Parking for trailers, Domestic gas sale point, Kerosene, Grocery store, Convenience store, Food to go, Food to stay, Bar, Automated teller machine, Public WC, Public shower, Laundry service, Baby changing room, Mail Box, Car repair, Clean rating, Wood for fire, Delivery point, Sale of phone cards, Adblue

/v1/fuelStations/{id}

GET Get information about a single fuel station

Parameters

  = required
Name Located In Type Description
accesstoken Query String A valid access token provided from the GET appToken API response. Alternatively, the accesstoken can be added to the request header instead of a url parameter using format 'Authorization: Bearer xxxx.xxx.xxxx'.
id Path Integer A single fuel station ID
producttype Query String The type of fuel product. Multiple product types can be specified in a comma-delimited list
Value Description
(empty) (default) Return all fuel product types
Biodiesel A fuel used in diesel engines, and made of vegetable oil or animal fat
Diesel Diesel fuel
Dieselplus A diesel fuel with special additives to improve performance
Regular Regular grade gasoline
MidGrade Middle grade gasoline
Premium Premium grade gasoline
E85 E85 Ethanol/gasoline mixture
LPG LPG (liquid petroleum gas, usually propane, also called Autogas)
Methane Natural gas (also called Compressed Natural Gas, or CNG)
normal Leaded gasoline
SP92 Unleaded gasoline, with a 92 octane rating
SP95 Unleaded gasoline, with a 95 octane rating
SP95_E10 Unleaded gasoline, with a 95 octane rating and 10% ethanol
SP98 Unleaded gasoline, with a 98 octane rating
truckdiesel A diesel fuel used by trucks
outputfields Query String List of requested outputfields
Value Description
All Returns all output fields including currency code and services
Brand The brand name of the station
LatLong The latitude and longitude of the station
Address The address of the station (includes Name, Address, City, State, ZipCode, and PhoneNumber)
Products The fuel product types carried by the station
CurrencyCode The currency code for the price value
locale Query String The locale the openingHours text should be returned in
searchName Query String The name or brand of the fuel station to filter the results
adbluetype Query String A comma delimited list of adBlue services to omit from the results
count Query Integer The maximum number of results returned

Requests

Example Get station request
Query
https://fuel-api.inrix.com/v1/fuelstations/321746?accesstoken={token}

Responses

200 Success
{
    "copyright": "Copyright INRIX Inc. 2017",
    "versionNumber": "v1",
    "createdDate": "2017-05-18T20:44:42.7383987Z",
    "responseId": "97dc3fad-25d1-46ac-bb83-826a36bf5a49",
    "result": {
        "id": 321746,
        "name": "Shell",
        "country": "US",
        "address": "1500 Broadway",
        "city": "Seattle",
        "state": "WA",
        "zipCode": "98122",
        "brand": "Shell",
        "phoneNumber": "+12063240919",
        "geometry": {
            "coordinates": [
                -122.3207144,
                47.6140873
            ],
            "type": "Point"
        },
        "highway": "0",
        "openingHours": "Mon-Sun: 24 Hours",
        "products": [
            {
                "type": "Regular",
                "price": 3.099,
                "updateDate": "2017-05-17T13:43:00",
                "currencyCode": "USD"
            },
            {
                "type": "MidGrade",
                "price": 3.399,
                "updateDate": "2017-05-12T09:35:00",
                "currencyCode": "USD"
            },
            {
                "type": "Premium",
                "price": 3.359,
                "updateDate": "2017-05-17T12:48:25",
                "currencyCode": "USD"
            }
        ],
        "services": [
            {
                "service": "Automated teller machine"
            },
            {
                "service": "Grocery store"
            },
            {
                "service": "Convenience store"
            }
        ]
    }
}

Response Elements

Property Type Description
id Double Unique ID of the station
name String Station name
country String Name of the country
address String Street Address
city String City
state String State or province
zipCode String Zip or postal code
phoneNumber String Phone number
brand String Brand of the station
geometry Geojson Latitude and Longitude of station in geoJSON format. Note this is long first then lat.
openingHours String Hours the station is open. This can be localized to a particular language by using the locale request parameter.
products Array List of types of fuel and prices for the station
Property Type Description
type String The type of fuel such as Diesel, Regular, MidGrade, Premium, etc.
price Double Price of the fuel product. Units (per gallon or liter) of the price is based on the location of the gas station.
updateDate String The date and time that the price data was last verified.
currencyCode String The 3 letter (ISO 4217) currency code for the price value.
services Array The services offered by the station which could include one or more of the following - Car wash, Car wash with booking, Jet wash, Tyre air line, Parking for trailers, Domestic gas sale point, Kerosene, Grocery store, Convenience store, Food to go, Food to stay, Bar, Automated teller machine, Public WC, Public shower, Laundry service, Baby changing room, Mail Box, Car repair, Clean rating, Wood for fire, Delivery point, Sale of phone cards, Adblue