Skip to main content
GET
Spatial density grid

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

bbox
string

Bounding box filter: minLon,minLat,maxLon,maxLat (lon-first axis order). One of bbox / near / near_gem_id is required.

near
string

Point 'lat,lon' for a radius area; combine with radius_km (default 50 km). One of bbox / near / near_gem_id is required.

near_gem_id
string

GEM energy-asset gem_id center — concentration of traffic within radius_km of that asset (default 25 km). One of bbox / near / near_gem_id is required.

radius_km
number

Radius in km for near / near_gem_id. Default 50 (near) or 25 (near_gem_id); clamped 1–2000.

cell_deg
number
default:0.05

Grid cell size in degrees (0.01–1). Smaller = finer heatmap. Defaults to 0.05.

Required range: 0.01 <= x <= 1
date_start
string

Window start YYYY-MM-DD (≤7-day window).

date_end
string

Window end YYYY-MM-DD.

days
integer

Trailing N-day window (1–7). Defaults to 1.

Required range: 1 <= x <= 7
limit
integer
default:500

Grid cells per page (1–5000), densest first.

Required range: 1 <= x <= 5000

Response

Density grid, densest cells first. Envelope: { success, cell_deg, data, pagination, applied_filters }. Each data row: cell_lat, cell_lon (cell SW/lower corner, degrees), positions (AIS message count), vessels (distinct mmsi).

success
boolean
cell_deg
number
data
object[]
pagination
object
applied_filters
object