Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Inroute Has Now Come Closer to the Maps App with Volition I've Always Envisioned #381

Open
extratone opened this issue May 21, 2023 · 1 comment
Assignees
Labels
big Feature-length, beauty-bitch type shit. documentation Improvements or additions to documentation i On iOS & iPhone. (Subject)

Comments

@extratone
Copy link
Owner

No description provided.

@extratone extratone added the legacy The oldest content. label May 21, 2023
@extratone extratone self-assigned this May 21, 2023
@extratone extratone changed the title InRoute has now come closer to the Maps app with volition I've always envisioned Inroute Has Now Come Closer to the Maps App with Volition I've Always Envisioned May 21, 2023
@extratone extratone added documentation Improvements or additions to documentation i On iOS & iPhone. (Subject) big Feature-length, beauty-bitch type shit. and removed legacy The oldest content. labels May 21, 2023
@extratone
Copy link
Owner Author

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}://

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
big Feature-length, beauty-bitch type shit. documentation Improvements or additions to documentation i On iOS & iPhone. (Subject)
Projects
Status: Documentation
Development

No branches or pull requests

1 participant