The Address Validation API accepts an address, identifies its components and validates them, standardizes the address for mailing, and returns the best known latitude/longitude coordinates for it. For US and Puerto Rico addresses, you can optionally enable USPS CASS processing.

## Address Validation API: key facts

- **Product:** Address Validation API
- **Category:** Places
- **Platform:** Web service (REST)
- **Runs on:** Server (backend code)
- **Launch stage:** GA
- **Lifecycle:** Active
- **Overview:** [Address Validation API overview](https://developers.google.com/maps/documentation/address-validation/overview.md.txt)
- **Regional availability:** Limited. Supported countries and data quality vary by country, and some countries are in Preview. Residential and commercial metadata is returned only for countries flagged on the coverage page. USPS CASS is supported only for US and PR. ([coverage details](https://developers.google.com/maps/documentation/address-validation/coverage.md.txt))

## Address Validation API: when to use it

**Use Address Validation API when:**

- You need to check whether an address refers to a real place and find which components are missing or possibly wrong.
- You need to standardize and complete an address for mailing, for example during a checkout flow.
- You need USPS CASS-certified validation and `uspsData` for addresses in the US or Puerto Rico.
- You need residential or commercial address metadata for a country listed on the coverage page.
**Don't use Address Validation API when:**

- You only need to convert an address to latitude/longitude and don't need to validate individual address components. Use [Geocoding API](https://developers.google.com/maps/documentation/geocoding/quick-reference.md.txt) instead.
- You need hyper-local destination details such as building entrances, building outlines, or navigation points. Use [Geocoding API](https://developers.google.com/maps/documentation/geocoding/quick-reference.md.txt) instead.

## Address Validation API: setup

- **Service to enable:** `addressvalidation.googleapis.com`
- **Authentication:** API key, OAuth 2.0, Service account
- **Get started:** [Set up Address Validation API](https://developers.google.com/maps/documentation/address-validation/get-api-key.md.txt)
- **Reference:** [Address Validation API reference](https://developers.google.com/maps/documentation/address-validation/reference/rest.md.txt)
- **Pricing:** [Address Validation API usage and billing](https://developers.google.com/maps/documentation/address-validation/usage-and-billing.md.txt)
- **Policies:** [Address Validation API policies](https://developers.google.com/maps/documentation/address-validation/policies.md.txt)
- **Release notes:** [Address Validation API release notes](https://developers.google.com/maps/documentation/address-validation/release-notes.md.txt)

**Official Address Validation API packages:**

- npm: `@googlemaps/addressvalidation`
- pypi: `google-maps-addressvalidation`
- go: `cloud.google.com/go/maps`

## Address Validation API: common mistakes

- **Problem:** The `addressComplete` property is omitted from the verdict when its value is `false`, so code that expects the field to be present can misread incomplete addresses. **Fix:** Treat a missing `addressComplete` property as `false`, or check for the presence of the property. See [/maps/documentation/address-validation/understand-response](https://developers.google.com/maps/documentation/address-validation/understand-response.md.txt).
- **Problem:** If `regionCode` is omitted, the API infers the region from the address, which can give weaker results. **Fix:** Include `regionCode` in the `PostalAddress` when you know it. See [/maps/documentation/address-validation/requests-validate-address](https://developers.google.com/maps/documentation/address-validation/requests-validate-address.md.txt).
- **Problem:** The `uspsData` object isn't guaranteed to be fully populated for every validated US address. **Fix:** Don't rely on `uspsData` as the only validation signal; also use the verdict and address components. See [/maps/documentation/address-validation/handle-us-address](https://developers.google.com/maps/documentation/address-validation/handle-us-address.md.txt).
- **Problem:** Feedback sent with `provideValidationFeedback` must reference the `responseId` from the first `validateAddress` call in the sequence, not a later one. **Fix:** Store the `responseId` from the first `validateAddress` response and send it in the feedback request. See [/maps/documentation/address-validation/handle-updated-address](https://developers.google.com/maps/documentation/address-validation/handle-updated-address.md.txt).

## What you can do with Address Validation API

See the guides linked below for each task, or compare across products in the
[Capabilities Explorer](https://developers.google.com/maps/documentation/capabilities-explorer.md.txt).

- [Return a validated address for a specified address or partial address.](https://developers.google.com/maps/documentation/address-validation/requests-validate-address.md.txt)
- [Return the latitude/longitude coordinates for a validated address.](https://developers.google.com/maps/documentation/address-validation/understand-response.md.txt#geocode-property)
- [Return the Google place identifier for a validated address.](https://developers.google.com/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress.md.txt#geocode)
- [Use United States Postal Service (USPS) Coding Accuracy Support System (CASS) certification for address validation.](https://developers.google.com/maps/documentation/address-validation/requests-validate-address.md.txt#enable-cass)
- [Return information about whether a validated address is a business, residence, or PO box.](https://developers.google.com/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress.md.txt#addressmetadata)
- [Return United States Postal Service (USPS) delivery metadata for a validated address.](https://developers.google.com/maps/documentation/address-validation/handle-us-address.md.txt)
- [Return an English-language version of a validated address.](https://developers.google.com/maps/documentation/address-validation/convert-addresses-english.md.txt) Preview
- [Return the Plus Code for a validated address.](https://developers.google.com/maps/documentation/address-validation/understand-response.md.txt#geocode-property)