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 InformationValue
Refresh CadenceMonthly
Historical Coverage2019-Present
Geographic CoverageGlobal

Schema

NameDescription
PLACEKEYUnique and persistent ID tied to this POI.
PARENT_PLACEKEYIf place is encompassed by a larger place (e.g. mall, airport), lists the placekey of the parent place; otherwise null.
LOCATION_NAMEThe name of the place of interest.
SAFEGRAPH_BRAND_IDSUnique and consistent ID that represents this specific brand.
BRANDSIf this POI is an instance of a larger brand, contains the brand name.
STORE_IDThe unique ID associated with the store as provided and maintained by the store/brand itself.
TOP_CATEGORYThe label associated with the first 4 digits of the POI’s NAICS category.
SUB_CATEGORYThe label associated with all 6 digits of the POI’s NAICS category.
NAICS_CODE4-digit or 6-digit NAICS code describing the business.
LATITUDELatitude coordinate of the place of interest.
LONGITUDELongitude coordinate of the place of interest.
STREET_ADDRESSStreet address of the place of interest.
CITYThe city of the point of interest.
REGIONThe state, province, county, or equivalent of how "region" is understood in a given country for the place of interest.
POSTAL_CODEThe postal code of the place of interest.
ISO_COUNTRY_CODEThe 2 letter ISO 3166-1 alpha-2 country code.
PHONE_NUMBERThe phone number of this POI
OPEN_HOURSA JSON string with days as keys and opening & closing times (in the POI's local time) as values.
CATEGORY_TAGSAn array of descriptive tags indicating higher-resolution category information.
OPENED_ONThe outside year and month this POI opened in yyyy-mm format.
CLOSED_ONThe outside year and month this POI opened in yyyy-mm format.
TRACKING_CLOSED_SINCEThe outside year and month this POI closed in yyyy-mm format. If null, then this POI is open.
GEOMETRY_TYPEThe geometric shape associated with this POI. Possible values are POLYGON or POINT.
POLYGON_WKTThe shape of the place of interest, formatted as Well-Known Text (WKT).
POLYGON_CLASSThe 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_SYNTHETICIf true then this is not a precise POI footprint polygon, but instead is an inferred polygon from an accurate centroid and category-based radius.
ENCLOSEDIf true, then this POI is completely enclosed indoors by its parent and is only accessible by entering the parent structure.
INCLUDES_PARKING_LOTSWhether or not the polygon includes the parking lot. See includes_parking_lot for more details.
WKT_AREA_SQ_METERSThe calculated area of the polygon_wkt in square meters.
DOMAINSThe top-level domain(s) for the website(s) associated with the POI.
WEBSITEThe 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.