Stay organized with collections Save and categorize content based on your preferences.
AddressValidation classgoogle.maps.addressValidation.AddressValidation
class
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type:Address optional
Information about the address itself as opposed to the geocode.
geocode
Notice: Available only in the v=beta channel.
Type:Geocode optional
Information about the location and place that the address geocoded to.
metadata
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type:USPSData optional
Extra deliverability flags provided by USPS. Only provided in region US
and PR
.
verdict
Notice: Available only in the v=beta channel.
Type:Verdict optional
Overall verdict flags
MethodstoJSON
Notice: Available only in the v=beta channel.
toJSON()
Parameters: None
Return Value:Object
Converts the AddressValidation class to a JSON object with the same properties.
Address classgoogle.maps.addressValidation.Address
class
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type:Array<AddressComponent>
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
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type:PostalAddress optional
The post-processed address represented as a postal address.
unconfirmedComponentTypes
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
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.
google.maps.addressValidation.AddressComponent
class
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type: string optional
The component name text. For example, "5th Avenue" for a street name or "1253" for a street number,
componentNameLanguageCode
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type: string optional
The type of the address component. See
Table 2: Additional types returned by the Places servicefor a list of possible types.
confirmationLevel
Notice: Available only in the v=beta channel.
Type:ConfirmationLevel optional
Indicates the level of certainty that the component is correct.
inferred
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
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.
google.maps.addressValidation.AddressMetadata
class
Notice: Available only in the v=beta channel.
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.
google.maps.addressValidation.ConfirmationLevel
constants
Notice: Available only in the v=beta channel.
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.
google.maps.addressValidation.Geocode
class
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type:LatLngBounds optional
The bounds of the geocoded place.
featureSizeMeters
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type:LatLngAltitude optional
The geocoded location of the input.
placeId
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type:PlusCode optional
The plus code corresponding to the location
.
fetchPlace
Notice: Available only in the v=beta channel.
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 constantsgoogle.maps.addressValidation.Granularity
constants
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
The address or geocode indicates a block. Only used in regions which have block-level addressing, such as Japan.OTHER
Notice: Available only in the v=beta channel.
All other granularities, which are bucketed together since they are not deliverable.PREMISE
Notice: Available only in the v=beta channel.
Building-level result.PREMISE_PROXIMITY
Notice: Available only in the v=beta channel.
A geocode that approximates the building-level location of the address.ROUTE
Notice: Available only in the v=beta channel.
The geocode or address is granular to route, such as a street, road, or highway.SUB_PREMISE
Notice: Available only in the v=beta channel.
Below-building level result, such as an apartment. USPSData classgoogle.maps.addressValidation.USPSData
class
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type: string optional
Abbreviated city.
addressRecordType
Notice: Available only in the v=beta channel.
Type: string optional
Type of the address record that matches the input address.
carrierRoute
Notice: Available only in the v=beta channel.
Type: string optional
The carrier route code. A four character code consisting of a one letter prefix and a three digit route designator.
carrierRouteIndicator
Notice: Available only in the v=beta channel.
Type: string optional
Carrier route rate sort indicator.
cassProcessed
Notice: Available only in the v=beta channel.
Type: boolean
Indicator that the request has been CASS processed.
county
Notice: Available only in the v=beta channel.
Type: string optional
County name.
deliveryPointCheckDigit
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type: string optional
The 2-digit delivery point code.
dpvCMRA
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type: string optional
The possible values for DPV confirmation. Returns a single character or returns no value.
dpvDoorNotAccessible
Notice: Available only in the v=beta channel.
Type: string optional
Flag indicates addresses where USPS cannot knock on a door to deliver mail. Returns a single character.
dpvDrop
Notice: Available only in the v=beta channel.
Type: string optional
Flag indicates mail is delivered to a single receptable at a site. Returns a single character.
dpvEnhancedDeliveryCode
Notice: Available only in the v=beta channel.
Type: string optional
Indicates that more than one DPV return code is valid for the address. Returns a single character.
dpvNonDeliveryDays
Notice: Available only in the v=beta channel.
Type: string optional
Flag indicates mail delivery is not performed every day of the week. Returns a single character.
dpvNonDeliveryDaysValues
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type: string optional
Flag indicates door is accessible, but package will not be left due to security concerns. Returns a single character.
dpvNoStat
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type: number optional
Indicates the NoStat type. Returns a reason code as int.
dpvPBSA
Notice: Available only in the v=beta channel.
Type: string optional
Indicates the address was matched to PBSA record. Returns a single character.
dpvThrowback
Notice: Available only in the v=beta channel.
Type: string optional
Indicates that mail is not delivered to the street address. Returns a single character.
dpvVacant
Notice: Available only in the v=beta channel.
Type: string optional
Indicates whether the address is vacant. Returns a single character.
elotFlag
Notice: Available only in the v=beta channel.
Type: string optional
eLOT Ascending/Descending Flag (A/D).
elotNumber
Notice: Available only in the v=beta channel.
Type: string optional
Enhanced Line of Travel (eLOT) number.
errorMessage
Notice: Available only in the v=beta channel.
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
Notice: Available only in the v=beta channel.
Type: string optional
FIPS county code.
hasDefaultAddress
Notice: Available only in the v=beta channel.
Type: boolean
Indicator that a default address was found, but more specific addresses exist.
hasNoEWSMatch
Notice: Available only in the v=beta channel.
Type: boolean
The delivery address is matchable, but the EWS file indicates that an exact match will be available soon.
lacsLinkIndicator
Notice: Available only in the v=beta channel.
Type: string optional
LACSLink indicator.
lacsLinkReturnCode
Notice: Available only in the v=beta channel.
Type: string optional
LACSLink return code.
pmbDesignator
Notice: Available only in the v=beta channel.
Type: string optional
PMB (Private Mail Box) unit designator.
pmbNumber
Notice: Available only in the v=beta channel.
Type: string optional
PMB (Private Mail Box) number.
poBoxOnlyPostalCode
Notice: Available only in the v=beta channel.
Type: boolean
PO Box only postal code.
postOfficeCity
Notice: Available only in the v=beta channel.
Type: string optional
Main post office city.
postOfficeState
Notice: Available only in the v=beta channel.
Type: string optional
Main post office state.
standardizedAddress
Notice: Available only in the v=beta channel.
Type:USPSAddress optional
USPS standardized address.
Verdict classgoogle.maps.addressValidation.Verdict
class
Notice: Available only in the v=beta channel.
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-09 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-09 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4