The SafeGraph Developer Hub

Welcome to the SafeGraph developer hub. You'll find comprehensive guides and documentation to help you start working with SafeGraph as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Places Summary Statistics

Places Statistics excluding closed POIs

Below is the absolute count of POI attributes and their respective fill rates (percentage of non-null values) excluding closed POIs. See Core Places Schema for field definitions.

US

Core Places (All) - US

Column Name Absolute Count Fill Rate
placekey 5,333,501 100%
safegraph_place_id 5,333,501 100%
location_name 5,333,501 100%
latitude 5,333,501 100%
longitude 5,333,501 100%
street_address 5,333,501 100%
city 5,333,501 100%
region 5,333,501 100%
postal_code 5,333,501 100%
polygon_wkt 5,333,501 100%
building_height 1,338,003 25%
enclosed 5,333,501 100%
top_category 5,285,514 99%
sub_category 5,226,816 98%
naics_code 5,285,662 99%
phone_number 3,972,638 74%
open_hours 2,325,324 44%
category_tags 739,856 14%
iso_country_code 5,333,501 100%
safegraph_brand_ids 1,257,566 24%
brands 1,257,566 24%
parent_safegraph_place_id 859,377 16%

Core Places (Branded Only) - US

Column Name Absolute Count Fill Rate
placekey 1,257,566 100%
safegraph_place_id 1,257,566 100%
location_name 1,257,566 100%
safegraph_brand_ids 1,257,566 100%
brands 1,257,566 100%
top_category 1,257,565 100%
sub_category 1,257,565 100%
naics_code 1,257,566 100%
latitude 1,257,566 100%
longitude 1,257,566 100%
street_address 1,257,566 100%
city 1,257,566 100%
region 1,257,566 100%
postal_code 1,257,566 100%
polygon_wkt 1,257,566 100%
polygon_class 1,257,566 100%
building_height 184,468 15%
enclosed 1,257,566 100%
phone_number 847,361 67%
open_hours 582,294 46%
category_tags 243,594 19%
iso_country_code 1,257,566 100%
parent_safegraph_place_id 380,737 30%

Geometry Statistics - US

polygon_class has two possible values:

  • OWNED_POLYGON indicates that the polygon describes the POI itself.
  • SHARED_POLYGON indicates that at least two POI shared the same polygon.

Included below is the breakdown of these values for all places and only branded places respectively.

Geometry (All) - US

polygon_class Absolute Count % of Total
OWNED_POLYGON 3,470,657 65%
SHARED_POLYGON 1,862,844 35%

Geometry (Branded Only) - US

polygon_class Absolute Count % of Total
OWNED_POLYGON 952,253 76%
SHARED_POLYGON 305,313 24%

CA

Core Places (All) - CA

Column Name Absolute Count Fill Rate
placekey 0 0%
safegraph_place_id 599,742 100%
location_name 599,742 100%
latitude 599,742 100%
longitude 599,742 100%
street_address 599,742 100%
city 599,742 100%
region 599,742 100%
postal_code 599,742 100%
polygon_wkt 599,742 100%
building_height 0 0%
enclosed 599,742 100%
top_category 599,722 100%
sub_category 579,678 97%
naics_code 599,725 100%
phone_number 467,614 78%
open_hours 195,675 33%
category_tags 84,508 14%
iso_country_code 599,742 100%
safegraph_brand_ids 77,276 13%
brands 77,276 13%
parent_safegraph_place_id 84,533 14%

Core Places (Branded Only) - CA

Column Name Absolute Count Fill Rate
placekey 0 0%
safegraph_place_id 77,276 100%
location_name 77,276 100%
safegraph_brand_ids 77,276 100%
brands 77,276 100%
top_category 77,276 100%
sub_category 77,276 100%
naics_code 77,276 100%
latitude 77,276 100%
longitude 77,276 100%
street_address 77,276 100%
city 77,276 100%
region 77,276 100%
postal_code 77,276 100%
polygon_wkt 77,276 100%
polygon_class 77,276 100%
building_height 0 0%
enclosed 77,276 100%
phone_number 55,080 71%
open_hours 35,814 46%
category_tags 20,525 27%
iso_country_code 77,276 100%
parent_safegraph_place_id 23,405 30%

Geometry Statistics - CA

polygon_class has two possible values:

  • OWNED_POLYGON indicates that the polygon describes the POI itself.
  • SHARED_POLYGON indicates that at least two POI shared the same polygon.

Included below is the breakdown of these values for all places and only branded places respectively.

Geometry (All) - CA

polygon_class Absolute Count % of Total
OWNED_POLYGON 277,452 46%
SHARED_POLYGON 322,290 54%

Geometry (Branded Only) - CA

polygon_class Absolute Count % of Total
OWNED_POLYGON 54,264 70%
SHARED_POLYGON 23,012 30%

Places Statistics including closed POIs

Below is the absolute count of POI attributes and their respective fill rates (percentage of non-null values) including closed POIs. See Core Places Schema for field definitions. For details on how we track whether a POI is open or closed, see the Places Manual.

US (with closed)

Core Places (All) - US

Column Name Absolute Count Fill Rate
placekey 5,823,934 100%
safegraph_place_id 5,823,934 100%
location_name 5,823,934 100%
latitude 5,823,934 100%
longitude 5,823,934 100%
street_address 5,823,934 100%
city 5,823,934 100%
region 5,823,934 100%
postal_code 5,823,934 100%
polygon_wkt 5,333,501 92%
polygon_class 5,333,501 92%
building_height 1,489,372 26%
enclosed 5,823,934 100%
top_category 5,770,811 99%
sub_category 5,708,893 98%
naics_code 5,770,966 99%
phone_number 4,429,915 76%
open_hours 2,452,909 42%
category_tags 878,108 15%
opened_on 12,625 <1%
closed_on 490,433 8%
tracking_opened_since 355,755 6%
tracking_closed_since 5,400,178 93%
iso_country_code 5,823,934 100%
safegraph_brand_ids 1,274,409 22%
brands 1,274,409 22%
parent_safegraph_place_id 859,377 15%

Core Places (Branded Only) - US

Column Name Absolute Count Fill Rate
placekey 1,274,409 100%
safegraph_place_id 1,274,409 100%
location_name 1,274,409 100%
safegraph_brand_ids 1,274,409 100%
brands 1,274,409 100%
top_category 1,274,408 100%
sub_category 1,274,408 100%
naics_code 1,274,409 100%
latitude 1,274,409 100%
longitude 1,274,409 100%
street_address 1,274,409 100%
city 1,274,409 100%
region 1,274,409 100%
postal_code 1,274,409 100%
polygon_wkt 1,257,566 99%
polygon_class 1,257,566 99%
building_height 186,886 15%
enclosed 1,274,409 100%
phone_number 862,128 68%
open_hours 590,327 46%
category_tags 246,866 19%
opened_on 12,625 1%
closed_on 16,843 1%
tracking_opened_since 355,755 28%
tracking_closed_since 850,752 67%
iso_country_code 1,274,409 100%
parent_safegraph_place_id 380,737 30%

CA (with closed)

Core Places (All) - CA

Column Name Absolute Count Fill Rate
placekey 0 0%
safegraph_place_id 600,559 100%
location_name 600,559 100%
latitude 600,559 100%
longitude 600,559 100%
street_address 600,559 100%
city 600,559 100%
region 600,559 100%
postal_code 600,559 100%
polygon_wkt 599,742 100%
polygon_class 599,742 100%
building_height 0 0%
enclosed 600,559 100%
top_category 600,539 100%
sub_category 580,495 97%
naics_code 600,542 100%
phone_number 468,342 78%
open_hours 195,921 33%
category_tags 84,833 14%
opened_on 1,116 <1%
closed_on 817 <1%
tracking_opened_since 25,594 4%
tracking_closed_since 569,608 95%
iso_country_code 600,559 100%
safegraph_brand_ids 78,092 13%
brands 78,092 13%
parent_safegraph_place_id 84,533 14%

Core Places (Branded Only) - CA

Column Name Absolute Count Fill Rate
placekey 0 0%
safegraph_place_id 78,092 100%
location_name 78,092 100%
safegraph_brand_ids 78,092 100%
brands 78,092 100%
top_category 78,092 100%
sub_category 78,092 100%
naics_code 78,092 100%
latitude 78,092 100%
longitude 78,092 100%
street_address 78,092 100%
city 78,092 100%
region 78,092 100%
postal_code 78,092 100%
polygon_wkt 77,276 99%
polygon_class 77,276 99%
building_height 0 0%
enclosed 78,092 100%
phone_number 55,807 71%
open_hours 36,059 46%
category_tags 20,850 27%
opened_on 1,116 1%
closed_on 816 1%
tracking_opened_since 25,594 33%
tracking_closed_since 47,141 60%
iso_country_code 78,092 100%
parent_safegraph_place_id 23,405 30%

Brand Statistics (All Countries)

Included below is the absolute count of brand attributes and their respective fill rates (percentage of non-null values). See Brand Info Schema for field definitions.

Column Name Absolute Count Fill Rate
safegraph_brand_id 6239 100%
brand_name 6239 100%
naics_code 6239 100%
top_category 6239 100%
sub_category 6239 100%
parent_safegraph_brand_id 782 13%

Category Statistics

Below is a breakdown of category counts for all places, branded places, and files including/excluding closed POIs. Click "All Places (excluding closed POIs)" in the top left to toggle between counts for all places vs. branded places and for counts including vs. excluding closed POIs.

Updated 17 days ago


Places Summary Statistics


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.