Address Standardization, Validation, and Geocoding is an updated version of the Address 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.

This service is included without additional licensing in the following data product templates:

B2B Customers
B2B Customers with Firmographics
B2C Customers
Contacts
Healthcare Providers
Patients

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.primary.premise: 111
enriched_address.primary.thoroughfare: Westminster Street
enriched_address.primary.city: Providence
enriched_address.primary.region: RI
enriched_address.primary.country_name: United States
enriched_address.primary.latitude: 41.8244519
enriched_address.primary.longitude: -71.4111502
enriched_address.primary.location_type: rooftop
enriched_address.primary.full_address: 111 Westminster St, Providence, RI 02903, USA

Required Input Attributes for Address Standardization, Validation, and Geocoding

The input dataset for this service must include attributes that can be mapped to the following enrichment input fields.

Input Attribute 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
city	City
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 this service.

Output Attribute Name	Description
enriched_address.<address_type>.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.<address_type>.sub_premise	An addressable entity below the premise level, such as an apartment, unit, or suite.
enriched_address.<address_type>.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.<address_type>.neighborhood	A named neighborhood.
enriched_address.<address_type>._city	City
enriched_address.<address_type>.region	Region, state, province, or county
enriched_address.<address_type>.postal_code_primary	The primary postal code used for a particular country. For example: USA Zip Canadian Postcode Indian PINcode
enriched_address.<address_type>.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.<address_type>.country_name	The ISO 3166 official country name. For example: United States
enriched_address.<address_type>.country_code_2_character	The ISO 3166 2-character country code. For example: US
enriched_address.<address_type>.full_address	The full formatted address. For example: 66 Church Street, Cambridge, MA, 02138, USA
enriched_address.<address_type>.latitude	The WGS 84 latitude in decimal degrees format. For example: 41.3987282
enriched_address.<address_type>.longitude	The WGS 84 longitude in decimal degrees format. For example: -70.5476654
enriched_address.<address_type>.success	Returns false if the enricher encountered an unrecoverable error, such as the request is missing a required field or the service returns a 500 error. Otherwise, returns true.
enriched_address.<address_type>.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.<address_type>.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.<address_type>._match_type	Indicates what type of match was returned in cases where enrichment was successful: single_match: the address was matched to a single 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-ranked 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