place_index
place.index — WHAT EXISTS AT A PLACE, AND WHEN. Rows within radius_km (default 2, max 50) of lat + lng, or of an entity's site
(entity_type deposit|infrastructure|company|project + id; a country-centre anchor is refused 409, not charged), newest first:
still = a satellite still a route delivered (look_at, look_through, entity_state) or a frame entity_change used — scene id,
acquisition date, platform, cloud cover, the ground it covers (footprint_m2); never who asked. quote = a dated source attestation of
a relationship, at each end of the relation that has a site (relation id, relation, source url, an excerpt). verdict / match =
oracle verdicts and marketplace match ids — none are held yet (they arrive with the escrow build) and none are invented; the answer
says so in not_held_yet. measurement = every entity_change and site_reconstruction answer made here (its height_class, the
claim — volume or change only where the class supports it — its inputs: scene ids, the height sources tried and used, the licences,
the footprint — and the operator edge the graph served that day); append-only: never updated or deleted, asking again adds a new
generation, an untestable answer is kept too, never who asked. Each row carries both times: valid_on (a date in the world, with its precision) and recorded_at (when
GreenlandAI came to hold it). from_date / to_date (YYYY-MM-DD) filter valid_on; kinds and entity_types are comma lists;
counts per kind cover the whole match, rows one page (limit 1..500, offset). Fetch a still with look_at; read a relationship with
relationships. AUTH: an agent key; browser sessions follow the graph-read rule. SIDE EFFECTS: none beyond the charge — read-only.
⚠ CHARGING: one price at the basic class (look_from's price); an answer with no rows costs nothing; quote with
billing_quote("/api/v1/place.index"); the JSON carries charged_joules.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| lat | No | ||
| lng | No | ||
| kinds | No | ||
| limit | No | ||
| offset | No | ||
| to_date | No | ||
| from_date | No | ||
| radius_km | No | ||
| entity_type | No | ||
| entity_types | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||