Create Custom POI

The create Custom POI endpoint can be used to generate custom POIs by specifying the unique polygons to analyze.
The Custom POI can be generated by either specifying the combination of centroid (lng, lat) and mile radius to draw the POI's area, or by using GEOJson which includes a list of all polygon GEO points (lng, lat).
This endpoint runs duplication checks on each call in order to ensure that the same Custom POI is not created more than once. If a Custom POI is already created the return code will display a wrong request (http-code=400) specifying the previously created API ID.
Please be aware that creating custom POIs might take longer than 30 seconds, which falls within the timeout window. During such occurrences, the HTTP response code will be 202 (i.e., In progress), along with the apiId of the partially created POI. You can monitor the creation status by querying the Get Custom POI endpoint.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Creating Custom POI by given name, sub category and polygon/centroid + radius

string
required
string
required
string

The Id of the tag that the Custom POI is requested to be associated with. If no value is provided, the new POI will not be associated with any tag.

centroid
array of floats

List of 2 values that represents the GEO location of the POI center

centroid
float
0.007 to 0.21
Defaults to 0.1

Radius (in miles) with which the polygon is constructed when the center of the polygon is the centroid

polygon
array of arrays of floats

List of pairs ([lng, lat]) that represents the POI polygon

polygon
address
object
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json