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

    id

    of a place stored on the TruckMap database.
  • 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

    id

    of a place stored on the TruckMap database.
  • A set of coordinates formatted as

    {latitude},{longitude}

    .
  • An address. The app will return its best guess based on this string.
  • The string

    current-location

    . The app will substitute the user’s current location.
If only one

waypoint

is specified, the app will prepend the user’s current location as the starting point.