POI Location Specific Insights
This page defines the data fields returned by the POI Location Specific Insights API endpoints.
For parameter definitions (inputs to the API), see the individual endpoint API Guide pages.
NAICS classification
POI LSI organizes competitor locations by category at North American Industry Classification System (NAICS) Level 2 (Subsector). Category is a required parameter in all POI LSI queries; the module does not support open-ended queries across all industries. Licensed categories are defined per database in the poiNaicsAllowed field returned by getDatabaseInfo. Category matching for competitor identification applies the same category to the anchor and all competitors: a query anchored on a gas station returns other gas stations within the radius, not restaurants or convenience-only retailers.
A gas-station query automatically includes convenience stores that sell fuel (for example, 7-Eleven, Circle K), not just standalone gas stations, so you capture the full set of fuel competitors without adding a separate category. This is applied automatically; no change to your input is needed.
Attribution model
Stop events are attributed to POI locations using an anchor-tenant model, applied only when GPS trace, dwell time, and proximity align. At sites with multiple businesses sharing a physical lot, stops are attributed to the dominant business type at that site. Roughly 40-50% of commercial vehicle stops are attributed to a specific POI; the remainder occur at private facilities, construction, staging areas, and other non-POI destinations. Attribution is applied consistently across the anchor POI and all competitors in a query.
Dwell-time bins
Stop duration is reported in six fixed bins. Bin boundaries are in minutes and inclusive of the upper bound:
|
Bin notation |
Range (minutes) |
|---|---|
|
(0-5] |
0 to 5, inclusive of upper bound |
|
(5-15] |
Greater than 5 to 15 |
|
(15-45] |
Greater than 15 to 45 |
|
(45-120] |
Greater than 45 to 120 |
|
(120-480] |
Greater than 120 to 480 |
|
(480-inf] |
Greater than 480 (unbounded) |
POI LSI uses fixed bin definitions that cannot be customized.
tradeAreaStopCountTotal
The total attributed stop count across all POI locations within the queried radius. This value is the same for every row in the response; it represents the full competitive pool, not any individual location. Divide a location's stopCount by tradeAreaStopCountTotal to compute trade area stop share. The API does not return this pre-computed ratio; customers compute it client-side.
Privacy suppression
POI LSI applies a privacy suppression threshold at the POI level. Locations that do not meet the minimum vehicle count and customer count thresholds are suppressed from the response. This applies to both anchor POIs and competitor locations within the radius. Suppressed locations do not appear in the response and are not counted in competitorDensity.
Time series aggregation units
Time series data is available at four aggregation levels when generateTimeSeries = true:
|
aggregationUnit value |
aggregationValue range |
Description |
|---|---|---|
|
month |
1-12 |
Calendar month number. |
|
week |
Date string |
Start-of-week date for this observation. |
|
dayofweek |
1-7 |
Day of week (1 = Sunday, 7 = Saturday). |
|
hour |
0-23 |
Hour of day in 24-hour format. |
DayOfWeek is the recommended default (always 7 complete buckets). Month and week are chronological, so data gaps appear as missing buckets rather than nulls.
aggregationUnit values are lowercase in both requests and responses: month, week, dayofweek, hour.
Point geometry exclusions
POI locations with point geometries, including EV charging stations, ATMs, bus stops, and collection points, are excluded from the POI LSI pipeline by default. These locations do not generate catchment areas for attribution and are not returned as competitors in the response. This exclusion is applied at the data layer and does not require any filter parameter in the API call.
