Road Trip
for iPhone, iPod touch, and iPad
Home Features Screenshots Support User Manual CSV Data Import Tool
User Manual > URL Scheme
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:

ParameterTypeDescription
vehicleTextVehicle Name.
dateYYYY-MM-DD hh:mmDate and time. Time is optional.
odometerNumberOdometer value.
tripMeterNumberTrip Meter. Odometer value takes precedence.
fillAmountNumberFill amount.
unitPriceNumberPrice per litre or gallon.
costNumberTotal cost. unitPrice takes precedence.
filled0/1Filled Tank.
reset0/1Reset Statistics.
tripCompEconNumberTrip Computer Fuel Economy.
tripCompSpeedNumberTrip Computer Average Speed.
tripCompTempNumberTrip Computer Outside Temperature.
tripCompHoursNumberTrip Computer Driving Time Hours.
tripCompMinsNumberTrip Computer Driving Time Minutes.
fuelTypeTextFuel Type or Octane.
conditionsTextDriving Conditions.
paymentTextPayment.
categoriesComma-separated ListCategories.
notesTextNotes.
locationNameTextLocation Name.
latitudeNumberLocation Latitude.
longitudeNumberLocation Longitude.

Add Expense

Command:

addExpense

Example:

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

Parameters:

ParameterTypeDescription
vehicleTextVehicle Name.
dateYYYY-MM-DD hh:mmDate and time. Time is optional.
odometerNumberOdometer value.
nameTextExpense name.
costNumberTotal cost.
expenseTypeservice/expense/otherExpense type.
expenseSubtypeTextExpense subtype.
paymentTextPayment.
categoriesComma-separated ListCategories.
notesTextNotes.
locationNameTextLocation Name.
latitudeNumberLocation Latitude.
longitudeNumberLocation 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:

ParameterTypeDescription
vehicleTextVehicle Name.
dateYYYY-MM-DD hh:mmStart date and time.
endDateYYYY-MM-DD hh:mmEnd date and time.
odometerNumberStart odometer.
endDdometerNumberEnd odometer.
nameTextTrip name.
categoriesComma-separated ListCategories.
notesTextNotes.

(c) 2008-2022 Darren Stone