Overview
Points of Interest (POIs) are locations on the mobile app’s Trip Planner. These locations appear alongside standard map points and can represent any place relevant to your users (ie, fuel stops, terminals, etc.). Custom POIs may also be added that will show alongside the global POIs that are always present.
The feature is built on two concepts:
POIs: Individual data points, representing a single location
POI Layers: Filters or groups that users interact with
Each POI includes a name, address, location coordinates, and customizable categories that allow users to search and filter locations. You can also attach custom data to each POI to display additional information when a user taps on it.
How it Works
The POI feature connects your latitude and longitude location (POIs) to a user-facing toggle (POI Layer). Users do not see a list of individual POIs. Instead, they see the layers, such as “Fuel Stops” or “Terminals”.
POIs are managed through our API, allowing you to create, update, and delete locations as needed. The system is designed to handle dynamic location data, so you can keep your POIs up to date.
When a user enables a POI Layer, the app displays only the POIs that match the filter rules defined for that specific layer. This is most commonly used to filter POIs based on their assigned category.
Creating and Managing POIs
Add POIs by sending the following to the API:
Unique identifier for each POI
WARNING: You must store this identifier in your own system. You will need it as a reference for future API calls, such as updating or deleting a POI. The API does not provide a way to recover a POI's
idif it is lost.Optional latitude and longitude coordinates
Complete street address
Location name
One or more categories for filtering and searching
Optional custom data, such as operating hours, contact information, or special instructions
NOTE: If you do not specify the location coordinates, the POI will be placed at the specified address.
Categories and Search Layers
Categories make POIs discoverable. You can assign one or more category labels to each POI. Users can then use search layers to filter the map and view only POIs in specific categories.
Search layers are customizable filters that define which POIs appear based on their properties. For example, you could create a “Fuel Stops” layer that shows only POIs with a “Fuel Network” category.
Custom Information
The data field in each POI is a flexible object for any additional information you want to associate with a location. Custom content will be displayed to the driver when they tap the POI in the app. You can store custom properties in the details property such as phone numbers, gate codes, parking availability, or operational notes.
Global vs. Custom Search Layers
The app includes default “global” search layers for common locations like truck stops, rest areas, and weigh stations. These global layers are always available to users. Custom search layers always appear below the global layers but may be ordered however you prefer.