{"id":21393,"library":"google-maps-addressvalidation","title":"Google Maps Address Validation API Client","description":"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.","status":"active","version":"0.6.0","language":"python","source_language":"en","source_url":"https://github.com/googleapis/google-cloud-python/tree/main/packages/google-maps-addressvalidation","tags":["google-maps","address-validation","geocoding"],"install":[{"cmd":"pip install google-maps-addressvalidation","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core library for Google API client infrastructure.","package":"google-api-core","optional":false},{"reason":"Protobuf message handling.","package":"proto-plus","optional":false},{"reason":"Authentication via API key or service account.","package":"google-auth","optional":false}],"imports":[{"wrong":"from google.maps.addressvalidation_v1.services.address_validation import AddressValidationServiceClient","symbol":"AddressValidationServiceClient","correct":"from google.maps.addressvalidation_v1 import AddressValidationServiceClient"}],"quickstart":{"code":"import os\nfrom google.maps.addressvalidation_v1 import AddressValidationServiceClient, ValidateAddressRequest\n\nclient = AddressValidationServiceClient()\nrequest = ValidateAddressRequest(\n    address={\n        'region_code': 'US',\n        'locality': 'Mountain View',\n        'address_lines': ['1600 Amphitheatre Pkwy']\n    },\n    previous_response_id='',\n    enable_usps_cass=True\n)\nresponse = client.validate_address(request=request)\nprint(response.result.verdict)","lang":"python","description":"Quickstart to validate an address using the API. Requires setting GOOGLE_API_KEY environment variable or having ADC configured."},"warnings":[{"fix":"Upgrade to latest version when available.","message":"The library uses the v1 API, but some fields may be deprecated in future versions. Keep the library updated.","severity":"deprecated","affected_versions":"0.6.0"},{"fix":"Set the GOOGLE_API_KEY environment variable or run gcloud auth application-default login.","message":"Authentication 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.","severity":"gotcha","affected_versions":"all"},{"fix":"Verify the address dictionary structure matches the PostalAddress protobuf (see documentation).","message":"The 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.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'0.6.0':24 '3.9':27 'access':17 'address':3,10,22,50 'address-valid':49 'api':5,12,44 'cadenc':39 'client':6,13 'cloud':35 'geocod':21,52 'googl':1,8,34,47 'google-cloud-python':33 'google-map':46 'irregular':41 'librari':14 'map':2,9,48 'monorepo':37 'part':30 'programmat':16 'provid':15 'python':26,36 'releas':38 'requir':25 'tie':42 'updat':45 'valid':4,11,19,51 'version':23","created_at":"2026-04-27T16:59:40.059959+00:00","updated_at":"2026-04-27T16:59:40.059959+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'AddressValidationServiceClient' from 'google.maps.addressvalidation_v1' (/tmp/tmp33lu8fbs/venv/lib/python3.12/site-packages/google/maps/addressvalidation_v1/__init__.py). Did you mean: 'Address"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.7.0","cli_name":"","cli_version":null,"type":"library","homepage":"https://developers.google.com/maps/documentation/address-validation","github":"https://github.com/googleapis/google-cloud-python","docs":null,"changelog":null,"pypi":"https://pypi.org/project/google-maps-addressvalidation/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["gcp"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}