Address Standardization, Validation, and Geocoding
The Address Standardization, Validation, and Geocoding service standardizes and supplements your address data.
Address Standardization, Validation, and Geocoding is an updated version of the Address Enrichment service. It provides powerful, accurate address matching, and returns a Google Place ID for matching addresses, as well as location geocoding. Geocoding converts addresses (for example: 1600 Amphitheatre Parkway, Mountain View, CA) into geographic coordinates (for example: latitude 37.423021 and longitude -122.083739), which you can use to place markers or position the map.
Example: The only address information available in a record is “Superman building” in
address_line_1. The enrichment service returns an enriched full address, including geocoding, with only this limited information:
enriched_address_thoroughfare: Westminster Street
enriched_address_country_name: United States
enriched_full_address: 111 Westminster St, Providence, RI 02903, USA
Required Input Attributes for Address Standardization, Validation, and Geocoding
The input dataset for this enricher must include attributes that can be mapped to the following enrichment input fields.
|Input Field Name||Description|
|full_address||Full address. Provide the full address or an attribute that combines individual address components.|
|address_1||Street address line 1|
|address_2||Street address line 2|
|address_3||Street address line 3|
|region||Region, state, province, or county|
|postal_code||Zip or postal code|
|country||Country name or country code|
Output Attributes for Address Standardization, Validation, and Geocoding
The following attributes are provided by the enricher.
|Output Field Name||Description|
|enriched_address_premise||The primary location or building within a street address. It is the specific part of an address that identifies a particular property or building, such as a house, apartment complex, office building, or business establishment. The address premise is typically a numeric or alphanumeric value, such as a street number, that is used to uniquely identify a location within a street or thoroughfare.|
For example: 55
|enriched_address_thoroughfare||A street, road, or other main thoroughfare that is part of a complete address. It is the primary route or roadway that a property is located on. In other words, it is the name of the street or road that is associated with a specific address.|
For example, in the address "1234 Elm Street," "Elm Street" is the address thoroughfare. In some cases, the thoroughfare may include additional information, such as a highway number, direction (e.g., North, South, East, West), or other modifiers (e.g., Avenue, Boulevard) to further specify the location.
For example: Church Street
|enriched_address_region||Region, state, province, or county|
|enriched_address_postal_code_primary||The primary postal code used for a particular country.|
|enriched_address_postal_code_secondary||Secondary postal code information, if it is used in a particular country, the code can be determined, and reference data is available.|
For example: USA Zip Plus 4
|enriched_address_country_name||The ISO 3166 official country name.|
For example: United States
|enriched_address_country_code_2_character||The ISO 3166 2-character country code.|
For example: US
|enriched_full_address||The full formatted address.|
For example: 66 Church Street, Cambridge, MA, 02138, USA
|enriched_address_latitude||The WGS 84 latitude in decimal degrees format.|
For example: 41.3987282
|enriched_address_longitude||The WGS 84 longitude in decimal degrees format.|
For example: -70.5476654
|enriched_address_success||Whether the enricher successfully enriched the address data for this record (true/false).|
|enriched_google_place_id||Google Place ID, which uniquely identifies a place in the Google Places database and on Google Maps.|
In Google Maps and other Google APIs, a Place ID is a unique alphanumeric identifier for a specific geographic place or location, and represents a particular point of interest, such as a business, landmark, address, or point on the map. Place IDs are used by Google's geocoding and Places APIs to uniquely identify and retrieve information about a specific place. Place IDs are designed to be persistent and stable, meaning that they remain unchanged over time, even if the place's name, address, or other attributes change. Place IDs are commonly used in web and mobile applications to perform various location-related tasks, such as retrieving place details, displaying place markers on maps, calculating directions, and conducting place searches.
For example: ChIJCzYy5IS16lQRQrfeQ5K5Oxw
|enriched_address_location_type||The location type for the address enrichment results:|
rooftop: the result is based on a precise geocode
range_interpolated: the result is based on an approximation between two precise points, such as a road between intersections. This type generally indicates that rooftop geocodes are not available for this street address.
geometric_center: the result is the geometric center of a location, such as a street or region
approximate: the results are approximate
|enriched_address_match_type||Indicates what type of match was returned in cases where enrichment was successful:|
single_match: the address was matched to a complete geocoding match
single_partial_match: some, but not all, of the address components were matched to a location. Partial matches may be returned, for example, if the street address does not exist within the locality, or when address components matches two or more locations in the same locality.
top_match: multiple matches were identified, and the top match was selected for the address
non_match_input_unknown: no match was identified for the address
non_match_blank_input: no match was returned due to blank/empty address information
Updated 9 days ago