Docs / Geospatial

Geospatial

geo_search finds satellite scenes, weather forecasts and station records by place, time and typed filters and returns a STAC 1.1 ItemCollection, which pystac, QGIS and any STAC client read as they are. geo_fetch returns one Item, and geo_places looks up places and their boundaries in Overture Maps.

Call it

The three tools are served on /geo and, like every tool you have switched on, on /mcp.

			https://mcp.deep.navy/geo

			https://mcp.deep.navy/mcp

Datasets

Six datasets, each a STAC Collection. Call geo_search with no dataset to list them with their time ranges, licenses and attribution.

Dataset	What it holds	How it is kept current
sentinel-2-c1-l2a	Sentinel-2 Collection 1 Level-2A optical imagery, with cloud cover per scene.	Queried in place against Element 84's Earth Search API at call time, so the whole archive since 2015 is available.
goes-19-abi · goes-18-abi	NOAA GOES ABI Level 2 products: cloud and moisture imagery (ABI-L2-CMIPC, ABI-L2-CMIPF), fire and hot-spot characterization (ABI-L2-FDCC, ABI-L2-FDCF) and aerosol and smoke detection (ABI-L2-ADPC).	Synced from NOAA's Open Data buckets every three hours.
hrrr-conus · hrrr-conus-prs	HRRR surface (wrfsfc) and pressure-level (wrfprs) forecasts at 3 km over the continental United States, one item per hourly run.	Synced from NOAA's Open Data buckets every three hours.
isd-global-hourly	NOAA Integrated Surface Database hourly station observations for the current and previous year, one item per station and year.	Synced from NOAA's Open Data buckets every three hours.

Every asset carries an access hint, and every dataset served today is public: files download from AWS Open Data buckets with no account. Every collection carries the provider's attribution. Monitors watch the synced datasets; Sentinel-2 is queried live and cannot be monitored.

Area, time and filters

Name one or more datasets in datasets; every other argument is optional.

Area. area is one of a place name such as "Los Angeles" or "Paris, FR", an Overture divisionId from geo_places, a bbox, a GeoJSON geometry in intersects, or a point with a radius in near. A place name resolves through geo_places, first match first, and the response names the place in resolvedPlace; pass a divisionId to be exact. relation sets how a footprint must relate to the area, intersects by default.

Time. datetime is an RFC 3339 instant or interval with open ends, such as 2026-09-01T00:00:00Z/2026-09-30T23:59:59Z or 2026-09-20/..; dates alone are accepted.

Filters and order. filters.maxCloudCover keeps optical scenes at or below a cloud percentage, filters.platform picks satellites such as goes-19, and filters.product picks a product such as ABI-L2-FDCC or wrfsfc; a filter that does not apply to a dataset is ignored. sort is newest first by default, or oldest first, or clearest first with SORT_CLOUD_COVER_ASC.

Pages and fields. limit is up to 100 items, 10 by default; pass nextPageToken back as pageToken for the next page. Items are compact by default, with the key properties and asset links; fields: FIELDS_FULL returns whole items.

geo_search

It returns a STAC 1.1 ItemCollection of the matching items, the place your area resolved to, and a token for the next page; with no dataset, it returns the datasets instead.

What comes back

Field	Type	Meaning
itemCollection	STAC ItemCollection	It is a GeoJSON FeatureCollection of STAC 1.1 Items, with `numberMatched` and `numberReturned`.
itemCollection.features.id	string	It is the item's id. Pass it to `geo_fetch`.
itemCollection.features.collection	string	It is the dataset the item belongs to.
itemCollection.features.geometry · bbox	GeoJSON	They are the item's footprint and its bounding box, in WGS 84.
itemCollection.features.properties	object	They are the item's STAC properties: `datetime`, `platform`, and per dataset `eo:cloud_cover`, `product` or the forecast run.
itemCollection.features.assets	object	They are the files, by key, each with `href`, its media `type`, its `roles` and the deep.navy `access` hint, `public` for every dataset today.
itemCollection.features.links	Link[]	They are the provider's links for the item, such as its record in the source catalog.
itemCollection.features.stac_version	string	It is the STAC version, `1.1.0`.
nextPageToken	string	Pass it as `pageToken` for the next page. It is empty on the last page.
resolvedPlace.id	string	It is the Overture division id. Pass it as `area.divisionId` to `geo_search` or as `near.divisionId` to `news_search`.
resolvedPlace.name	string	It is the division's name.
resolvedPlace.subtype	string	It is the kind of division: `country`, `region`, `county`, `localadmin`, `locality`, `borough` or `neighborhood`.
resolvedPlace.…	Place	It is the place your `area.place` resolved to, with every `geo_places` field, so you can check the match.
collections	Collection[]	They are the datasets, when you named none: id, title, description, license, time range, access, attribution and the STAC Collection.

