\n",
@@ -452,184 +514,177 @@
" \n",
" \n",
" \n",
- "
\n",
- " type\n",
- " \"Feature\"\n",
+ " \n",
+ " type\n",
+ " \"Collection\"\n",
" \n",
" \n",
" \n",
" \n",
" \n",
" \n",
- "
\n",
- " stac_version\n",
- " \"1.0.0\"\n",
+ " \n",
+ " id\n",
+ " \"overture-maps-addresses\"\n",
" \n",
" \n",
" \n",
" \n",
" \n",
" \n",
- "
\n",
- " id\n",
- " \"example-item\"\n",
+ " \n",
+ " stac_version\n",
+ " \"1.0.0\"\n",
" \n",
" \n",
" \n",
" \n",
" \n",
" \n",
- "
\n",
- " properties
\n",
- " \n",
- " \n",
- " \n",
- " \n",
- " - \n",
- " proj:epsg\n",
- " 32621\n",
+ "
- \n",
+ " description\n",
+ " \"## Overture Maps - addresses\n",
+ "\n",
+ "This collection contains items for the addresses theme.\n",
+ "\n",
+ "_Note: This theme is currently in Alpha and we anticipate significant changes over the next several releases. We invite the Overture community to test the addresses schema and data and offer feedback via the [data](https://github.com/OvertureMaps/data/issues) and [schema](https://github.com/OvertureMaps/schema/issues) repos._\n",
+ "\n",
+ "Overture maintains nearly 394 million address point entities. Data in the address theme is derived from over 60 sources, many distributed by [OpenAddresses](https://openaddresses.io/) and [AddressForAll](https://www.addressforall.org/en/), but also includes open data from the [City of New York](https://data.cityofnewyork.us/City-Government/NYC-Address-Points/g6pj-hd8k) and the [U.S. Department of Transportation](https://www.transportation.gov/gis/national-address-database).\n",
+ "\n",
+ "For licensing information, please see the [Attribution and Licensing page](https://docs.overturemaps.org/attribution/).\n",
+ "\n",
+ "Address data can be used for a variety of purposes, which can include:\n",
+ "\n",
+ "- **Mapping**: Addresses may be displayed on the map for reference purposes.\n",
+ "- **Geocoding**: Addresses are a primary component of high-accuracy geocoding services (i.e. converting text for an address to a complete address with a location).\n",
+ "- **Conflation**: Addresses can be used to conflate to other data themes (e.g. places, buildings) where appropriate for mapping or other use cases (e.g. refining search).\n",
+ "- **Standardization**: Parsing an input address into address components based on an existing schema or address model.\n",
+ "- **Normalization**: Adhering to standard and consistent forms of address components.\n",
+ "- **Validation and Verification**: Confirming an address exists within a known list of addresses.\n",
+ "\n",
+ "See the official [guide](https://docs.overturemaps.org/guides/addresses/) for tips on querying and analyzing this dataset.\n",
+ "\n",
+ "## Data assets\n",
+ "\n",
+ "The features are provided as a set of [geoparquet](https://github.com/opengeospatial/geoparquet) datasets. The data are partitioned by\n",
+ "\n",
+ "1. Theme\n",
+ "2. Type\n",
+ "\n",
+ "Each `(Theme, Type)` pair will have one or more geoparquet files, depending on the density of the of the features in that area.\n",
+ "\n",
+ "Note that older items in this dataset (version 2024.02.15-alpha.0 and earlier) are **not** spatially partitioned. We recommend using data with a release of 2023-03-12-alpha.0 or newer. The release is part of the URL for each parquet file and is captured in the STAC metadata for each item (see below).\n",
+ "\n",
+ "## STAC metadata\n",
+ "\n",
+ "The `overture:type` property can be used to filter items to a specific feature type, and the `version` property can be used to filter items to a specific release.\n",
+ "\n",
+ "## About Overture Maps\n",
+ "\n",
+ "Overture is a collaborative open-data initiative led by software developers, data experts,cartographic engineers, and product managers from dozens of Overture Maps Foundation member companies. Since our launch in December 2022, Overture members have been working toward a shared vision: to create reliable, user-friendly, and interoperable open map data that supports both current and future map products. We envision a world where shared, open base layers drive collaboration and innovation across industries and communities.\n",
+ "\n",
+ "For more information, visit the [Overture Maps Foundation](https://overturemaps.org/).\n",
+ "\n",
+ "\"\n",
"
\n",
" \n",
+ " \n",
" \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " proj:transform\n",
- " [] 6 items\n",
- "
\n",
+ " \n",
+ " \n",
+ " links[] 5 items
\n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 0\n",
- " 100.01126757344893\n",
- "
\n",
- " \n",
- " \n",
- " \n",
- "
\n",
- " \n",
+ " \n",
+ " 0
\n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 1\n",
- " 0.0\n",
+ "
- \n",
+ " rel\n",
+ " \"root\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " \n",
- " \n",
" \n",
" \n",
- " - \n",
- " 2\n",
- " 373185.0\n",
+ "
- \n",
+ " href\n",
+ " \"/home/henry/workspace/stactools-packages/overture-maps/examples/catalog.json\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " \n",
- " \n",
" \n",
" \n",
- " - \n",
- " 3\n",
- " 0.0\n",
+ "
- \n",
+ " type\n",
+ " \"application/json\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " \n",
- " \n",
" \n",
" \n",
- " - \n",
- " 4\n",
- " -100.01126757344893\n",
+ "
- \n",
+ " title\n",
+ " \"Overture Maps\"\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
- " \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " - \n",
- " 5\n",
- " 8286015.0\n",
- "
\n",
+ "
\n",
" \n",
" \n",
" \n",
"
\n",
" \n",
- " \n",
- " \n",
+ "
\n",
" \n",
" \n",
- " \n",
- " \n",
- " proj:shape\n",
- " [] 2 items\n",
- "
\n",
- " \n",
+ " \n",
+ " \n",
+ " 1
\n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 0\n",
- " 2667\n",
+ "
- \n",
+ " rel\n",
+ " \"license\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " \n",
- " \n",
" \n",
" \n",
- " - \n",
- " 1\n",
- " 2658\n",
+ "
- \n",
+ " href\n",
+ " \"https://docs.overturemaps.org/attribution/#addresses\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " \n",
- " \n",
- " \n",
" \n",
" \n",
- " - \n",
- " custom_attribute\n",
- " \"foo\"\n",
+ "
- \n",
+ " type\n",
+ " \"text/html\"\n",
"
\n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " datetime\n",
- " \"2023-09-12T11:48:03.199913Z\"\n",
+ "
- \n",
+ " title\n",
+ " \"various\"\n",
"
\n",
" \n",
" \n",
@@ -637,75 +692,48 @@
"
\n",
" \n",
" \n",
- " \n",
+ " \n",
+ " \n",
+ " \n",
+ " \n",
+ "
\n",
+ " \n",
" \n",
" \n",
- " \n",
" \n",
- " geometry
\n",
+ " 2
\n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " type\n",
- " \"Polygon\"\n",
+ "
- \n",
+ " rel\n",
+ " \"item\"\n",
"
\n",
" \n",
" \n",
" \n",
" \n",
- " \n",
- " \n",
- " coordinates\n",
- " [] 1 items\n",
- "
\n",
- " \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " 0\n",
- " [] 5 items\n",
- "
\n",
- " \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " 0\n",
- " [] 2 items\n",
- "
\n",
- " \n",
- " \n",
- " \n",
- " \n",
" \n",
- " - \n",
- " 0\n",
- " -52.916275\n",
+ "
- \n",
+ " href\n",
+ " \"./addresses-address-2024-12-18.0-part-00000-de803747-d78d-4060-b3da-da6dcd5dbab8-c000/addresses-address-2024-12-18.0-part-00000-de803747-d78d-4060-b3da-da6dcd5dbab8-c000.json\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " \n",
- " \n",
" \n",
" \n",
- " - \n",
- " 1\n",
- " 72.229798\n",
+ "
- \n",
+ " type\n",
+ " \"application/json\"\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
- " \n",
- " \n",
+ "
\n",
+ " \n",
" \n",
" \n",
"
\n",
@@ -713,39 +741,41 @@
" \n",
" \n",
" \n",
- " \n",
- " \n",
- " 1\n",
- " [] 2 items\n",
- "
\n",
- " \n",
+ " \n",
+ " \n",
+ " 3
\n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 0\n",
- " -52.301599\n",
+ "
- \n",
+ " rel\n",
+ " \"self\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " \n",
+ " \n",
+ " \n",
+ " - \n",
+ " href\n",
+ " \"/home/henry/workspace/stactools-packages/overture-maps/examples/overture-maps-addresses/collection.json\"\n",
+ "
\n",
+ " \n",
+ " \n",
" \n",
" \n",
" \n",
- " - \n",
- " 1\n",
- " 74.613784\n",
+ "
- \n",
+ " type\n",
+ " \"application/json\"\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
- " \n",
- " \n",
+ " \n",
+ " \n",
" \n",
" \n",
"
\n",
@@ -753,112 +783,136 @@
" \n",
" \n",
" \n",
- " \n",
- " \n",
- " 2\n",
- " [] 2 items\n",
- "
\n",
- " \n",
+ " \n",
+ " \n",
+ " 4
\n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 0\n",
- " -61.287624\n",
+ "
- \n",
+ " rel\n",
+ " \"parent\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
+ " \n",
+ " \n",
+ " - \n",
+ " href\n",
+ " \"/home/henry/workspace/stactools-packages/overture-maps/examples/catalog.json\"\n",
+ "
\n",
+ " \n",
+ " \n",
" \n",
- " \n",
+ " \n",
+ " \n",
+ " - \n",
+ " type\n",
+ " \"application/json\"\n",
+ "
\n",
+ " \n",
+ " \n",
" \n",
" \n",
" \n",
- " - \n",
- " 1\n",
- " 74.622043\n",
+ "
- \n",
+ " title\n",
+ " \"Overture Maps\"\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
- " \n",
- " \n",
+ " \n",
+ " \n",
" \n",
" \n",
"
\n",
" \n",
- " \n",
+ " \n",
" \n",
- " \n",
- " \n",
- " 3\n",
- " [] 2 items\n",
- "
\n",
+ " \n",
+ " \n",
+ " stac_extensions[] 1 items
\n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 0\n",
- " -60.726346\n",
+ "
- \n",
+ " 0\n",
+ " \"https://stac-extensions.github.io/item-assets/v1.0.0/schema.json\"\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
" \n",
- " \n",
+ " \n",
" \n",
" \n",
- " - \n",
- " 1\n",
- " 72.236891\n",
+ " \n",
+ "
- \n",
+ " overture:theme\n",
+ " \"addresses\"\n",
"
\n",
" \n",
+ " \n",
" \n",
+ " \n",
+ " \n",
+ " \n",
+ " item_assets
\n",
+ " \n",
- " \n",
- " \n",
" \n",
- " \n",
- "
\n",
- " \n",
+ " \n",
+ " \n",
+ " data
\n",
" \n",
" \n",
" \n",
- " \n",
- " \n",
- " 4\n",
- " [] 2 items\n",
- "
\n",
+ " \n",
+ " - \n",
+ " title\n",
+ " \"Geoparquet partition\"\n",
+ "
\n",
+ " \n",
+ " \n",
" \n",
- " \n",
+ " \n",
+ " \n",
+ " - \n",
+ " description\n",
+ " \"Geoparquet partition\"\n",
+ "
\n",
+ " \n",
+ " \n",
" \n",
" \n",
" \n",
- " - \n",
- " 0\n",
- " -52.916275\n",
+ "
- \n",
+ " type\n",
+ " \"application/x-parquet\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
+ " \n",
+ " \n",
+ " roles[] 1 items
\n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 1\n",
- " 72.229798\n",
+ "
- \n",
+ " 0\n",
+ " \"data\"\n",
"
\n",
" \n",
" \n",
@@ -869,13 +923,8 @@
" \n",
" \n",
"
\n",
- " \n",
- " \n",
- " \n",
- " \n",
- "
\n",
- " \n",
- " \n",
+ " \n",
+ " \n",
" \n",
" \n",
"
\n",
@@ -884,105 +933,85 @@
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " links\n",
- " [] 4 items\n",
- "
\n",
- " \n",
+ " \n",
+ " \n",
+ " extent
\n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " 0
\n",
+ " spatial
\n",
" \n",
" \n",
" \n",
- " \n",
- " - \n",
- " rel\n",
- " \"root\"\n",
- "
\n",
- " \n",
- " \n",
+ " \n",
+ " bbox[] 1 items
\n",
" \n",
- " \n",
- " \n",
- " - \n",
- " href\n",
- " \"/Users/gadomski/Code/stactools-packages/template/examples/collection.json\"\n",
- "
\n",
- " \n",
- " \n",
+ " \n",
" \n",
" \n",
- " \n",
- " - \n",
- " type\n",
- " \"application/json\"\n",
- "
\n",
- " \n",
- " \n",
+ " \n",
+ " 0[] 4 items
\n",
+ " \n",
+ " \n",
" \n",
" \n",
" \n",
- " - \n",
- " title\n",
- " \"Example collection\"\n",
+ "
- \n",
+ " 0\n",
+ " -176.874527\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
- " \n",
- " \n",
- " \n",
- " \n",
- "
\n",
- " \n",
- " \n",
" \n",
- " \n",
- " \n",
- " \n",
- " 1
\n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " rel\n",
- " \"collection\"\n",
+ "
- \n",
+ " 1\n",
+ " -53.234018\n",
"
\n",
" \n",
" \n",
" \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
" \n",
" \n",
- " - \n",
- " href\n",
- " \"../collection.json\"\n",
+ "
- \n",
+ " 2\n",
+ " -45.000027\n",
"
\n",
" \n",
" \n",
" \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
" \n",
" \n",
- " - \n",
- " type\n",
- " \"application/json\"\n",
+ "
- \n",
+ " 3\n",
+ " -17.522077\n",
"
\n",
" \n",
" \n",
" \n",
+ "
\n",
+ " \n",
+ " \n",
" \n",
- " \n",
- " - \n",
- " title\n",
- " \"Example collection\"\n",
- "
\n",
- " \n",
+ " \n",
+ "
\n",
+ " \n",
+ " \n",
" \n",
" \n",
"
\n",
@@ -990,96 +1019,126 @@
" \n",
" \n",
" \n",
- "
\n",
- " \n",
- " \n",
- " \n",
" \n",
" \n",
" \n",
- " 2
\n",
+ " temporal
\n",
" \n",
" \n",
" \n",
- " \n",
- " - \n",
- " rel\n",
- " \"self\"\n",
- "
\n",
- " \n",
+ " \n",
+ " interval[] 1 items
\n",
+ " \n",
+ " \n",
+ " \n",
" \n",
+ " \n",
+ " 0[] 2 items
\n",
+ " \n",
+ " \n",
" \n",
" \n",
" \n",
- " - \n",
- " href\n",
- " \"/Users/gadomski/Code/stactools-packages/template/examples/example-item/example-item.json\"\n",
+ "
- \n",
+ " 0\n",
+ " \"2024-01-18T00:12:00Z\"\n",
"
\n",
" \n",
" \n",
" \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
" \n",
" \n",
- " - \n",
- " type\n",
- " \"application/json\"\n",
+ "
- \n",
+ " 1\n",
+ " \"2024-01-18T00:12:00Z\"\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
- " \n",
- " \n",
+ " \n",
+ "
\n",
" \n",
" \n",
"
\n",
" \n",
- " \n",
+ " \n",
" \n",
+ "
\n",
+ " \n",
+ " \n",
" \n",
- " \n",
- " \n",
- " 3
\n",
- " \n",
+ " \n",
+ " \n",
+ " \n",
" \n",
" \n",
- " \n",
- " rel\n",
- " \"parent\"\n",
+ " \n",
+ " \n",
+ " license\n",
+ " \"various\"\n",
" \n",
" \n",
+ " \n",
" \n",
+ " \n",
+ " \n",
+ " keywords[] 4 items
\n",
+ " \n",
+ " \n",
" \n",
" \n",
" \n",
- " - \n",
- " href\n",
- " \"/Users/gadomski/Code/stactools-packages/template/examples/collection.json\"\n",
+ "
- \n",
+ " 0\n",
+ " \"overture\"\n",
"
\n",
" \n",
" \n",
" \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
" \n",
" \n",
- " - \n",
- " type\n",
- " \"application/json\"\n",
+ "
- \n",
+ " 1\n",
+ " \"geoparquet\"\n",
"
\n",
" \n",
" \n",
" \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
" \n",
" \n",
- " - \n",
- " title\n",
- " \"Example collection\"\n",
+ "
- \n",
+ " 2\n",
+ " \"address\"\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
- " \n",
+ " \n",
+ " \n",
+ " \n",
+ " \n",
+ " \n",
+ " - \n",
+ " 3\n",
+ " \"addresses\"\n",
+ "
\n",
" \n",
" \n",
" \n",
@@ -1089,40 +1148,37 @@
" \n",
" \n",
" \n",
- " \n",
- " \n",
- " assets
\n",
+ " \n",
+ " providers[] 2 items
\n",
+ " \n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " data
\n",
+ " 0
\n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " href\n",
- " \"../../tests/data/asset.tif\"\n",
+ "
- \n",
+ " name\n",
+ " \"Overture Maps Foundation\"\n",
"
\n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " \n",
- " roles\n",
- " [] 1 items\n",
- "
\n",
+ " roles[] 1 items
\n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 0\n",
- " \"data\"\n",
+ "
- \n",
+ " 0\n",
+ " \"producer\"\n",
"
\n",
" \n",
" \n",
@@ -1132,32 +1188,18 @@
"
\n",
" \n",
" \n",
- "
\n",
- " \n",
+ " \n",
+ " \n",
+ " - \n",
+ " url\n",
+ " \"https://overturemaps.org/\"\n",
+ "
\n",
" \n",
" \n",
" \n",
"
\n",
" \n",
" \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " bbox\n",
- " [] 4 items\n",
- "
\n",
- " \n",
- " \n",
- " \n",
- " \n",
- " \n",
- " - \n",
- " 0\n",
- " -61.287624\n",
- "
\n",
- " \n",
" \n",
" \n",
"
\n",
@@ -1166,35 +1208,30 @@
" \n",
" \n",
" \n",
- " - \n",
- " 1\n",
- " 72.229798\n",
- "
\n",
- " \n",
- " \n",
- " \n",
- "
\n",
- " \n",
+ " \n",
+ " 1
\n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 2\n",
- " -52.301599\n",
+ "
- \n",
+ " name\n",
+ " \"Microsoft\"\n",
"
\n",
" \n",
" \n",
" \n",
- "
\n",
+ " \n",
+ " \n",
+ " roles[] 1 items
\n",
" \n",
" \n",
" \n",
" \n",
" \n",
- " - \n",
- " 3\n",
- " 74.622043\n",
+ "
- \n",
+ " 0\n",
+ " \"host\"\n",
"
\n",
" \n",
" \n",
@@ -1202,90 +1239,38 @@
"
\n",
" \n",
" \n",
- " \n",
" \n",
- " \n",
- " \n",
- " \n",
- " stac_extensions\n",
- " [] 1 items\n",
- "
\n",
- " \n",
- " \n",
" \n",
" \n",
" \n",
- " - \n",
- " 0\n",
- " \"https://stac-extensions.github.io/projection/v1.1.0/schema.json\"\n",
+ "
- \n",
+ " url\n",
+ " \"https://microsoft.com\"\n",
"
\n",
" \n",
" \n",
" \n",
"
\n",
+ " \n",
+ " \n",
+ " \n",
+ " \n",
+ " \n",
" \n",
" \n",
" \n",
" \n",
- " \n",
- " \n",
- " \n",
- " collection\n",
- " \"example-collection\"\n",
- " \n",
- " \n",
- " \n",
- " \n",
" \n",
"