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

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_premise: 111
  • enriched_address_thoroughfare: Westminster Street
  • enriched_address_city: Providence
  • enriched_address_region: RI
  • enriched_address_country_name: United States
  • enriched_address_latitude: 41.8244519
  • enriched_address_longitude: -71.4111502
  • enriched_address_location_type: rooftop
  • enriched_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_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_city City
enriched_address_region Region, state, province, or county
enriched_address_postal_code_primary The primary postal code used for a particular country.

For example: USA Zip Canadian Postcode Indian PINcode
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 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_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 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
enriched_address_types An array indicating the type of the address component. See Place Types for the list of supported address types.