itemCollection STAC ItemCollection: It is a GeoJSON FeatureCollection of STAC 1.1 Items, with numberMatched and numberReturned.
itemCollection.features.id string: It is the item's id. Pass it to geo_fetch.
itemCollection.features.collection string: It is the dataset the item belongs to.
itemCollection.features.geometry · bbox GeoJSON: They are the item's footprint and its bounding box, in WGS 84.
itemCollection.features.properties object: They are the item's STAC properties: datetime, platform, and per dataset eo:cloud_cover, product or the forecast run.
itemCollection.features.assets object: They are the files, by key, each with href, its media type, its roles and the deep.navy access hint, public for every dataset today.
itemCollection.features.links Link[]: They are the provider's links for the item, such as its record in the source catalog.
itemCollection.features.stac_version string: It is the STAC version, 1.1.0.
nextPageToken string: Pass it as pageToken for the next page. It is empty on the last page.
resolvedPlace.id string: It is the Overture division id. Pass it as area.divisionId to geo_search or as near.divisionId to news_search.
resolvedPlace.name string: It is the division's name.
resolvedPlace.subtype string: It is the kind of division: country, region, county, localadmin, locality, borough or neighborhood.
resolvedPlace.… Place: It is the place your area.place resolved to, with every geo_places field, so you can check the match.
collections Collection[]: They are the datasets, when you named none: id, title, description, license, time range, access, attribution and the STAC Collection.

Unset optional fields are omitted; explicitly set zero and false values are preserved. Empty lists are explicit arrays, and 64-bit integers are strings, as protojson writes them.

geo_search

Clear Sentinel-2 scenes over Los Angeles

Sentinel-2 Level-2A scenes over Los Angeles since 20 September 2026 with at most 5 percent cloud, clearest first, queried live against Earth Search.

{
  "datasets": [
    "sentinel-2-c1-l2a"
  ],
  "area": {
    "place": "Los Angeles"
  },
  "datetime": "2026-09-20T00:00:00Z/..",
  "filters": {
    "maxCloudCover": 5
  },
  "sort": "SORT_CLOUD_COVER_ASC",
  "limit": 1
}

{
  "itemCollection": {
    "features": [
      {
        "assets": {
          "blue": {
            "access": "public",
            "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/B02.tif",
            "roles": [
              "data",
              "reflectance"
            ],
            "type": "image/tiff; application=geotiff; profile=cloud-optimized"
          },
          "green": {
            "access": "public",
            "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/B03.tif",
            "roles": [
              "data",
              "reflectance"
            ],
            "type": "image/tiff; application=geotiff; profile=cloud-optimized"
          },
          "nir": {
            "access": "public",
            "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/B08.tif",
            "roles": [
              "data",
              "reflectance"
            ],
            "type": "image/tiff; application=geotiff; profile=cloud-optimized"
          },
          "preview": {
            "access": "public",
            "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/L2A_PVI.tif",
            "roles": [
              "overview"
            ],
            "type": "image/tiff; application=geotiff; profile=cloud-optimized"
          },
          "red": {
            "access": "public",
            "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/B04.tif",
            "roles": [
              "data",
              "reflectance"
            ],
            "type": "image/tiff; application=geotiff; profile=cloud-optimized"
          },
          "scl": {
            "access": "public",
            "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/SCL.tif",
            "roles": [
              "data"
            ],
            "type": "image/tiff; application=geotiff; profile=cloud-optimized"
          },
          "thumbnail": {
            "access": "public",
            "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/L2A_PVI.jpg",
            "roles": [
              "thumbnail"
            ],
            "type": "image/jpeg"
          },
          "visual": {
            "access": "public",
            "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/TCI.tif",
            "roles": [
              "visual"
            ],
            "type": "image/tiff; application=geotiff; profile=cloud-optimized"
          }
        },
        "bbox": [
          -119.173769,
          33.332776,
          -117.969386,
          34.337728
        ],
        "collection": "sentinel-2-c1-l2a",
        "geometry": {
          "coordinates": [
            [
              [
                -119.17376896599782,
                34.32235671057083
              ],
              [
                -119.1488566202142,
                33.33277630652224
              ],
              [
                -117.96938626406872,
                33.34758667242361
              ],
              [
                -117.98063319821664,
                34.33772750342932
              ],
              [
                -119.17376896599782,
                34.32235671057083
              ]
            ]
          ],
          "type": "Polygon"
        },
        "id": "S2C_T11SLT_20261004T184227_L2A",
        "links": [
          {
            "href": "https://earth-search.aws.element84.com/v1/collections/sentinel-2-c1-l2a/items/S2C_T11SLT_20261004T184227_L2A",
            "rel": "self",
            "type": "application/geo+json"
          },
          {
            "href": "s3://e84-earth-search-sentinel-data/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/S2C_T11SLT_20261004T184227_L2A.json",
            "rel": "canonical",
            "type": "application/json"
          },
          {
            "href": "s3://sentinel-s2-l2a/tiles/11/S/LT/2026/10/4/0/metadata.xml",
            "rel": "via",
            "title": "Granule Metadata in Sinergize RODA Archive",
            "type": "application/xml"
          },
          "… [trimmed: 4 more items, 7 in all]"
        ],
        "properties": {
          "datetime": "2026-10-04T18:45:04.560000Z",
          "eo:cloud_cover": 0.003796,
          "grid:code": "MGRS-11SLT",
          "platform": "sentinel-2c"
        },
        "stac_version": "1.1.0",
        "type": "Feature"
      }
    ],
    "links": [],
    "numberMatched": 6,
    "numberReturned": 1,
    "type": "FeatureCollection"
  },
  "nextPageToken": "eyJjb2xsZWN0aW9ucyI6WyJzZW50aW5lbC0yLWMxLWwyYSJdLCJkYXRldGltZSI6IjIwMjYtMDktMjBUMDA6MDA6MDBaLy4uIiwiaW50ZXJzZWN0cyI6eyJjb29yZGluYXRlcyI6W1tbLTExOC42NTc0NjI5LDM0LjE4OTkzNThdLFstMTE4LjY2ODExNzcsMzQuMTkxMzQzN10sWy0xMTguNjY4MTcwMiwzNC4xNzY3NjQ3XSxbLTExOC42NTg2MTYyLDM0LjE3Njc1OTVdLFstMTE4LjY1ODY0MzYsMzQuMTY5NDUzOV0sWy0xMTguNjU0Mjg1OSwzNC4xNjk0MzU0XSxbLTExOC42NTQyOTA5LDM0LjE2NTc0MTddLFstMTE4LjY0NTUzOTQsMzQuMTY1Njk1Ml0sWy0xMTguNjQ1NTYyOSwzNC4xNjE5OTE3XSxbLTExOC42NDE5OTIxLDM0LjE2MTk4NTddLFstMTE4LjYzOTcyNDksMzQuMTU5MDg4Ml0sWy0xMTguNjQxMjk4MSwzNC4xNTY3NzY2XSxbLTExOC42Mzg1NzAyLDM0LjE1NzY3OTNdLFstMTE4LjYzMjE2NzEsMzQuMTUwNTE4M10sWy0xMTguNjMwMjY3NywzNC4xNTAzNzJdLFstMTE4LjYyOTAyMzIsMzQuMTQ3Mjc2M10sWy0xMTguNjE0OTcxLDM0LjE0NzI3N10sWy0xMTguNjE0OTc4LDM0LjE0OTI2N10sWy0xMTguNTY0NzkzMiwzNC4xMzAxNzY5XSxbLTExOC41OTkyMDY2LDM0LjA3NDMzNzJdLFstMTE4LjU3MDQ4NTUsMzQuMDY5NDI1N10sWy0xMTguNTcwMTAyLDM0LjA0NzA1MTJdLFstMTE4LjU2NzEzNDksMzQuMDQxNTIwNV0sWy0xMTguNTcwMTAwOCwzMy45ODg3MjU4XSxbLTExOC41NTczNTQ1LDMzLjk4NzY3MTJdLFstMTE4LjU1MzQ2NzgsMzMuOTg0MzM0OV0sWy0xMTguNTM3ODE1LDMzLjk5OTgzNl0sWy0xMTguNTE3NjIzOSwzNC4wMjQ4OTk5XSxbLTExOC41MDg2NDkzLDM0LjAzMzA3ODZdLFstMTE4LjUwODMyMywzNC4wMzkyMDVdLFstMTE4LjUwMzk2MDIsMzQuMDQwNzE4OV0sWy0xMTguNDk0NDA5LDM0LjA1MDU4MjVdLFstMTE4LjQ4MzgwOTEsMzQuMDQxNTcyN10sWy0xMTguNDc3MjAyOSwzNC4wNDY2NTEyXSxbLTExOC40NTkzMTQ2LDM0LjAzMTMyNjNdLFstMTE4LjQ1NzY5NTIsMzQuMDMxNjM2OV0sWy0xMTguNDU3MDc3MiwzNC4wMjk3MjFdLFstMTE4LjQ1Mjk3MjUsMzQuMDI3OTEzXSxbLTExOC40NDM1MzM2LDM0LjAxNjU3MDhdLFstMTE4LjUzNzUxNjMsMzMuOTY2\n… [trimmed: 17,494 more characters]",
  "resolvedPlace": {
    "id": "5b65e181-2321-4234-88a0-89d92680c036",
    "name": "Los Angeles",
    "subtype": "locality",
    "country": "US",
    "region": "US-CA",
    "population": "4030904",
    "wikidata": "Q65",
    "hierarchy": [
      "United States",
      "California",
      "Los Angeles County"
    ],
    "parentIds": [
      "f39eb4af-5206-481b-b19e-bd784ded3f05",
      "4c555166-326b-48b4-8a33-155eb7c23e8d",
      "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb"
    ],
    "centroid": {
      "lon": -118.40721994057964,
      "lat": 34.08953853340753
    },
    "bbox": {
      "west": -118.66818237304688,
      "south": 33.65953826904297,
      "east": -118.1552963256836,
      "north": 34.33730697631836
    }
  }
}

Captured 2026-10-05 17:28 UTC from production

geo_search

The latest GOES-19 fire detection scan

The newest GOES-19 fire and hot spot characterization scan over the continental United States, as NetCDF on NOAA's open data bucket.

{
  "datasets": [
    "goes-19-abi"
  ],
  "filters": {
    "product": "ABI-L2-FDCC"
  },
  "limit": 1
}

{
  "itemCollection": {
    "features": [
      {
        "assets": {
          "data": {
            "access": "public",
            "href": "https://noaa-goes19.s3.amazonaws.com/ABI-L2-FDCC/2026/278/15/OR_ABI-L2-FDCC-M6_G19_s20262781511176_e20262781513549_c20262781514093.nc",
            "roles": [
              "data"
            ],
            "type": "application/x-netcdf"
          }
        },
        "bbox": [
          -152,
          14,
          -53,
          57
        ],
        "collection": "goes-19-abi",
        "geometry": {
          "coordinates": [
            [
              [
                -152,
                14
              ],
              [
                -53,
                14
              ],
              [
                -53,
                57
              ],
              [
                -152,
                57
              ],
              [
                -152,
                14
              ]
            ]
          ],
          "type": "Polygon"
        },
        "id": "goes-19-ABI-L2-FDCC-20261005T151117Z",
        "links": [],
        "properties": {
          "datetime": "2026-10-05T15:11:17Z",
          "goes:product": "ABI-L2-FDCC",
          "goes:satellite": "goes-19",
          "goes:scene": "C",
          "platform": "goes-19",
          "product": "ABI-L2-FDCC"
        },
        "stac_version": "1.1.0",
        "type": "Feature"
      }
    ],
    "links": [],
    "numberMatched": 675,
    "numberReturned": 1,
    "type": "FeatureCollection"
  },
  "nextPageToken": "WzE3OTEyMTMwNzc2MDAsImdvZXMtMTktYWJpL2dvZXMtMTktQUJJLUwyLUZEQ0MtMjAyNjEwMDVUMTUxMTE3WiJd"
}

