/v2 /events/{eventId}/latest.geojson

post

https://api.nearmap.com/ai/damage/v2/events/{eventId}/latest.geojson

Retrieves the latest damage assessment for a specific event, filtered by area of interest or address.
The event ID is the postCatEventId tag on the surveys returned by the Coverage API.
Send either 'aoi' or 'address', not both.
Results are paged. If more results are available, the response includes nextCursor. Send the same
request again with that value as 'cursor', and stop when no nextCursor is returned.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

eventId

uuid

required

Unique identifier for the event. This is the postCatEventId tag value from the Coverage API.

Body Params

Object 1
Object 2

aoi

required

Area of interest as a GeoJSON Polygon or MultiPolygon geometry. Coordinates are longitude, latitude. Each ring must be closed, have at least four positions and not cross itself. Holes and 3D coordinates are accepted.

GeoJSONPolygon
GeoJSONMultiPolygon

address

object

Physical address for parcel-based damage assessment.

cursor

string

Pagination cursor. Omit it on the first request. For later pages, send the nextCursor value from the previous response, with the same request (the same aoi or address) that produced it.

limit

integer

≥ 1

Defaults to 1000

Maximum number of features per page (default 1000, minimum 1). No maximum is enforced.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/plain

*/*

200Successful response with a GeoJSON FeatureCollection. If the area has no buildings in the event, features is empty.

400Bad request - validation error. The code is one of BAD_AOI_ADDRESS, BAD_AOI, BAD_ADDRESS or BAD_REQUEST_BODY.

401Unauthorized - the API key is missing or not valid. The body is plain text.

403Forbidden. Either the key has no entitlement to this API, or the area has no coverage for you. Both cases return the same body.

404Not found. The event ID is unknown, no parcel was found for the address, or no result exists yet for the event.

429Too many requests. Slow down and retry.

500Internal server error. The body is plain text.

503Service unavailable. If the geocoder rate limit is exceeded, the body is JSON. If a load balancer or the orchestrator returns this status, the body is plain text.