Clusters

Hotspots grouped in space and time into candidate fires.

deepfire:clusters — centroids of hotspot clusters: candidate fires, current and historical (since January 2025). Geometry: Point (EPSG). Feature IDs: clusters.<uuid>.

This is the collection to use when you want “fires” rather than per-satellite hotspots.

Attributes

Property	Type	Notes
`id`	uuid	Feature key (surfaced as `clusters.<uuid>`)
`first_observed`	timestamp (ISO 8601)	First detection in the cluster
`last_observed`	timestamp (ISO 8601)	Most recent detection in the cluster
`active`	boolean	Live working set vs. historical

Hotspots and satellite perimeters join back to this collection via their cluster_id attribute.

Examples

Active clusters in a bounding box (Iberia):

curl -sG -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:clusters/items" \
  --data-urlencode "bbox=-10,36,4,44" \
  --data-urlencode "filter-lang=cql2-text" \
  --data-urlencode "filter=active = true" \
  --data-urlencode "f=application/geo+json"

Clusters with recent detections:

curl -sG -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/ogc/features/v1/collections/deepfire:clusters/items" \
  --data-urlencode "filter-lang=cql2-text" \
  --data-urlencode "filter=last_observed > TIMESTAMP('2026-07-20T00:00:00Z')" \
  --data-urlencode "f=application/geo+json"

Full parameter reference: Get clusters.