Captured 2026-10-05 17:28 UTC from production

geo_search

The latest HRRR forecast run

The newest HRRR surface forecast run that covers Los Angeles, with its GRIB2 file and the place the name resolved to.

{
  "datasets": [
    "hrrr-conus"
  ],
  "area": {
    "place": "Los Angeles"
  },
  "limit": 1
}

{
  "itemCollection": {
    "features": [
      {
        "assets": {
          "f00": {
            "access": "public",
            "href": "https://noaa-hrrr-bdp-pds.s3.amazonaws.com/hrrr.20261005/conus/hrrr.t14z.wrfsfcf00.grib2",
            "roles": [
              "data"
            ],
            "type": "application/wmo-GRIB2"
          }
        },
        "bbox": [
          -134.1,
          21.1,
          -60.9,
          52.6
        ],
        "collection": "hrrr-conus",
        "geometry": {
          "coordinates": [
            [
              [
                -134.1,
                21.1
              ],
              [
                -60.9,
                21.1
              ],
              [
                -60.9,
                52.6
              ],
              [
                -134.1,
                52.6
              ],
              [
                -134.1,
                21.1
              ]
            ]
          ],
          "type": "Polygon"
        },
        "id": "hrrr-conus-20261005T14",
        "links": [],
        "properties": {
          "datetime": "2026-10-05T14:00:00Z",
          "hrrr:domain": "conus",
          "hrrr:forecast_hours": 15,
          "hrrr:run_time": "2026-10-05T14:00:00Z",
          "platform": "hrrr",
          "product": "wrfsfc"
        },
        "stac_version": "1.1.0",
        "type": "Feature"
      }
    ],
    "links": [],
    "numberMatched": 735,
    "numberReturned": 1,
    "type": "FeatureCollection"
  },
  "nextPageToken": "WzE3OTEyMDg4MDAwMDAsImhycnItY29udXMvaHJyci1jb251cy0yMDI2MTAwNVQxNCJd",
  "resolvedPlace": {
    "id": "5b65e181-2321-4234-88a0-89d92680c036",
    "name": "Los Angeles",
    "subtype": "locality",
    "country": "US",
    "region": "US-CA",
    "population": "4030904",
    "wikidata": "Q65",
    "hierarchy": [
      "United States",
      "California",
      "Los Angeles County"
    ],
    "parentIds": [
      "f39eb4af-5206-481b-b19e-bd784ded3f05",
      "4c555166-326b-48b4-8a33-155eb7c23e8d",
      "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb"
    ],
    "centroid": {
      "lon": -118.40721994057964,
      "lat": 34.08953853340753
    },
    "bbox": {
      "west": -118.66818237304688,
      "south": 33.65953826904297,
      "east": -118.1552963256836,
      "north": 34.33730697631836
    }
  }
}

Captured 2026-10-05 17:28 UTC from production

geo_fetch

It returns one STAC 1.1 Item by id, with every asset's URL and access hint. Pass dataset when the same id exists in more than one dataset, and fields: FIELDS_FULL for every property.

What comes back

Field	Type	Meaning
item	STAC Item	It is one STAC 1.1 Item, a GeoJSON Feature.
item.id	string	It is the item's id. Pass it to `geo_fetch`.
item.collection	string	It is the dataset the item belongs to.
item.geometry · bbox	GeoJSON	They are the item's footprint and its bounding box, in WGS 84.
item.properties	object	They are the item's STAC properties: `datetime`, `platform`, and per dataset `eo:cloud_cover`, `product` or the forecast run.
item.assets	object	They are the files, by key, each with `href`, its media `type`, its `roles` and the deep.navy `access` hint, `public` for every dataset today.
item.links	Link[]	They are the provider's links for the item, such as its record in the source catalog.
item.stac_version	string	It is the STAC version, `1.1.0`.
item.stac_extensions	string[]	They are the STAC extensions the item uses, with `fields: FIELDS_FULL`.

