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
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: 111enriched_address_thoroughfare: Westminster Streetenriched_address_city: Providenceenriched_address_region: RIenriched_address_country_name: United Statesenriched_address_latitude: 41.8244519enriched_address_longitude: -71.4111502enriched_address_location_type: rooftopenriched_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:
|
| enriched_address_match_type | Indicates what type of match was returned in cases where enrichment was successful:
|
Updated 3 months ago