Get Started Contact sales

    Address Validation (beta)

    AddressValidation class

    google.maps.addressValidation . AddressValidation class

    Static class for accessing the AddressValidation APIs.

    Access by calling const {AddressValidation} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    address
    Type: Address optional
    Information about the address itself as opposed to the geocode.
    geocode
    Type: Geocode optional
    Information about the location and place that the address geocoded to.
    metadata
    Type: AddressMetadata optional
    Other information relevant to deliverability. metadata is not guaranteed to be fully populated for every address sent to the Address Validation API.
    responseId
    Type: string optional
    The UUID that identifies this response. If the address needs to be re-validated, this UUID must accompany the new request.
    uspsData
    Type: USPSData optional
    Extra deliverability flags provided by USPS. Only provided in region US and PR .
    verdict
    Type: Verdict optional
    Overall verdict flags
    toJSON
    toJSON()
    Parameters:  None
    Return Value: Object
    Converts the AddressValidation class to a JSON object with the same properties.

    AddressValidationRequest interface

    google.maps.addressValidation . AddressValidationRequest interface

    Request interface for AddressValidation.fetchAddressValidation .
    address
    The address being validated. Unformatted addresses should be submitted via PostalAddress.addressLines .
    placeAutocompleteElement optional
    Type: PlaceAutocompleteElement optional
    If using a PlaceAutocompleteElement, include it here to link the AddressValidation API calls with the autocomplete session token.
    previousResponseId optional
    Type: string optional
    This field must not be set for the first address validation request. If more requests are necessary to fully validate a single address (for example if the changes the user makes after the initial validation need to be re-validated), then each followup request must populate this field with the AddressValidation.responseId from the very first response in the validation sequence.
    sessionToken optional
    Type: AutocompleteSessionToken optional
    A token which identifies an Autocomplete session for billing purposes.
    uspsCASSEnabled optional
    Type: boolean optional
    Enables USPS CASS compatible mode. This affects only the AddressValidation.uspsData field of AddressValidation . Note: for USPS CASS enabled requests for addresses in Puerto Rico, a PostalAddress.regionCode of the address must be provided as "PR", or an PostalAddress.administrativeArea of the address must be provided as "Puerto Rico" (case-insensitive) or "PR".

    Address class

    google.maps.addressValidation . Address class

    Details of the post-processed address. Post-processing includes correcting misspelled parts of the address, replacing incorrect parts, and inferring missing parts.

    Access by calling const {Address} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    components
    The individual address components of the formatted and corrected address, along with validation information. This provides information on the validation status of the individual components.
    formattedAddress
    Type: string optional
    The post-processed address, formatted as a single-line address following the address-formatting rules of the region where the address is located.
    missingComponentTypes
    Type: Array <string>
    The types of components that were expected to be present in a correctly formatted mailing address but were not found in the input AND could not be inferred. Components of this type are not present in formatted_address , postal_address , or address_components . An example might be ['street_number', 'route'] for an input like "Boulder, Colorado, 80301, USA". The list of possible types can be found here .
    postalAddress
    Type: PostalAddress optional
    The post-processed address represented as a postal address.
    unconfirmedComponentTypes
    Type: Array <string>
    The types of the components that are present in the address_components but could not be confirmed to be correct. This field is provided for the sake of convenience: its contents are equivalent to iterating through the address_components to find the types of all the components where the AddressComponent.confirmationLevel is not ConfirmationLevel.CONFIRMED or the AddressComponent.inferred flag is not set to true . The list of possible types can be found here .
    unresolvedTokens
    Type: Array <string>
    Any tokens in the input that could not be resolved. This might be an input that was not recognized as a valid part of an address (for example in an input like "123235253253 Main St, San Francisco, CA, 94105", the unresolved tokens may look like ["123235253253"] since that does not look like a valid street number.

    AddressComponent class

    google.maps.addressValidation . AddressComponent class

    Represents a single component of an address (ex. street name, city).

    Access by calling const {AddressComponent} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    componentName
    Type: string optional
    The component name text. For example, "5th Avenue" for a street name or "1253" for a street number,
    componentNameLanguageCode
    Type: string optional
    The BCP-47 language code. This will not be present if the component name is not associated with a language, such as a street number.
    componentType
    Type: string optional
    The type of the address component. See Table 2: Additional types returned by the Places service for a list of possible types.
    confirmationLevel
    Type: ConfirmationLevel optional
    Indicates the level of certainty that the component is correct.
    inferred
    Type: boolean
    If true, this component was not part of the input, but was inferred for the address location. Including this component is recommended for a complete address.
    replaced
    Type: boolean
    Indicates the name of the component was replaced with a completely different one. For example, replacing a wrong postal code being with one that is correct for the address. This is not a cosmetic change; the input component has been changed to a different one.
    spellCorrected
    Type: boolean
    Indicates a correction to a misspelling in the component name. The API does not always flag changes from one spelling variant to another, such as "centre" to "center".
    unexpected
    Type: boolean
    If true, this component is not expected to be present in a postal address for the given region. It has been retained only because it was part of the input.

    AddressMetadata class

    google.maps.addressValidation . AddressMetadata class

    The metadata for the address. AddressMetadata is not guaranteed to be fully populated for every address sent to the Address Validation API.

    Access by calling const {AddressMetadata} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    business
    Type: boolean
    poBox
    Type: boolean
    residential
    Type: boolean

    ConfirmationLevel constants

    google.maps.addressValidation . ConfirmationLevel constants

    The different possible values indicating the level of certainty that the component is correct.

    Access by calling const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    CONFIRMED
    UNCONFIRMED_AND_SUSPICIOUS
    UNCONFIRMED_BUT_PLAUSIBLE

    Geocode class

    google.maps.addressValidation . Geocode class

    Contains information about the place the input was geocoded to.

    Access by calling const {Geocode} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    bounds
    Type: LatLngBounds optional
    The bounds of the geocoded place.
    featureSizeMeters
    Type: number optional
    The size of the geocoded place, in meters. This is another measure of the coarseness of the geocoded location, but in physical size rather than in semantic meaning.
    location
    Type: LatLngAltitude optional
    The geocoded location of the input.
    placeId
    Type: string optional
    The Place ID of the geocoded place. Using Place is preferred over using addresses, latitude/longitude coordinates, or plus codes. Using coordinates for routing or calculating driving directions will always result in the point being snapped to the road nearest to those coordinates. This may not be a road that will quickly or safely lead to the destination and may not be near an access point to the property. Additionally, when a location is reverse geocoded, there is no guarantee that the returned address will match the original.
    placeTypes
    Type: Array <string>
    The type(s) of place that the input geocoded to. For example, ['locality', 'political'] . The full list of types can be found in the Geocoding API documentation .
    plusCode
    Type: PlusCode optional
    The plus code corresponding to the location .
    fetchPlace
    fetchPlace()
    Parameters:  None
    Return Value:  None
    Returns a Place representation of this Geocode. To get full place details, a call to place.fetchFields() should be made.

    Granularity constants

    google.maps.addressValidation . Granularity constants

    The various granularities that an address or a geocode can have. When used to indicate granularity for an address , these values indicate with how fine a granularity the address identifies a mailing destination. For example, an address such as "123 Main Street, Redwood City, CA, 94061" identifies a PREMISE while something like "Redwood City, CA, 94061" identifies a LOCALITY . However, if we are unable to find a geocode for "123 Main Street" in Redwood City, the geocode returned might be of LOCALITY granularity even though the address is more granular.

    Access by calling const {Granularity} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    BLOCK The address or geocode indicates a block. Only used in regions which have block-level addressing, such as Japan.
    OTHER All other granularities, which are bucketed together since they are not deliverable.
    PREMISE Building-level result.
    PREMISE_PROXIMITY A geocode that approximates the building-level location of the address.
    ROUTE The geocode or address is granular to route, such as a street, road, or highway.
    SUB_PREMISE Below-building level result, such as an apartment.

    PossibleNextAction constants

    google.maps.addressValidation . PossibleNextAction constants

    Offers an interpretive summary of the API response, intended to assist in determining a potential subsequent action to take. This field is derived from other fields in the API response and should not be considered as a guarantee of address accuracy or deliverability.

    Access by calling const {PossibleNextAction} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    ACCEPT The API response does not contain signals that warrant one of the other PossibleNextAction values. You might consider using the post-processed address without further prompting your customer, though this does not guarantee the address is valid, and the address might still contain corrections. It is your responsibility to determine if and how to prompt your customer, depending on your own risk assessment.
    CONFIRM One or more fields of the API response indicate potential minor issues with the post-processed address, for example the postal_code address component was replaced . Prompting your customer to review the address could help improve the quality of the address.
    CONFIRM_ADD_SUBPREMISES The API response indicates the post-processed address might be missing a subpremises. Prompting your customer to review the address and consider adding a unit number could help improve the quality of the address. The post-processed address might also have other minor issues. Note: this enum value can only be returned for US addresses.
    FIX One or more fields of the API response indicate a potential issue with the post-processed address, for example the verdict.validation_granularity is OTHER . Prompting your customer to edit the address could help improve the quality of the address.

    USPSAddress class

    google.maps.addressValidation . USPSAddress class

    USPS representation of a US address.

    Access by calling const {USPSAddress} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    city
    Type: string optional
    The city name.
    cityStateZipAddressLine
    Type: string optional
    The address line containing the city, state, and zip code.
    firm
    Type: string optional
    The name of the firm.
    firstAddressLine
    Type: string optional
    The first line of the address.
    secondAddressLine
    Type: string optional
    The second line of the address.
    state
    Type: string optional
    The 2-letter state code.
    urbanization
    Type: string optional
    The Puerto Rican urbanization name.
    zipCode
    Type: string optional
    The Postal code, e.g. "10009".
    zipCodeExtension
    Type: string optional
    The 4-digit postal code extension, e.g. "5023".

    USPSData class

    google.maps.addressValidation . USPSData class

    The USPS data for the address. USPSData is not guaranteed to be fully populated for every US or PR address sent to the Address Validation API. It's recommended to integrate the backup address fields in the response if you utilize uspsData as the primary part of the response.

    Access by calling const {USPSData} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    abbreviatedCity
    Type: string optional
    Abbreviated city.
    addressRecordType
    Type: string optional
    Type of the address record that matches the input address.
    carrierRoute
    Type: string optional
    The carrier route code. A four character code consisting of a one letter prefix and a three digit route designator.
    carrierRouteIndicator
    Type: string optional
    Carrier route rate sort indicator.
    cassProcessed
    Type: boolean
    Indicator that the request has been CASS processed.
    county
    Type: string optional
    County name.
    deliveryPointCheckDigit
    Type: string optional
    The delivery point check digit. This number is added to the end of the delivery_point_barcode for mechanically scanned mail. Adding all the digits of the delivery_point_barcode, delivery_point_check_digit, postal code, and ZIP+4 together should yield a number divisible by 10.
    deliveryPointCode
    Type: string optional
    The 2-digit delivery point code.
    dpvCMRA
    Type: string optional
    Indicates if the address is a CMRA (Commercial Mail Receiving Agency)--a private business receiving mail for clients. Returns a single character.
    dpvConfirmation
    Type: string optional
    The possible values for DPV confirmation. Returns a single character or returns no value.
    dpvDoorNotAccessible
    Type: string optional
    Flag indicates addresses where USPS cannot knock on a door to deliver mail. Returns a single character.
    dpvDrop
    Type: string optional
    Flag indicates mail is delivered to a single receptable at a site. Returns a single character.
    dpvEnhancedDeliveryCode
    Type: string optional
    Indicates that more than one DPV return code is valid for the address. Returns a single character.
    dpvFootnote
    Type: string optional
    The footnotes from delivery point validation. Multiple footnotes may be strung together in the same string.
    dpvNonDeliveryDays
    Type: string optional
    Flag indicates mail delivery is not performed every day of the week. Returns a single character.
    dpvNonDeliveryDaysValues
    Type: number optional
    Integer identifying non-delivery days. It can be interrogated using bit flags: 0x40 – Sunday is a non-delivery day 0x20 – Monday is a non-delivery day 0x10 – Tuesday is a non-delivery day 0x08 – Wednesday is a non-delivery day 0x04 – Thursday is a non-delivery day 0x02 – Friday is a non-delivery day 0x01 – Saturday is a non-delivery day
    dpvNoSecureLocation
    Type: string optional
    Flag indicates door is accessible, but package will not be left due to security concerns. Returns a single character.
    dpvNoStat
    Type: string optional
    Indicates whether the address is a no stat address or an active address. No stat addresses are ones which are not continuously occupied or addresses that the USPS does not service. Returns a single character.
    dpvNoStatReasonCode
    Type: number optional
    Indicates the NoStat type. Returns a reason code as int.
    dpvPBSA
    Type: string optional
    Indicates the address was matched to PBSA record. Returns a single character.
    dpvThrowback
    Type: string optional
    Indicates that mail is not delivered to the street address. Returns a single character.
    dpvVacant
    Type: string optional
    Indicates whether the address is vacant. Returns a single character.
    elotFlag
    Type: string optional
    eLOT Ascending/Descending Flag (A/D).
    elotNumber
    Type: string optional
    Enhanced Line of Travel (eLOT) number.
    errorMessage
    Type: string optional
    Error message for USPS data retrieval. This is populated when USPS processing is suspended because of the detection of artificially created addresses.
    fipsCountyCode
    Type: string optional
    FIPS county code.
    hasDefaultAddress
    Type: boolean
    Indicator that a default address was found, but more specific addresses exist.
    hasNoEWSMatch
    Type: boolean
    The delivery address is matchable, but the EWS file indicates that an exact match will be available soon.
    lacsLinkIndicator
    Type: string optional
    LACSLink indicator.
    lacsLinkReturnCode
    Type: string optional
    LACSLink return code.
    pmbDesignator
    Type: string optional
    PMB (Private Mail Box) unit designator.
    pmbNumber
    Type: string optional
    PMB (Private Mail Box) number.
    poBoxOnlyPostalCode
    Type: boolean
    PO Box only postal code.
    postOfficeCity
    Type: string optional
    Main post office city.
    postOfficeState
    Type: string optional
    Main post office state.
    standardizedAddress
    Type: USPSAddress optional
    USPS standardized address.
    suiteLinkFootnote
    Type: string optional
    Footnotes from matching a street or highrise record to suite information. If business name match is found, the secondary number is returned.

    Verdict class

    google.maps.addressValidation . Verdict class

    Represents the post-processed address for the supplied address.

    Access by calling const {Verdict} = await google.maps.importLibrary("addressValidation") .See Libraries in the Maps JavaScript API .
    addressComplete
    Type: boolean
    The address is considered complete if there are no unresolved tokens, no unexpected or missing address components. If unset, indicates that the value is false . See Address.missingComponentTypes , Address.unresolvedTokens or AddressComponent.unexpected fields for more details.
    geocodeGranularity
    Type: Granularity optional
    Information about the granularity of the Geocode . This can be understood as the semantic meaning of how coarse or fine the geocoded location is.
    hasInferredComponents
    Type: boolean
    At least one address component was inferred (i.e. added) that wasn't in the input, see AddressComponent for details.
    hasReplacedComponents
    Type: boolean optional
    At least one address component was replaced - see AddressComponent for details.
    hasUnconfirmedComponents
    Type: boolean
    At least one address component cannot be categorized or validated, see AddressComponent for details.
    inputGranularity
    Type: Granularity optional
    The granularity of the inputaddress. This is the result of parsing the input address and does not give any validation signals. For validation signals, refer to validationGranularity .
    possibleNextAction
    Type: PossibleNextAction optional
    A possible next action to take based on other fields in the API response. See PossibleNextAction for details.
    validationGranularity
    Type: Granularity optional
    The granularity level that the API can fully validatethe address to. For example, a validationGranularity of PREMISE indicates all address components at the level of PREMISE and broader can be validated.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: