Hello release notes!

This is the first time we're officially publishing release notes for overturemaps-py. Below is a very long list of changes that go all the way back to the creation of the CLI.

What's new?

STAC integration

overturemaps-py now uses Overture's STAC catalog by default to speed up queries. This significantly improves download performance and automatically grabs the latest release for you.

--stac (default): Uses the STAC catalog for faster, more efficient queries
--no-stac: Falls back to reading directly from S3 without STAC

GERS UUID lookup

gers [UUID]
Look up an ID in the GERS Registry. If the feature is present in the latest release, it will download the feature and write it out in the specified format.

Command-line options:

-f ("geojson", "geojsonseq", "geoparquet"): output format, defaults to geojsonseq for a single feature on one line.
--output/-o (optional): Location of output file. When omitted output will be written to stdout.
--connect_timeout (optional): Socket connection timeout, in seconds. If omitted, the AWS SDK default value is used (typically 1 second).
--request_timeout (optional): Socket read timeouts on Windows and macOS, in seconds. If omitted, the AWS SDK default value is used (typically 3 seconds). This option is ignored on non-Windows, non-macOS systems.

The full list of changes

Initial by @jwass in #1
Initial README docs by @jwass in #3
Geoparquet by @jwass in #4
Refactor record_batch_reader outside of cli by @jwass in #11
Fix link to Overture Foundation in Readme by @dldx in #15
add land_cover type and update to latest Overture Maps release by @danabauer in #21
update to point to the June Overture Maps release by @danabauer in #26
Add PyPI badge to Readme by @EwoutH in #27
Update README with conda install instructions by @owenlamont in #22
Bump to 2024-06-13-beta.1 hotfix by @brad-richardson in #30
Bump to July release by @jenningsanderson in #32
Geopandas by @brad-richardson in #33
Loosen dependencies, test across python versions by @brad-richardson in #34
sync schema 2024-07-22.0 by @helmi03 in #35
Add "covering" field for bbox support from GeoPandas read_parquet by @songololo in #41
August release path update by @jenningsanderson in #42
update release path by @danabauer in #45
Update to October by @jwass in #47
Bump to v0.10.0 by @jwass in #48
Bump version and data reference by @jwass in #54
add bathymetry data by @nickkieffer in #55
Bump version to Feb 2025 by @agh293-Ruddell in #59
Update to March and bump version by @jwass in #62
Bump version and date by @jwass in #65
add timeout options to cli/module by @darrenwiens in #57
chore: feature request: adding "release" as optional parameter by @MarcoPerniciaro-TomTom in #66
Speed up download times with STAC by @Rachmanin0xFF in #68
update release list by @danabauer in #69
bump to 0.17.0 by @danabauer in #70
Adds gers lookup capabilities by @jenningsanderson in #72
fix record_batch_reader params in geodataframe by @jeremy-costello in #71
Drop testing Python 3.8 since it was EOL 2024-10-07 by @chrowe in #77