Start POI summary job

Creates a job to generate a POI summary analysis. Aggregates vehicle stop statistics per point-of-interest location, providing counts, average dwell times, and vehicle class breakdowns.

Altitude Help Center — POI Location Specific Insights API

Request Body

POI analysis parameters.

application/json: object

Name	Type	Input Shape	Values	Description	Value Required
`dateFrom`	string	-	-	First date of the analysis range, formatted as yyyy-mm-dd.	Y
`dateTo`	string	-	-	Last date of the analysis range (inclusive), formatted as yyyy-mm-dd.	Y
`isMetric`	boolean	-	false	POI Summary currently supports imperial units only. Set this to false.	Y
`locationIds`	array<string>	-	-	List of location ids returned from the locations endpoint	Y
`naicsLevel2`	array<integer (int64)>	-	-	NAICS Level-2 industry codes to include. An empty array includes all licensed industries.	N
`radius`	number (double)	-	-	Capture radius around each POI in miles. POI Summary currently supports imperial units only. Vehicles stopping within this radius are attributed to the POI.	Y

Examples

POI summary from discovered locations

Use the numeric id returned by the preceding POI Locations request.

{
  "dateFrom": "2026-01-01",
  "dateTo": "2026-01-31",
  "isMetric": false,
  "locationIds": [
    "-1003048895383462315"
  ],
  "naicsLevel2": [
    445,
    447
  ],
  "radius": 25
}

Success Responses

202 response: object

Job accepted and queued for processing. Poll the location header URL to check status.

Name	Type	Description
`error`	object	Details about why the job failed (RFC 7807 format), or null if it succeeded.
`id`	string	Unique job identifier.
`links`	object	Navigation URLs for polling and result retrieval.
`status`	string	Current job lifecycle state: PENDING, QUEUED, RUNNING, DONE, FAILED, CANCELED, or NOT_FOUND.

Response Errors

HTTP Status Code	Reason
400	The request body or parameters are invalid.
401	Authentication is required or the provided credentials are invalid.
403	The authenticated user lacks permission to perform this operation.
409	The operation conflicts with the current state of the resource.
422	The request is syntactically valid but semantically cannot be processed.
429	The request rate limit has been exceeded.
500	An unexpected server error occurred.