Places

Location Schema: Places

In addition to the schemas describing the metrics, we provide optional schemas supporting contextual information of locations. Below follows the standard default option for SafeGraph Places, other configurations might apply to you.

Field name	Type	Description	Example
placekey	string	Unique and persistent ID tied to this POI. See Placekey for details on placekey design.	333-333@222-333-444
parent_placekey	string	If place is encompassed by a larger place (e.g. mall, airport), this lists the placekey of the parent place.	333-334@222-333-444
location_name	string	The name of the place of interest.	Salinas Valley Ford Lincoln
safegraph_brand_ids	string	Unique and consistent ID that represents this specific brand.	SG_BRAND_8310c2e3461b8b5a
brands	string	If this POI is an instance of a larger brand that we have explicitly identified, this column will contain that brand name.	Circle K
top_category	string	The label associated with the first 4 digits of the POI’s NAICS category.	Automobile Dealers
sub_category	string	The label associated with all 6 digits of the POI’s NAICS category. For POIs with a 4-digit NAICS category, this column is null	New Car Dealers
naics_code	string	4-digit or 6-digit NAICS code describing the business.	441110
category_tags	string	An array of descriptive tags indicating higher-resolution category information.	[Mexican Food,Casual Dining,Lunch,Dinner]
latitude	string	Latitude coordinate of the place of interest	36.714767
longitude	string	Longitude coordinate of the place of interest	-121.662912
street_address	string	Street address of the place of interest	1100 Auto Center Circle
city	string	The city of the point of interest	Irvine
region	string	The state, province, county, or equivalent of how "region" is understood in a given country for the place of interest.	CO
postal_code	string	The postal code of the place of interest.	92602
iso_country_code	string	The 2 letter ISO 3166-1 alpha-2 country code.	US
census_code	string	Census block group fips ID	010010201001
open_hours	string	A JSON string with days as keys and opening & closing times (in the POI's local time) as values.	{ "Mon": [["8:00", "22:00"]], "Tue": [["8:00", "13:00"], ["18:00", "24:00"]], "Wed": [["0:00", "2:00"]], "Thu": [["0:00", "24:00"]], "Fri": [["23:00", "24:00"]], "Sat": [["0:00", "3:00"], ["15:00", "22:30"]], "Sun": [] }
opened_on	string	The outside year and month this POI opened in yyyy-mm format. If null, then we do not have enough metadata to determine an open date.	2019-10
closed_on	string	The outside year and month this POI closed in yyyy-mm format. If null, then this POI is open.	2020-03
tracking_closed_since	string	Indicates the year and month we started tracking "closed_on" for this POI.	2019-07
store_id	string	The unique ID associated with the store as provided and maintained by the store/brand itself.	36558
parent_safegraph_brand_id	string	If this brand has a parent, this will list the ID of the parent brand. If this brand has no parent, this will be null.	SG_BRAND_8310c2e3461b8b5a
stock_symbol	string	The stock ticker (if the corporation is traded publicly)	F
stock_exchange	string	The stock exchange on which this corporation is listed (if the corporation is traded publicly).	NYSE
iso_country_codes_open	string	A list of all 2 letter ISO 3166-1 alpha-2 country codes for each country this brand has at least 1 open POI (closed_on is null).	["US", "GB"]
iso_country_codes_closed	string	A list of all 2 letter ISO 3166-1 alpha-2 country codes for each country this brand has at least 1 closed POI (closed_on is not null).	["US", "CA"]
polygon_class	string	The classification of the polygon: 1) OWNED_POLYGON: only one POI maps to this distinct polygon. 2) SHARED_POLYGON: at least two POIs share the same polygon.	OWNED_POLYGON
polygon_confidence_score	string	Modelled score estimating likelihood of accurate foot traffic prediction. Read more here.	0.8