The places data quality service enriches your business data with additional business information, such as operating hours, website, and more.

👋

Looking to use the Places data quality service?

Contact Tamr at [email protected].

The Places data quality service takes a company name and coordinates to search for nearby places that match the search constraint. The service will build a priority boundary around the coordinates based on the configured diameter.

Required Input Attributes for Places

The input dataset for this service must include attributes for company name, latitude, and longitude.

Output Attributes for Places

The following attributes are provided by this service.

Output Attribute Name Description
enriched_places_business_name Name of the business for the place.
enriched_places_formatted_address A string containing the human-readable address of this place.

Often, this address is equivalent to the postal address. Note that some countries, such as the United Kingdom, do not allow distribution of true postal addresses due to licensing restrictions.

The formatted address is logically composed of one or more address components. For example, the address "111 8th Avenue, New York, NY" consists of the following components: "111" (the street number), "8th Avenue" (the route), "New York" (the city) and "NY" (the US state).
enriched_places_latitude The geocode latitude for the place.
enriched_places_longitude The geocode longitude for the place.
enriched_places_summary A text summary describing the place.
enriched_places_business_status Indicates the operational status of the place, if it is a business. If no data exists, business_status is not returned.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY.
enriched_places_vicinity For establishment (types:["establishment", ...]) results only, the vicinity attribute contains a simplified address for the place, including the street name, street number, and locality, but not the province/state, postal code, or country.

For all other results, the vicinity attribute contains the name of the narrowest political (types:["political", ...]) feature that is present in the address of the result.
enriched_places_wheelchair_accessible_entrance Specifies if the place has an entrance that is wheelchair-accessible.
enriched_places_phone_number The phone number for the place.
enriched_places_opening_hours A string containing the regular opening hours for the business of the form [MONDAY 09:00 - MONDAY 17:00, TUESDAY 09:00 - TUESDAY 17:00, WEDNESDAY 09:00 - WEDNESDAY 17:00, THURSDAY 09:00 - THURSDAY 17:00, FRIDAY 09:00 - FRIDAY 17:00].
enriched_places_plus_global_code The global_code is a 4 character area code and 6 character or longer local code (849VCWC8+R9).
enriched_places_plus_compound_code The compound_code is a 6 character or longer local code with an explicit location (CWC8+R9, Mountain View, CA, USA). Some APIs may return an empty string if the compound_code is not available.
enriched_places_website_uri The authoritative website for this place, such as a business' homepage.
enriched_places_success Returns false if the enricher encountered an unrecoverable error, such as the request is missing a required attribute or the service returns a 500 error. Otherwise, returns true.
enriched_places_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
  • 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