Returns aggregated (rolled up) values computed from AI features.

post

https://api.nearmap.com/ai/features/v4/surveyresources/{surveyResourceId}/rollups.csv

Returns aggregated (rolled up) values computed from all AI features
within the given survey resource and polygon.

Either the polygon or all geocoding address related query
parameters (but not both) must be provided.

Operates semantically the same way as the GET variant
but allows the polygon parameter and classes to be passed inside the request body
rather than as a query parameter. This may be required for polygons and classes
whose representations are large, in order to avoid URL length
limitations.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Returns aggregated (rolled up) values computed from all AI features within the given survey resource and polygon.Either the polygon or all geocoding address related query parameters (but not both) must be provided.Operates semantically the same way as the GET variant but allows the polygon parameter to be passed inside the request body rather than as a query parameter. This may be required for polygons whose representations are large, in order to avoid URL length limitations.

Path Params

surveyResourceId

string

required

The ID of the survey resource to fetch AI data from.

Query Params

polygon

string

Represents the Area Of Interest (AOI) to query against. It is depicted
by a set of points (longitude/latitude pairs) where the first and last
point must be the same. The polygon must not self-intersect.

It cannot be used with the address geocoding parameters
(streetAddress, city, state, zip and country), or with an
aoi defined in the request body for the HTTP POST variant endpoints.

Must be omitted when TXv3 token authorization is used.

bulk

boolean

Defaults to false

Bulk determines whether if the request is part of a large batch of
requests, meaning requests will not be rate-limited.

packs

string

Packs accepts a list of comma-separated product packs. This returns
specific features and attributes under the pack. The response will
return all features and attributes that the user is entitled to if no
packs are provided.

It cannot be used with the classes query parameter. This parameter is
ignored if used with an empty value.

classes

string

Classes accepts a list of comma-separated feature class IDs. Features
classes not requested will be filtered out of the response. The full
list of available feature classes can be obtained by using the
classes.json endpoint (Feature class IDs are in the id field for
classes of type Feature). The response will include all feature
classes that the user is entitled to if the query parameter is not
specified.

It cannot be used with the packs query parameter. This parameter is
ignored if used with an empty value.

streetAddress

string

The street address for a geocoded request. Should consist of the street
number, street name, and street type.

It cannot be used with the polygon query parameter.

Must be omitted when TXv3 token authorization is used.

city

string

The city, suburb, or locality for a geocoded request.

It cannot be used with the polygon query parameter.

Must be omitted when TXv3 token authorization is used.

state

string

The two-letter state code for a geocoded request.

It cannot be used with the polygon query parameter.

Must be omitted when TXv3 token authorization is used.

zip

string

The five-digit ZIP code or nine-digit ZIP+4 code for US addresses or the
four-digit postal code for AU addresses for a geocoded request.

It cannot be used with the polygon query parameter.

Must be omitted when TXv3 token authorization is used.

country

string

enum

The two-letter country code for the geocoded request. Only supports US
and AU. Defaults to US when geocoding is used without supplying the
country code.

It cannot be used with the polygon query parameter.

Must be omitted when TXv3 token authorization is used.

Allowed:

alpha

boolean

Defaults to false

When set to true, causes alpha classes to be included in results.

beta

boolean

Defaults to false

When set to true, causes beta classes to be included in results.

Body Params

aoi

object

A GeoJSON object representing the requested AOI. Must be a
GeoJSON polygon with no interior rings.

It cannot be used with the polygon query parameter.

classes

array of strings

Classes accepts a list of class IDs. Features
classes not requested will be filtered out of the response. The full
list of available feature classes can be obtained by using the
classes.json endpoint (Feature class IDs are in the id field for
classes of type Feature). The response will include all feature
classes that the user is entitled to if the query or body parameter is not
specified.

It cannot be used with the packs query parameter. This parameter is
ignored if used with an empty value.
It cannot be used with the classes query parameter.

classes

Headers

X-Nearmap-Ext-Reference

string

Allows a reference string to be echoed back opaquely in the body of the response.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200OK response to the rollups.csv endpoint.

400Bad Request. There was a problem with the request parameters.

401Unauthorized

403Forbidden

404Not Found. No data is available matching the request criteria.