item STAC Item: It is one STAC 1.1 Item, a GeoJSON Feature.
item.id string: It is the item's id. Pass it to geo_fetch.
item.collection string: It is the dataset the item belongs to.
item.geometry · bbox GeoJSON: They are the item's footprint and its bounding box, in WGS 84.
item.properties object: They are the item's STAC properties: datetime, platform, and per dataset eo:cloud_cover, product or the forecast run.
item.assets object: They are the files, by key, each with href, its media type, its roles and the deep.navy access hint, public for every dataset today.
item.links Link[]: They are the provider's links for the item, such as its record in the source catalog.
item.stac_version string: It is the STAC version, 1.1.0.
item.stac_extensions string[]: They are the STAC extensions the item uses, with fields: FIELDS_FULL.

Unset optional fields are omitted; explicitly set zero and false values are preserved. Empty lists are explicit arrays, and 64-bit integers are strings, as protojson writes them.

geo_fetch

One STAC item by id

The Sentinel-2 scene over Los Angeles from 4 October 2026 as a STAC 1.1 Item, with its key properties and every asset marked public.

{
  "id": "S2C_T11SLT_20261004T184227_L2A",
  "dataset": "sentinel-2-c1-l2a"
}

{
  "item": {
    "assets": {
      "blue": {
        "access": "public",
        "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/B02.tif",
        "roles": [
          "data",
          "reflectance"
        ],
        "type": "image/tiff; application=geotiff; profile=cloud-optimized"
      },
      "green": {
        "access": "public",
        "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/B03.tif",
        "roles": [
          "data",
          "reflectance"
        ],
        "type": "image/tiff; application=geotiff; profile=cloud-optimized"
      },
      "nir": {
        "access": "public",
        "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/B08.tif",
        "roles": [
          "data",
          "reflectance"
        ],
        "type": "image/tiff; application=geotiff; profile=cloud-optimized"
      },
      "preview": {
        "access": "public",
        "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/L2A_PVI.tif",
        "roles": [
          "overview"
        ],
        "type": "image/tiff; application=geotiff; profile=cloud-optimized"
      },
      "red": {
        "access": "public",
        "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/B04.tif",
        "roles": [
          "data",
          "reflectance"
        ],
        "type": "image/tiff; application=geotiff; profile=cloud-optimized"
      },
      "scl": {
        "access": "public",
        "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/SCL.tif",
        "roles": [
          "data"
        ],
        "type": "image/tiff; application=geotiff; profile=cloud-optimized"
      },
      "thumbnail": {
        "access": "public",
        "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/L2A_PVI.jpg",
        "roles": [
          "thumbnail"
        ],
        "type": "image/jpeg"
      },
      "visual": {
        "access": "public",
        "href": "https://e84-earth-search-sentinel-data.s3.us-west-2.amazonaws.com/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/TCI.tif",
        "roles": [
          "visual"
        ],
        "type": "image/tiff; application=geotiff; profile=cloud-optimized"
      }
    },
    "bbox": [
      -119.173769,
      33.332776,
      -117.969386,
      34.337728
    ],
    "collection": "sentinel-2-c1-l2a",
    "geometry": {
      "coordinates": [
        [
          [
            -119.17376896599782,
            34.32235671057083
          ],
          [
            -119.1488566202142,
            33.33277630652224
          ],
          [
            -117.96938626406872,
            33.34758667242361
          ],
          [
            -117.98063319821664,
            34.33772750342932
          ],
          [
            -119.17376896599782,
            34.32235671057083
          ]
        ]
      ],
      "type": "Polygon"
    },
    "id": "S2C_T11SLT_20261004T184227_L2A",
    "links": [
      {
        "href": "https://earth-search.aws.element84.com/v1/collections/sentinel-2-c1-l2a/items/S2C_T11SLT_20261004T184227_L2A",
        "rel": "self",
        "type": "application/geo+json"
      },
      {
        "href": "s3://e84-earth-search-sentinel-data/sentinel-2-c1-l2a/11/S/LT/2026/10/S2C_T11SLT_20261004T184227_L2A/S2C_T11SLT_20261004T184227_L2A.json",
        "rel": "canonical",
        "type": "application/json"
      },
      {
        "href": "s3://sentinel-s2-l2a/tiles/11/S/LT/2026/10/4/0/metadata.xml",
        "rel": "via",
        "title": "Granule Metadata in Sinergize RODA Archive",
        "type": "application/xml"
      },
      "… [trimmed: 4 more items, 7 in all]"
    ],
    "properties": {
      "datetime": "2026-10-04T18:45:04.560000Z",
      "eo:cloud_cover": 0.003796,
      "grid:code": "MGRS-11SLT",
      "platform": "sentinel-2c"
    },
    "stac_version": "1.1.0",
    "type": "Feature"
  }
}

