Registry / gcp / google-maps-addressvalidation

google-maps-addressvalidation

JSON →
library0.7.0pypypiunverified

The Google Maps Address Validation API client library provides programmatic access to validate and geocode addresses. Version 0.6.0 requires Python 3.9+ and is part of the google-cloud-python monorepo. Release cadence is irregular, tied to API updates.

pip install google-maps-addressvalidation
INSTALL
IMPORT
SIG · GOOGLE-MAPS-ADDRES
G
google-maps-addressvalidation
gcppythonv0.7.0
Install
5.3s avg
Import
Disk
66MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.7.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 68MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 5.3s · import 0.000s · 66MB
66MB installed
● package 66MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

AddressValidationServiceClient
from google.maps.addressvalidation_v1 import AddressValidationServiceClient
from google.maps.addressvalidation_v1.services.address_validation import AddressValidationServiceClient

Quickstart to validate an address using the API. Requires setting GOOGLE_API_KEY environment variable or having ADC configured.

import os from google.maps.addressvalidation_v1 import AddressValidationServiceClient, ValidateAddressRequest client = AddressValidationServiceClient() request = ValidateAddressRequest( address={ 'region_code': 'US', 'locality': 'Mountain View', 'address_lines': ['1600 Amphitheatre Pkwy'] }, previous_response_id='', enable_usps_cass=True ) response = client.validate_address(request=request) print(response.result.verdict)
Debug
Known issues
deprecatedThe library uses the v1 API, but some fields may be deprecated in future versions. Keep the library updated.
fix
Upgrade to latest version when available.
affects: 0.6.0
gotchaAuthentication requires either an API key set in the GOOGLE_API_KEY environment variable or Application Default Credentials (ADC). Not setting one results in a permission denied error.
fix
Set the GOOGLE_API_KEY environment variable or run gcloud auth application-default login.
affects: all
gotchaThe address field in ValidateAddressRequest expects a dictionary with specific keys (e.g., region_code, address_lines). Using wrong keys or nesting returns a validation error.
fix
Verify the address dictionary structure matches the PostalAddress protobuf (see documentation).
affects: all
Upgrade
Version history
0.7.0latest on PyPI · released Jun 3, 2026
Audit
Dependencies
google-api-corerequiredCore library for Google API client infrastructure.
proto-plusrequiredProtobuf message handling.
google-authrequiredAuthentication via API key or service account.
Agent activity
22 hits · last 30 days
node
18
Amazon
1
OpenAI (training)
1
Resources
google-maps-addressvalidation — pip install google-maps-addressvalidation · libregistry