Get SeekEarth at a place and moment
get_earth_viewGet SeekEarth for one place and moment: the published changes placed there, the Change Heat of its countries, and the Earth's layer items in force (disaster alerts, cyclones, official warnings, conflict, outbreaks, river levels and more), each with its nature and source to credit. Use it for where-and-when questions; for heat across all countries use get_country_heat, for the country list list_countries, for changes by subject search_changes. Parameters: give country, or lat with lon and a radius_km circle; at sets the moment and days the window before it; mode NOW reads today's knowledge of those days, KNOWN what readers could see at the time; layers narrows the Earth layers. Behavior: at most 30 changes, most important first; in KNOWN mode changes withdrawn since are only counted (withdrawnLater); a place is required. One call of the key's quota (Free keys have a daily MCP cap); a rejected argument costs nothing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | The moment to read, ISO 8601 date or date-time with a zone (default now); not in the future and within the plan's reach | |
| lat | No | Latitude of the place in degrees (with lon); the place is a circle of radius_km around it | |
| lon | No | Longitude of the place in degrees (with lat) | |
| days | No | Window in days before `at`, 1 to 180 (default 7); capped by the key's plan | |
| mode | No | NOW (default): today's knowledge of the window; KNOWN: what readers could see at `at` | NOW |
| layers | No | Which Earth layers to include (e.g. gdacs, nhc, jma, ucdp, aftershock); omit for every event layer | |
| locale | No | Language of headlines, summaries and notices in the answer: en, zh or ja; omit for the connection's default language (en unless set) | |
| country | No | ISO 3166-1 alpha-2 country code, e.g. JP; give either this or lat and lon | |
| radius_km | No | Radius of the circle around lat and lon, 10 to 3000 km (default 500) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | Yes | The moment read, ISO 8601 UTC | |
| url | Yes | The SeekEarth page on aiseek.dev for this place | |
| days | Yes | The window in days, after the plan's cap | |
| from | Yes | Start of the window, ISO 8601 UTC, after the plan's cap | |
| heat | Yes | Change Heat of the place's countries on the UTC day of `at` | |
| mode | Yes | KNOWN: what readers could see at `at`; NOW: today's knowledge of the same days | |
| place | Yes | The place asked about: {country} or {lat, lon, radiusKm} | |
| events | Yes | Items of the Earth's layers in force there (disasters, warnings, forecasts, conflict, displacement, outbreaks, power plants...), each with its layer's nature and source | |
| changes | Yes | Published changes placed there in the window, most important first (at most 30); knownAfter and wordingChangedLater mark NOW-only differences | |
| maxDays | Yes | The longest window the plan allows | |
| sources | Yes | Where each layer comes from and how to credit it | |
| withdrawnLater | Yes | KNOWN only: changes readers could see then that have been withdrawn since (counted, never shown) |