URL Scheme

URLs can be used for launching Road Trip from an external application. There are two methods available: Shortcuts and x-callback-url.

Shortcut URLs

Road Trip provides a customizable shortcuts system for creating frequently-entered fuel, expense, and trip entries. Each shortcut has a unique URL that can be used with an external application.

See the Shortcuts Page for more information.

x-callback-url

Road Trip provides an x-callback-url interface for creating fuel, expense, and trip entries programmatically from an external application.

Below is a list of available commands and parameters. The vehicle parameter is required if more than one vehicle is available in Road Trip. All other parameters are optional.

Add Fuel

Command:

addFuel

Example:

desroadtrip://x-callback-url/addFuel?vehicle=My%20Car&odometer=123456.7&fillAmount=9.432&unitPrice=1.099

Parameters:

Parameter	Type	Description
`vehicle`	Text	Vehicle Name.
`date`	YYYY-MM-DD hh:mm	Date and time. Time is optional.
`odometer`	Number	Odometer value.
`tripMeter`	Number	Trip Meter. Odometer value takes precedence.
`fillAmount`	Number	Fill amount.
`unitPrice`	Number	Price per unit (Litre/Gallon/kWh)
`cost`	Number	Total cost. `unitPrice` takes precedence.
`filled`	0/1	1=Filled Tank, 0=Unfilled Tank
`reset`	0/1	1=Reset Statistics
`tripCompEcon`	Number	Trip Computer Fuel Economy.
`tripCompSpeed`	Number	Trip Computer Average Speed.
`tripCompTemp`	Number	Trip Computer Outside Temperature.
`tripCompHours`	Number	Trip Computer Driving Time Hours.
`tripCompMins`	Number	Trip Computer Driving Time Minutes.
`fuelType`	Text	Fuel Type or Octane.
`conditions`	Text	Driving Conditions.
`payment`	Text	Payment.
`categories`	Comma-separated List	Categories.
`notes`	Text	Notes.
`locationName`	Text	Location Name.
`latitude`	Number	Location Latitude.
`longitude`	Number	Location Longitude.

Add Expense

Command:

addExpense

Example:

desroadtrip://x-callback-url/addExpense?vehicle=My%20Car&odometer=123456.7&name=Oil%20Change&cost=45.99

Parameters:

Parameter	Type	Description
`vehicle`	Text	Vehicle Name.
`date`	YYYY-MM-DD hh:mm	Date and time. Time is optional.
`odometer`	Number	Odometer value.
`name`	Text	Expense name.
`cost`	Number	Total cost.
`expenseType`	service/expense/other	Expense type.
`expenseSubtype`	Text	Expense subtype.
`payment`	Text	Payment.
`categories`	Comma-separated List	Categories.
`notes`	Text	Notes.
`locationName`	Text	Location Name.
`latitude`	Number	Location Latitude.
`longitude`	Number	Location Longitude.

Add Trip

Command:

addTrip

Example:

desroadtrip://x-callback-url/addTrip?vehicle=My%20Car&odometer=123456.7&endOdometer=123500&date=2017-6-15%209:15&endDate=2017-6-15%2015:25&name=Work

Parameters:

Parameter	Type	Description
`vehicle`	Text	Vehicle Name.
`date`	YYYY-MM-DD hh:mm	Start date and time.
`endDate`	YYYY-MM-DD hh:mm	End date and time.
`odometer`	Number	Start odometer.
`endDdometer`	Number	End odometer.
`name`	Text	Trip name.
`categories`	Comma-separated List	Categories.
`notes`	Text	Notes.