Place types

In Data Commons, a “place type” is a specific geographic or administrative unit for which we provide data. This could range from broad categories such as countries, states, and provinces to more granular classifications like counties, cities, and postal codes. This page provides the DCIDs and a description of place types available in our APIs and tools.

Note: Not all data is available for all place types. Sources often don’t provide data at all levels of granularity. You can check which place types have data available for a specific variable using the Statistical Variable Explorer.

Globally available geographic divisions

These place types are generally available for Earth and/or all countries.

Place Type DCID Place Type Description
AdministrativeArea1 A country’s first-level administrative divisions.

For example, this would encompass US states, Canada’s provinces, and Japan’s prefectures.
AdministrativeArea2 A country’s second-level administrative divisions.

For example, this would encompass US counties, France’s departments, or India’s divisions.
Country A nation.

Note that sources can differ on which countries are recognized. Thus, this category may include some territories and disputed regions.
City A city.

Partially available geographic divisions

These place types represent administrative divisions that are available for some countries, but not all countries.

Place Type DCID Place Type Description
AdministrativeArea3 A country’s third-level adminstrative divisions.
AdministrativeArea4 A country’s fourth-level administrative divisions.
AdministrativeArea5 A country’s fifth-level administrative divisions.
Town A settlement that is bigger than a village but smaller than a city.
Village A small clustered human settlement smaller than a town.

U.S.-specific geographic divisions

These place types can only be used for places that are contained within the United States (DCID: country/USA). See https://datacommons.org/browser/dc/base/BaseGeos for additional places defined for the U.S.

Place Type DCID Place Type Description
State U.S. states.

For example, California or Maryland
County U.S. counties.

For example, Santa Clara County
CensusZipCodeTabulationArea U.S. zip codes as defined by the U.S. Census Bureau.

For example, 94043.

While there is significant overlap, these codes don’t always correspond to the zip codes used by the US Postal Service.
CensusTract U.S. census tracts as defined by the U.S. Census Bureau.

For example, Census Tract 10
CensusBlockGroup U.S. block groups as defined by the U.S. Census Bureau.

For example, Block Group 0

India-specific administrative divisions

These place types can only be used for places that are contained within India (dcid: country/IND).

Place Type DCID Place Type Description
State Indian states.

For example, Uttar Pradesh or Karnataka

Europe-specific administrative divisions

These place types can only be used for places that are contained within Europe (dcid: europe).

Place Type DCID Place Type Description
EurostatNUTS1 First-level statistical subdivision within an EU member country.
EurostatNUTS2 Second-level statistical subdivision within an EU member country.
EurostatNUTS3 Third-level statistical subdivision within an EU member country.

Earth grids

These place types represent regions defined by various geographic grid systems. These place types are typically used with climate-related data.

Place Type DCID Place Type Description
GeoGridPlace_0.25Deg A place representing a uniform 0.25x0.25 degree grid on the surface of the earth.
GeoGridPlace_1Deg A place representing a uniform 1x1 degree grid on the surface of the earth. Unlike IPCCPlace entities, these are not defined in the context of a country.
GeoGridPlace_4KM A place representing a uniform 4km grid on the surface of the earth.
IPCCPlace_25 A grid on the earth’s surface approximately corresponding to 0.25-degree resolution for attaching climate-related observations. These are defined within the context of a specific country.
IPCCPlace_50 A grid on the earth’s surface approximately corresponding to 0.50-degree resolution for attaching climate related observations. These are defined within the context of a specific country.
S2CellLevel7 S2 cell at level 7 which corresponds to an average area of 5188.66 sq km.
S2CellLevel8 S2 cell at level 8 which corresponds to an average area of 1297.17 sq km.
S2CellLevel9 S2 cell at level 9 which corresponds to an average area of 324.29 sq km.
S2CellLevel10 S2 cell at level 10 which corresponds to an average area of 81.07 sq km.
S2CellLevel11 S2 cell at level 11 which corresponds to an average area of 20.27 sq km.
S2CellLevel12 S2 cell at level 12 which corresponds to an average area of 5.07 sq km.
S2CellLevel13 S2 cell at level 13 which corresponds to an average area of 1.27 sq km.
S2CellLevel14 S2 cell at level 14 which corresponds to an average area of 0.32 sq km.