The complete solution for developers
TruckMap supports universal links, which allow any iOS or Android app to open the TruckMap app to a specific screen. The app currently supports universal links to a place (like an address or truck stop), a list of places matching a particular filter, or a route.
Note: Testing universal links by visiting this page on a mobile device and tapping the examples below may yield unpredictable results, as the TruckMap universal link domain (https://truckmap.com) matches the domain of this page. To test, you can host links on a web page accessible from your mobile device.
Place
Discussion
The app will attempt to display the detail page for a place.
URL scheme
/place/{place}
Parameters
place
: A string describing a place. Can be one of the following:- The
of a place stored on the TruckMap database.id
- A set of coordinates formatted as
.{latitude},{longitude}
- An address. The app will return its best guess based on this string.
If
place
is empty, the device's current location will be used for the search.Places
Discussion
The app will attempt to open a list of places matching the query parameters.
URL scheme
/places?type={type}&lat={lat}&lon={lon}
Parameters
type
: A slug representing the category of place. The slugs of some common categories are:truck-stop
rest-area
weigh-station
diesel-fuel
lat
: The latitude around which to search.lon
: The longitude around which to search.If
lat
and lon
are not provided, the device's current location will be used for the search.Route
Discussion
The app will attempt to create a route from all of the waypoints contained in the url, in order of appearance.
URL scheme
/route/{waypoint}/{waypoint}/...
Parameters
waypoint
: A string describing a waypoint along a route. Can be one of the following:- The
of a place stored on the TruckMap database.id
- A set of coordinates formatted as
.{latitude},{longitude}
- An address. The app will return its best guess based on this string.
- The string
. The app will substitute the user’s current location.current-location
If only one
waypoint
is specified, the app will prepend the user’s current location as the starting point.