POI Location Specific Insights API

(POI LSI) is an Altitude module that enables operators to evaluate the competitive landscape around any specific location using first-party commercial vehicle telematics.

What is POI Location Specific Insights?

Given a location and a radius, POI LSI returns all competitor points of interest (POIs) within that radius, including brand names, stop counts, dwell-time distribution, vehicle class, vocation, fleet size, and fuel type, so operators can benchmark a site against its competitive environment using the same commercial vehicle data that powers Altitude's Stop Analytics module.

POI LSI is purpose-built for site-level analysis. Every query is anchored to a specific location and bounded by a radius. The module does not support brand-level national queries or corridor-based analysis in Phase 1.

Methodology

POI LSI uses Altitude's POI location data to identify competitor points of interest, and Altitude's commercial vehicle telematics to supply the stop-event metrics at each location. Stop events are attributed to POIs using an anchor-tenant model over purpose-built site catchments. Roughly 40-50% of commercial vehicle stops are attributed to a specific POI, with the remainder occurring at private and non-POI destinations. For the full explanation, see the POI LSI Methodology page in the User Guide.

Endpoints

getPointsOfInterest

getPointsOfInterest returns all POI locations within the database's contracted categories and purchased geographies.

MethodEndpointDescription
POST/api/v2/poi/locationsStart a points of interest job.
GET/api/v2/poi/locations/{id}Retrieve points of interest results.

getPOISummary

getPOISummary returns a lightweight competitor list around an anchor POI: brand names, location count, competitor density, and coordinates.

MethodEndpointDescription
POST/api/v2/poi/summaryStart a POI summary job.
GET/api/v2/poi/summary/{id}Retrieve POI summary results.

getPOIAnalytics

getPOIAnalytics returns full commercial vehicle metrics for all POI locations within a radius around an anchor location, including stop count, dwell-time distribution, vehicle class, vocation, fleet size, and fuel type.

MethodEndpointDescription
POST/api/v2/poi/analyticsStart a POI analytics job.
GET/api/v2/poi/analytics/{id}Retrieve POI analytics results.
GET/api/v2/poi/analytics/{id}/time-seriesRetrieve time-series results for a POI analytics job.