Captured 2026-10-05 17:28 UTC from production

geo_places

It looks up Overture Maps divisions by name, such as "Paris, Texas", or by a point in near, and returns each with its type, country, region, population, Wikidata id, hierarchy, centroid and bounding box, and with includeGeometry its boundary polygon. subtypes and country narrow the match, and the same lookup resolves every place argument in the other tools.

What comes back

Field	Type	Meaning
places	Place[]	They are the matching divisions, best first.
places.id	string	It is the Overture division id. Pass it as `area.divisionId` to `geo_search` or as `near.divisionId` to `news_search`.
places.name	string	It is the division's name.
places.subtype	string	It is the kind of division: `country`, `region`, `county`, `localadmin`, `locality`, `borough` or `neighborhood`.
places.country	string	It is the ISO 3166-1 alpha-2 country code.
places.region	string	It is the ISO 3166-2 region code, such as `US-CA`, when known.
places.population	int64	It is the population Overture lists. As an int64 it is a string in the JSON.
places.wikidata	string	It is the Wikidata QID, when known.
places.hierarchy	string[]	They are the names of the containing divisions, largest first.
places.parentIds	string[]	They are the ids of the containing divisions, in the same order as `hierarchy`.
places.centroid	Point	It is the centre point, as `lon` and `lat`.
places.bbox	BBox	It is the bounding box, as `west`, `south`, `east` and `north` in WGS 84 degrees.
places.geometry	GeoJSON	It is the boundary polygon, with `includeGeometry`.
attribution	string	It is the attribution the data requires: Overture Maps Foundation, CDLA-Permissive-2.0, and ODbL for OpenStreetMap-derived content.

places Place[]: They are the matching divisions, best first.
places.id string: It is the Overture division id. Pass it as area.divisionId to geo_search or as near.divisionId to news_search.
places.name string: It is the division's name.
places.subtype string: It is the kind of division: country, region, county, localadmin, locality, borough or neighborhood.
places.country string: It is the ISO 3166-1 alpha-2 country code.
places.region string: It is the ISO 3166-2 region code, such as US-CA, when known.
places.population int64: It is the population Overture lists. As an int64 it is a string in the JSON.
places.wikidata string: It is the Wikidata QID, when known.
places.hierarchy string[]: They are the names of the containing divisions, largest first.
places.parentIds string[]: They are the ids of the containing divisions, in the same order as hierarchy.
places.centroid Point: It is the centre point, as lon and lat.
places.bbox BBox: It is the bounding box, as west, south, east and north in WGS 84 degrees.
places.geometry GeoJSON: It is the boundary polygon, with includeGeometry.
attribution string: It is the attribution the data requires: Overture Maps Foundation, CDLA-Permissive-2.0, and ODbL for OpenStreetMap-derived content.

Unset optional fields are omitted; explicitly set zero and false values are preserved. Empty lists are explicit arrays, and 64-bit integers are strings, as protojson writes them.

geo_places

Look up a place by name

The places named Los Angeles, with their administrative hierarchy, Wikidata id, population, centroid and bounding box.

{
  "query": "Los Angeles",
  "limit": 2
}

