Core concepts

Coverage

Coverage describes where AURA can respond for a given response type — useful to check before onboarding a customer or creating a callout there.

Coverage is exposed as a downloadable KML map of coverage polygons: GET /panic-api/v2/coverage/{responseTypeId} returns an XML (KML) document — not JSON — containing one placemark per coverage polygon.

To answer “is this point covered?” in your own system:

  1. Fetch the KML for the relevant response type (get IDs from List response types).
  2. Run a point-in-polygon test against the document’s placemark coordinates (most geo libraries can ingest KML directly).
  3. Refresh the document periodically — coverage changes as the responder network grows.

Alternatively, render the KML on a map (Google Earth/Maps and most GIS tools accept it natively) to visualise coverage for operations teams.

Reference: Retrieve coverage as KML.