You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sedona.apache.org by ji...@apache.org on 2026/10/14 06:55:09 UTC
(sedona-db) branch main updated: docs: point the programming guide's S3 example at a current Overture release (#1441)
This is an automated email from the ASF dual-hosted git repository.
jiayuasu pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/sedona-db.git
The following commit(s) were added to refs/heads/main by this push:
new a4d3d2950 docs: point the programming guide's S3 example at a current Overture release (#1441)
a4d3d2950 is described below
commit a4d3d295082c26dc62a5321c78aac2ae56f3bc43
Author: Jia Yu <ji...@wherobots.com>
AuthorDate: Tue Oct 13 23:55:04 2026 -0700
docs: point the programming guide's S3 example at a current Overture release (#1441)
---
docs/programming-guide.ipynb | 12 +++++++-----
docs/programming-guide.md | 10 ++++++----
2 files changed, 13 insertions(+), 9 deletions(-)
diff --git a/docs/programming-guide.ipynb b/docs/programming-guide.ipynb
index fba2f7236..2fffcf6d5 100644
--- a/docs/programming-guide.ipynb
+++ b/docs/programming-guide.ipynb
@@ -120,7 +120,9 @@
"source": [
"**Create SedonaDB DataFrame from files in S3**\n",
"\n",
- "For most production applications, you will create SedonaDB DataFrames by reading data from a file. Let's see how to read GeoParquet files in AWS S3 into a SedonaDB DataFrame."
+ "For most production applications, you will create SedonaDB DataFrames by reading data from a file. Let's see how to read GeoParquet files in AWS S3 into a SedonaDB DataFrame.\n",
+ "\n",
+ "> Overture removes old releases. See [this page](https://docs.overturemaps.org/release-calendar/#current-release) to see the latest version number and replace the relevant portion of the URL below."
]
},
{
@@ -131,7 +133,7 @@
"outputs": [],
"source": [
"sd.read_parquet(\n",
- " \"s3://overturemaps-us-west-2/release/2025-11-19.0/theme=divisions/type=division_area/\",\n",
+ " \"s3://overturemaps-us-west-2/release/2026-09-23.1/theme=divisions/type=division_area/\",\n",
" options={\"aws.skip_signature\": True, \"aws.region\": \"us-west-2\"},\n",
").to_view(\"division_area\")"
]
@@ -227,11 +229,11 @@
"│ country ┆ region ┆ geometry │\n",
"│ utf8 ┆ utf8 ┆ geometry │\n",
"╞═════════╪════════╪═══════════════════════════════════════════════════════════════════════════════╡\n",
- "│ CA ┆ CA-NB ┆ MULTIPOLYGON(((-67.1074147 44.4817314,-67.1058772 44.4815007,-67.104319 44.4… │\n",
+ "│ CA ┆ CA-NS ┆ POLYGON((-65.9481828 43.4398466,-66.0528452 43.4531336,-66.0883401 43.397818… │\n",
"├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤\n",
- "│ CA ┆ CA-NB ┆ POLYGON((-66.2598821 45.1380421,-66.2599962 45.1381233,-66.2600591 45.138285… │\n",
+ "│ CA ┆ CA-NS ┆ POLYGON((-66.0216384 43.518589,-66.0222822 43.5166842,-66.0252286 43.5100071… │\n",
"├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤\n",
- "│ CA ┆ CA-NB ┆ POLYGON((-66.4595418 45.2215004,-66.4595406 45.221468,-66.4595396 45.2213915… │\n",
+ "│ CA ┆ CA-NS ┆ POLYGON((-66.0341854 43.5998264,-66.033595 43.5985202,-66.0330826 43.5966887… │\n",
"└─────────┴────────┴───────────────────────────────────────────────────────────────────────────────┘\n"
]
}
diff --git a/docs/programming-guide.md b/docs/programming-guide.md
index b36e4a89b..224dbf0cb 100644
--- a/docs/programming-guide.md
+++ b/docs/programming-guide.md
@@ -72,10 +72,12 @@ type(df)
For most production applications, you will create SedonaDB DataFrames by reading data from a file. Let's see how to read GeoParquet files in AWS S3 into a SedonaDB DataFrame.
+> Overture removes old releases. See [this page](https://docs.overturemaps.org/release-calendar/#current-release) to see the latest version number and replace the relevant portion of the URL below.
+
```python
sd.read_parquet(
- "s3://overturemaps-us-west-2/release/2025-11-19.0/theme=divisions/type=division_area/",
+ "s3://overturemaps-us-west-2/release/2026-09-23.1/theme=divisions/type=division_area/",
options={"aws.skip_signature": True, "aws.region": "us-west-2"},
).to_view("division_area")
```
@@ -143,11 +145,11 @@ ns.show(3)
│ country ┆ region ┆ geometry │
│ utf8 ┆ utf8 ┆ geometry │
╞═════════╪════════╪═══════════════════════════════════════════════════════════════════════════════╡
- │ CA ┆ CA-NB ┆ MULTIPOLYGON(((-67.1074147 44.4817314,-67.1058772 44.4815007,-67.104319 44.4… │
+ │ CA ┆ CA-NS ┆ POLYGON((-65.9481828 43.4398466,-66.0528452 43.4531336,-66.0883401 43.397818… │
├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
- │ CA ┆ CA-NB ┆ POLYGON((-66.2598821 45.1380421,-66.2599962 45.1381233,-66.2600591 45.138285… │
+ │ CA ┆ CA-NS ┆ POLYGON((-66.0216384 43.518589,-66.0222822 43.5166842,-66.0252286 43.5100071… │
├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
- │ CA ┆ CA-NB ┆ POLYGON((-66.4595418 45.2215004,-66.4595406 45.221468,-66.4595396 45.2213915… │
+ │ CA ┆ CA-NS ┆ POLYGON((-66.0341854 43.5998264,-66.033595 43.5985202,-66.0330826 43.5966887… │
└─────────┴────────┴───────────────────────────────────────────────────────────────────────────────┘