{
  "places": [
    {
      "id": "5b65e181-2321-4234-88a0-89d92680c036",
      "name": "Los Angeles",
      "subtype": "locality",
      "country": "US",
      "region": "US-CA",
      "population": "4030904",
      "wikidata": "Q65",
      "hierarchy": [
        "United States",
        "California",
        "Los Angeles County"
      ],
      "parentIds": [
        "f39eb4af-5206-481b-b19e-bd784ded3f05",
        "4c555166-326b-48b4-8a33-155eb7c23e8d",
        "9b3d1c83-d266-4c67-b21f-6ff37f4d6ccb"
      ],
      "centroid": {
        "lon": -118.40721994057964,
        "lat": 34.08953853340753
      },
      "bbox": {
        "west": -118.66818237304688,
        "south": 33.65953826904297,
        "east": -118.1552963256836,
        "north": 34.33730697631836
      }
    },
    {
      "id": "fee7ca98-e5a7-4e70-80b3-ce20b73ffdd9",
      "name": "Los Angeles",
      "subtype": "locality",
      "country": "PA",
      "region": "PA-4",
      "population": "715",
      "wikidata": "Q20991006",
      "hierarchy": [
        "Panamá",
        "Chiriquí",
        "Gualaca"
      ],
      "parentIds": [
        "7c9cb2bf-59df-4dd5-ba47-808f2e980d64",
        "ab351a83-7f2c-482b-b002-7dd7133e784e",
        "94985ee9-f5b4-43c2-8132-6f1a06b0923d"
      ],
      "centroid": {
        "lon": -82.19309556068406,
        "lat": 8.530768844378203
      },
      "bbox": {
        "west": -82.2434310913086,
        "south": 8.47372817993164,
        "east": -82.12483215332031,
        "north": 8.574429512023926
      }
    }
  ],
  "attribution": "Overture Maps Foundation Open Map Data, accessed from https://registry.opendata.aws/overture. © Overture Maps Foundation, CDLA-Permissive-2.0; OpenStreetMap-derived content © OpenStreetMap contributors, ODbL 1.0."
}

Captured 2026-10-05 17:28 UTC from production

geo_places

The divisions at a point

The administrative divisions that contain a point in San Francisco, from the country down, each with its Wikidata id and bounding box.

{
  "near": {
    "lon": -122.4194,
    "lat": 37.7749
  },
  "limit": 3
}

{
  "places": [
    {
      "id": "f39eb4af-5206-481b-b19e-bd784ded3f05",
      "name": "United States",
      "subtype": "country",
      "country": "US",
      "population": "331449281",
      "wikidata": "Q30",
      "centroid": {
        "lon": -112.48822787437788,
        "lat": 45.68195978816654
      },
      "bbox": {
        "west": -179.14785766601562,
        "south": 18.91069984436035,
        "east": 179.7726287841797,
        "north": 71.38683319091797
      }
    },
    {
      "id": "4c555166-326b-48b4-8a33-155eb7c23e8d",
      "name": "California",
      "subtype": "region",
      "country": "US",
      "region": "US-CA",
      "population": "39576757",
      "wikidata": "Q99",
      "hierarchy": [
        "United States"
      ],
      "parentIds": [
        "f39eb4af-5206-481b-b19e-bd784ded3f05"
      ],
      "centroid": {
        "lon": -119.60850610555995,
        "lat": 37.24558146191924
      },
      "bbox": {
        "west": -124.4096908569336,
        "south": 32.534339904785156,
        "east": -114.13076782226562,
        "north": 42.00950241088867
      }
    },
    {
      "id": "713e9077-600c-4f06-84b9-6bae6e559c34",
      "name": "San Francisco",
      "subtype": "county",
      "country": "US",
      "region": "US-CA",
      "population": "873965",
      "wikidata": "Q62",
      "hierarchy": [
        "United States",
        "California"
      ],
      "parentIds": [
        "f39eb4af-5206-481b-b19e-bd784ded3f05",
        "4c555166-326b-48b4-8a33-155eb7c23e8d"
      ],
      "centroid": {
        "lon": -122.44147793810497,
        "lat": 37.7566738158278
      },
      "bbox": {
        "west": -122.52967071533205,
        "south": 37.70822525024414,
        "east": -122.32774353027344,
        "north": 37.863739013671875
      }
    }
  ],
  "attribution": "Overture Maps Foundation Open Map Data, accessed from https://registry.opendata.aws/overture. © Overture Maps Foundation, CDLA-Permissive-2.0; OpenStreetMap-derived content © OpenStreetMap contributors, ODbL 1.0."
}

Captured 2026-10-05 17:28 UTC from production