NEnearmap
Damage Conflation

/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.

post/events/{eventId}/latest.geojson

Request

  • Base URL
    https://api.nearmap.com/ai/damage/v2
  • URL
    https://api.nearmap.com/ai/damage/v2/events/{eventId}/latest.geojson
  • Auth
    • API key in query parameter apikey
    • or API key in header Authorization

Path parameters

eventIdstring uuid required

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

Request body

OR

Example request

{
  "address": {
    "streetAddress": "123 Main Street",
    "city": "Los Angeles",
    "state": "CA",
    "zip": "90001",
    "country": "US"
  }
}

Response

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

type'FeatureCollection' required

GeoJSON type identifier.

resourceIdstring uuid required

Unique identifier for the resource.

eventIdstring uuid required

Unique identifier for the event. This is the postCatEventId value from the Coverage API, and the eventId path parameter.

eventUuidstring uuid required

Deprecated. Use eventId. This field has the same value as eventId.

eventNamestring required

Human-readable event name.

geomatchedAddressstring

Matched address from geocoding (only present for address-based queries).

modelVersionstring required

Version of the damage assessment model.

presentationVersionstring required

Version of the presentation layer.

nextCursorstring

Cursor for fetching the next page of results. Absent on the last page.

Example response

{
  "features": [
    {
      "properties": {
        "damage": {
          "event": {
            "classRatios": [
              {
                "description": "Building lifecycle"
              }
            ]
          },
          "preEvent": {
            "classRatios": [
              {
                "description": "Building lifecycle"
              }
            ]
          }
        },
        "areaSqm": 51.73984,
        "areaSqft": 138
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.