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_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 enricher must include attributes that can be mapped to the following enrichment input fields.

Input Field NameDescription
full_addressFull address. Provide the full address or an attribute that combines individual address components.
address_1Street address line 1
address_2Street address line 2
address_3Street address line 3
cityCity
regionRegion, state, province, or county
postal_codeZip or postal code
countryCountry name or country code

Output Attributes for Address Standardization, Validation, and Geocoding

The following attributes are provided by the enricher.

Output Field NameDescription
enriched_address_premiseThe 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_thoroughfareA 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_cityCity
enriched_address_regionRegion, state, province, or county
enriched_address_postal_code_primaryThe primary postal code used for a particular country.

For example:
USA Zip
Canadian Postcode
Indian PINcode
enriched_address_postal_code_secondarySecondary 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_nameThe ISO 3166 official country name.

For example: United States
enriched_address_country_code_2_characterThe ISO 3166 2-character country code.

For example: US
enriched_full_addressThe full formatted address.

For example: 66 Church Street, Cambridge, MA, 02138, USA
enriched_address_latitudeThe WGS 84 latitude in decimal degrees format.

For example: 41.3987282
enriched_address_longitudeThe WGS 84 longitude in decimal degrees format.

For example: -70.5476654
enriched_address_successWhether the enricher successfully enriched the address data for this record (true/false).
enriched_google_place_idGoogle 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_typeThe 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_typeIndicates 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