google-maps-addressvalidation
Google Maps Addressvalidation API client library
What it is and what it does
This is Google's official Python client for the Address Validation API, a service that checks whether addresses are correct and deliverable. It wraps Google's gRPC and REST endpoints, handling authentication and serialization of address data automatically. You provide an address as input, and the API returns structured feedback on each component (street, city, postal code, etc.), a geocode if the address is valid, and a verdict on whether mail can be delivered there.
The library is built on google-api-core, google-auth, grpcio, proto-plus, protobuf, and google-geo-type for message handling, making it consistent with other Google Cloud Python clients. It requires Python 3.10 or later and is actively maintained. Setup involves creating a Google Cloud project, enabling the Address Validation API, and configuring authentication—typical for any Google Cloud service client.
Use it for:
- Validate user-entered addresses during checkout or registration to catch errors and reduce failed deliveries.
- Batch-process mailing lists to identify undeliverable addresses before sending campaigns.
- Geocode addresses to latitude/longitude for mapping or location-based services.
- Verify business addresses in a directory or CRM to ensure data quality.
- Check address components for correctness in data pipelines.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Python client library for Google Maps Address Validation API that verifies address accuracy, parses components, returns geocodes, and assesses deliverability.
Yes, if you need to validate addresses at scale and are already using Google Cloud services. The library is actively maintained, has low install friction, and integrates seamlessly with Google Cloud authentication. Requires a billable Google Cloud project and API enablement; not suitable if you need offline validation or prefer a non-Google provider.
Install
google-maps-addressvalidation on PyPI
pip
pip install google-maps-addressvalidationuv
uv add google-maps-addressvalidationpoetry
poetry add google-maps-addressvalidationInstalling google-maps-addressvalidation
Before you install
Low install friction with a pure-wheel distribution. Maintained actively with recent releases; last commit 2026-08-14. Supports current Python versions (3.10+) and depends on standard Google Cloud libraries.
License in practice
Licensed under Apache-2.0 (permissive). You may use, modify, and distribute this package freely in commercial and private projects, provided you include a copy of the license and note any modifications.
Quickstart
pip install google-maps-addressvalidation
from google.maps import addressvalidation_v1
client = addressvalidation_v1.AddressValidationClient()
address = addressvalidation_v1.Address(address_lines=["example address"])
response = client.validate_address(address=address)
Requires Google Cloud project with Address Validation API enabled and valid authentication credentials (service account key or Application Default Credentials).
Verify before relying
- Whether the library handles rate limiting or retry logic automatically for API calls.
- Performance characteristics when validating large batches of addresses.
- Specific error handling patterns and exception types raised by the client.
- Concrete example code beyond the basic client instantiation pattern.
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 6 — google-api-core, google-auth, grpcio, proto-plus, protobuf, google-geo-type |
| Maintenance | actively maintained — 72 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 163,921/month — #10,562 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: google_maps_addressvalidation-0.7.0-py3-none-any.whl
Tags
More Internet packages
Botocore provides low-level, data-driven access…
permissive · top 100 on PyPI
aiobotocoreProvides an async client for AWS services using…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
filelockProvides a platform-independent file locking…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
googleapis-common-protosProvides common Protocol Buffer message…
permissive · top 100 on PyPI
google-maps-routingPython client library for the Google Maps…
permissive · top 15,000 on PyPI
smartystreets-python-sdkA client library for accessing SmartyStreets…
permissive · top 15,000 on PyPI
google-geo-typeProvides Python bindings for Google's Common…
permissive · top 15,000 on PyPI
google-maps-placesPython client library for Google Maps Places…
permissive · top 15,000 on PyPI
azure-maps-searchProvides a Python client for Azure Maps Search…
permissive · top 15,000 on PyPI
google-cloud-functionsPython client library for Google Cloud…
permissive · top 5,000 on PyPI
googlemapsPython client library that wraps Google Maps…
permissive · top 5,000 on PyPI
google-analytics-dataPython client library for querying Google…
permissive · top 5,000 on PyPI
google-cloud-api-keysManages API keys for Google Cloud projects,…
permissive · top 15,000 on PyPI
email-validatorValidates email address syntax and optionally…
permissive · top 1,000 on PyPI