aioplaces
aioplaces is a standalone asynchronous Python client for Nominatim reverse geocoding and OSM feature lookup, Wikidata entity retrieval, and typed parsing of Nominatim place responses. Python 3.14 or newer is required.
Documentation
- Read the Docs: https://aioplaces.readthedocs.io
The documentation covers installation, quick start examples, client configuration, API reference, upstream usage policies, and development.
Releases
The publish workflow uses PyPI Trusted Publishing: stable GitHub Releases go to PyPI and prereleases go to TestPyPI.
Origin and license
Extracted from the Places Home Assistant integration. Credit belongs to the Places contributors. Licensed under GPL-3.0-only; see LICENSE.
Endpoint diagnostics
The scripts README documents manual tools for testing aioplaces client methods and inspecting raw Nominatim and Wikidata responses.
Changelog
0.1.1 (2026-10-11)
Features
Bug Fixes
- align beta release package version and explain validation failures (b19139d)
- ci: bootstrap release-please from v0.1.0 (#5) (14e9219)
- derive prerelease package versions from release tags (#9) (b19139d)
Documentation
- add Read the Docs site and API reference (#6) (a64f7db)
- simplify README and link to Read the Docs (#8) (bfc5919)
Miscellaneous Chores
- ci: update setup-uv to v10.2.0 (#7) (b6d92cc)
- release 0.1.1 (dc2c5c7)
- remove obsolete and unused repository configuration (#10) (bf3d9e2)
Continuous Integration
0.1.0
- Initial standalone async Nominatim/Wikidata client and typed Places response parser.
1 maintainer
Metadata
1 maintainer
Release files for aioplaces 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aioplaces-0.1.1.tar.gz | 44.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aioplaces-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 70.1 kB
Release files / aioplaces-0.1.1.tar.gz
| Download URL | aioplaces-0.1.1.tar.gz |
|---|---|
| Size | 44.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
36c40751029a6676c7c00ce71cc1560cb62ab12603a4636be5590e85bf2502fa
|
|
BLAKE2b-256 checksum How to use checksums |
291249e561066fffbc550c76415c7d19238d47cb97097b2ffab7cca92549f39f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency logRelease files / aioplaces-0.1.1-py3-none-any.whl
| Download URL | aioplaces-0.1.1-py3-none-any.whl |
|---|---|
| Size | 25.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5e57835a1c898a6292dabba0c51140ac07fee388173950b82cf82e73a368e446
|
|
BLAKE2b-256 checksum How to use checksums |
ba9043baccd1c4b629210faa55522e2b9cc622ef18bfdd6a93c8c8e99d13b6f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency log
