---
id: google-maps-addressvalidation
version: "0.7.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# google-maps-addressvalidation — Google Maps Addressvalidation API client library

License: permissive · Maintenance: active · Downloads: 163.9K/mo

## 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 above — 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

pip install google-maps-addressvalidation
uv add google-maps-addressvalidation
poetry add google-maps-addressvalidation

## Installing 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_current
- Install friction: low
- Maintenance: active
- Downloads: 163.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

address validation api, verify address accuracy, geocode address, address parsing, deliverability check, google maps address, address verification python, google-cloud, geolocation, address-validation

[View on SkillFed](https://skillfed.io/packages/google-maps-addressvalidation) · [View on PyPI](https://pypi.org/project/google-maps-addressvalidation/)