Global Places and Geometry

Overview

SafeGraph’s Places data provides detailed information about physical places in a fresh and clean format. With POI data for countries around the world, you can gain insights about any location that a person can visit.

Data Information	Value
Refresh Cadence	`Monthly`
Historical Coverage	`2019`-`Present`
Geographic Coverage	`Global`

Schema

Name	Description
PLACEKEY	Unique and persistent ID tied to this POI.
PARENT_PLACEKEY	If place is encompassed by a larger place (e.g. mall, airport), lists the placekey of the parent place; otherwise null.
LOCATION_NAME	The name of the place of interest.
SAFEGRAPH_BRAND_IDS	Unique and consistent ID that represents this specific brand.
BRANDS	If this POI is an instance of a larger brand, contains the brand name.
STORE_ID	The unique ID associated with the store as provided and maintained by the store/brand itself.
TOP_CATEGORY	The label associated with the first 4 digits of the POI’s NAICS category.
SUB_CATEGORY	The label associated with all 6 digits of the POI’s NAICS category.
NAICS_CODE	4-digit or 6-digit NAICS code describing the business.
LATITUDE	Latitude coordinate of the place of interest.
LONGITUDE	Longitude coordinate of the place of interest.
STREET_ADDRESS	Street address of the place of interest.
CITY	The city of the point of interest.
REGION	The state, province, county, or equivalent of how "region" is understood in a given country for the place of interest.
POSTAL_CODE	The postal code of the place of interest.
ISO_COUNTRY_CODE	The 2 letter ISO 3166-1 alpha-2 country code.
PHONE_NUMBER	The phone number of this POI
OPEN_HOURS	A JSON string with days as keys and opening & closing times (in the POI's local time) as values.
CATEGORY_TAGS	An array of descriptive tags indicating higher-resolution category information.
OPENED_ON	The outside year and month this POI opened in yyyy-mm format.
CLOSED_ON	The outside year and month this POI opened in yyyy-mm format.
TRACKING_CLOSED_SINCE	The outside year and month this POI closed in yyyy-mm format. If null, then this POI is open.
GEOMETRY_TYPE	The geometric shape associated with this POI. Possible values are POLYGON or POINT.
POLYGON_WKT	The shape of the place of interest, formatted as Well-Known Text (WKT).
POLYGON_CLASS	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. See Shared Polygons for more details.
IS_SYNTHETIC	If true then this is not a precise POI footprint polygon, but instead is an inferred polygon from an accurate centroid and category-based radius.
ENCLOSED	If true, then this POI is completely enclosed indoors by its parent and is only accessible by entering the parent structure.
INCLUDES_PARKING_LOTS	Whether or not the polygon includes the parking lot. See includes_parking_lot for more details.
WKT_AREA_SQ_METERS	The calculated area of the `polygon_wkt` in square meters.
DOMAINS	The top-level domain(s) for the website(s) associated with the POI.
WEBSITE	The web URL for the POI's publicly available website.

Brand Info

The brand_info dataset can be accessed as a related file on Dewey. Brand Info (Places, Patterns, Geometry, Spend) ↗️

A SafeGraph brand is defined as a store which has multiple locations all under the same logo or store banner.

SafeGraph's brand info can be joined to company company identifiers like those used on Compustat. View the Notebook.

SafeGraph Place ID Crosswalk

The SafeGraph Place ID Crosswalk can be used to join SafeGraph Place IDs to Global Places on using the Placekey identifier. SafeGraph Place ID Crosswalk.