Address Validation API quick reference

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
  • 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)

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 instead.
  • You need hyper-local destination details such as building entrances, building outlines, or navigation points. Use Geocoding API instead.

Address Validation API: setup

Official Address Validation API packages:

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

Address Validation API: common mistakes

What you can do with Address Validation API

See the guides linked below for each task, or compare across products in the Capabilities Explorer.