Skip to content

inRoute URL Scheme

inRoute implements a URL scheme, which allows iOS and Mac developers to expose API methods to other apps. inRoute’s URL Scheme allows sending lists of route locations to inRoute as “coordinates” or as “searches”. Routes can be created in the same order as the input locations or the waypoint order can be optimized, and routes can include up to 150/8 locations at a time (Pro/Free plans).

Coordinate Format

Specify each location with the name you want to use for the pin, and its latitude & longitude. To optimize the waypoint order after import, use the keyword “action=opt” preceding the route location list (at least 4 route locations are required for optimization to have an effect):

inroute://coordinates?action=opt&loc={name 1}/{latitude 1}/{longitude 1}&loc={name 2}/{latitude 2}/{longitude 2}

An example with two locations:

inroute://coordinates?action=opt&loc=Lazy K’s/47.648434/-121.914307&loc=Greek Food/47.739555/-121.985924

To pass these two locations to inRoute, percent encode the string:

inroute://coordinates?action=opt&loc=Lazy%20K’s/47.648434/-121.914307&loc=Greek%20Food/47.739555/-121.985924

Note: Each additional location is added with “&loc={name i}/{latitude i}/{longitude i}”

Search Format

Specify each location with the name you want to use for the pin, and a search term used to find the location (address or place name). To optimize the waypoint order after import, use the keyword “action=opt” preceding the route location list (at least 4 route locations are required for optimization to have an effect):

inroute://searches?action=opt&loc={name 1}/{search term 1}&loc={name 2}/{search term 2}

An example with two locations; the first a search using a place name, and the second a search based on an address:

inroute://searches?action=opt&loc=Lazy K’s/Lazy K’, Carnation WA 98014&loc=Greek Food/15410 Main St NE, Duvall WA 98019

To pass these two locations to inRoute, percent encode the string:

inroute://searches?action=opt&loc=Lazy%20K’s/Lazy%20K’,%20Carnation%20WA%2098014&loc=Greek%20Food/15410%20Main%20St%20NE,%20Duvall%20WA%2098019

Note: Each additional location is added with “&loc={name i}/{search term i}”

View a map pin at specified coordinates

Use the “view” command and specify the latitude and longitude for the pin:

inroute://view?geo={latitude},{longitude}

For example:

inroute://view?geo=48.8582,2.2946

Navigate to a map pin at specified coordinates

Use the “route” command and specify the latitude and longitude for navigation:

inroute://route?geo={latitude},{longitude}

For example, 

inroute://route?geo=48.8582,2.2946

Return to Caller

If a “back_url” is provided in any of the above URL schemes to open inRoute, corresponding to the URL scheme of the sending app, the Escape key can be used within inRoute to return to that app:

inroute://&back_url={sending app}://