Siri Shortcuts

Ask Siri for nearby fuel prices by voice, using the same data and ranking as the app. Install a ready-made shortcut below, or build your own in the advanced section.

Install

Fuel Top Result

Speaks the best station near you, then opens navigation to it. The one to use while driving.

Install

Say: "Fuel Top Result"

Fuel Read Results

Speaks the top three stations in ranked order. No navigation.

Install

Say: "Fuel Read Results"

Fuel Choose Result

Speaks the count, shows a numbered list, then navigates to the station you pick.

Install

Say: "Fuel Choose Result"

How it works

Tap Install. Safari downloads the shortcut file; open it in Shortcuts and tap Add Shortcut. You can also do this on your Mac: shortcuts sync to your iPhone through iCloud.
When adding, Shortcuts asks two questions: your navigation app (waze, apple or google) and your fuel (premium, 91, 95, 98, diesel, lpg, e85 or brand-diesel). The answers are saved inside the shortcut. To change them later, edit its Maps Preference or Fuel Preference text action.
The first run asks for location permission: choose Allow While Using App and keep Precise on. The prompt appears at run time, not in Settings beforehand.
Navigation needs the matching app installed (Waze, Apple Maps or Google Maps). Speaking results works without any of them.
Each run sends your device coordinates to fuel.ihogben.com to find nearby prices. Nothing else is sent, and nothing is stored.
A website cannot silently install a shortcut or enable Precise Location: the Add Shortcut step and every permission prompt are yours to approve.

Advanced: build it yourself

Customise your URLs

Pick your usual fuel, navigation app and result count. Every URL below updates live.

Fuel Maps app Results spoken

After pasting a URL into Shortcuts, insert the Latitude and Longitude magic variables from Current Location into the empty lat= and lon= values.

Shortcut: top result

Create a new shortcut and name it Fuel Top Result.
Add action: Get Current Location.
Add action: Get Contents of URL, paste the URL below, then insert the Latitude and Longitude magic variables into lat= and lon=.
Add action: Get Dictionary Value, key speech.
Add action: Speak Text.
Add action: Get Dictionary Value, key navigation_url, input Contents of URL.
Add action: If navigation_url has any value, then Open URL.

https://fuel.ihogben.com/api/voice?v=1&mode=top&lat=&lon=&maps_app=waze&fuel=premium

Shortcut: read results

Create a new shortcut and name it Fuel Read Results.
Add action: Get Current Location.
Add action: Get Contents of URL, paste the URL below, insert Latitude and Longitude.
Add action: Get Dictionary Value, key speech.
Add action: Speak Text.

https://fuel.ihogben.com/api/voice?v=1&mode=read&lat=&lon=&maps_app=waze&fuel=premium&limit=3

Shortcut: by suburb

Asks for a suburb and reads the ranked prices there. No location needed.

Create a new shortcut and name it Fuel By Suburb.
Add action: Ask for Input (text, prompt "Which suburb?").
Add action: Get Contents of URL, paste the URL below, then insert the Provided Input magic variable into the empty suburb= value.
Add action: Get Dictionary Value, key speech.
Add action: Speak Text.

https://fuel.ihogben.com/api/voice?v=1&mode=read&suburb=&maps_app=waze&fuel=premium&limit=3

About the choose shortcut

The choose-a-station flow uses a numbered chooser plus a label split that is fiddly to build by hand, so it is only offered as an install above. After adding it, open it in Shortcuts to see how it works and to change its preferences.

URL parameters (version 1)

Parameter	Values	Default
`v`	`1`	required
`mode`	`top`, `read`, `choose`	required
`lat`, `lon`	From Current Location	required (or suburb)
`suburb`	Any WA suburb, e.g. `Joondalup`	alternative to lat/lon
`fuel`	`premium`, `91`, `95`, `98`, `diesel`, `lpg`, `e85`, `brand-diesel`	`91`
`maps_app`	`waze`, `apple`, `google`	`apple`
`limit`	1 to 5	top 1, read and choose 3
`sort`	`best`, `cheapest`, `nearest`	`best`
`day`	`today`, `tomorrow`	`today`
`include_closed`	`true`, `false`	`false`

Every version 1 response is HTTP 200 with a status field (ok, empty, invalid_request or unavailable). The speech field is always present and ready to speak; navigation_url is only filled in top mode. Tomorrow's prices are published by FuelWatch at about 2:30pm AWST.