[Docs](/docs) / Geospatial # Geospatial GA `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 GA 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. | 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. **Request** ``` { "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 } ``` **Response** ``` { "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. **Request** ``` { "datasets": [ "goes-19-abi" ], "filters": { "product": "ABI-L2-FDCC" }, "limit": 1 } ``` **Response** ``` { "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. **Request** ``` { "datasets": [ "hrrr-conus" ], "area": { "place": "Los Angeles" }, "limit": 1 } ``` **Response** ``` { "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 GA 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`. | 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. **Request** ``` { "id": "S2C_T11SLT_20261004T184227_L2A", "dataset": "sentinel-2-c1-l2a" } ``` **Response** ``` { "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 GA 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. | 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. **Request** ``` { "query": "Los Angeles", "limit": 2 } ``` **Response** ``` { "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. **Request** ``` { "near": { "lon": -122.4194, "lat": 37.7749 }, "limit": 3 } ``` **Response** ``` { "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 --- This is the Markdown copy of https://deep.navy/docs/geo.