Tutorial: Find data using data collections

Learn how to use the Data Collection Finder tool to find data collections.

Global and local facts for Tokyo.

A data collection is a predefined and categorized list of analysis variables. Each collection has a unique name that acts as an ID that is passed in the datacollections parameter of the enrich method. Some data collections (such as the default Key Global Facts) can be used in all supported countries and regions. Other data collections may only be available in a subset of countries or regions because of differences in available demographic data provided by data partners.

In this tutorial you learn how to:

Get key facts
Get spending facts
Get education expenditure data

Prerequisites

Steps

Get key facts

Go to the Data Collection Finder tool.
In the Country/Region/Territory dropdown, select Japan.
In the Hierarchy dropdown, select Standard (ID: census).
In the Data Collections dropdown, select Key Facts (ID: KeyFacts).
Browse through the variables within the collection. Some include:
- 2022 Total Population (ID:TOTPOP_CY)
- 2022 Total Households (ID:TOTHH_CY)
Make a request to the GeoEnrichment service and specify the country or area code and the data collection ID.

cURL

HTTP

Use dark colors for code blocksCopy

curl https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich? \
-d "studyAreas=[{'geometry':{'x': 139.78444, 'y': 35.68109}}]" \
-d "dataCollections=["KeyFacts"]" \
-d "f=pjson" \
-d "token=<ACCESS_TOKEN>"

Expand
Use dark colors for code blocksCopy
        "features" : [ {
          "attributes" : {
            "ID" : "0",
            "OBJECTID" : 1,
            "sourceCountry" : "JP",
            "areaType" : "RingBuffer",
            "bufferUnits" : "esriMiles",
            "bufferUnitsAlias" : "Miles",
            "bufferRadii" : 1,
            "aggregationMethod" : "BlockApportionment:JP.Blocks;PointsLayer:JP.BlockPoints",
            "populationToPolygonSizeRating" : -1,
            "apportionmentConfidence" : -1,
            "HasData" : 1,
            "TOTPOP_CY" : 128751,
            "POPDENS_CY" : 15836.5,
            "POPPRM_CY" : 1,
            "MALES_CY" : 62872,
            "FEMALES_CY" : 65879,
            "TOTHH_CY" : 71875,
            "AVGHHSZ_CY" : 1.8,
            "PAGE01_CY" : 13879,
            "PAGE02_CY" : 19832,
            "PAGE03_CY" : 35786,
            "PAGE04_CY" : 32507,
            "PAGE05_CY" : 26746,
            "MAGE01_CY" : 7006,
            "MAGE02_CY" : 9872,
            "MAGE03_CY" : 17423,
            "MAGE04_CY" : 16610,
            "MAGE05_CY" : 11960,
            "FAGE01_CY" : 6874,
            "FAGE02_CY" : 9960,
            "FAGE03_CY" : 18362,
            "FAGE04_CY" : 15897,
            "FAGE05_CY" : 14786,
            "HTYP01A_CY" : 27466,
            "HTYP02A_CY" : 1833,
            "HTYP03A_CY" : 827,
            "HTYP04A_CY" : 41740,
            "MRST01_CY" : 84223,
            "MRST02_CY" : 33576,
            "MRST03_CY" : 5073,
            "MRST04_CY" : 5864,
            "EDUC01_CY" : 4524,
            "EDUC02_CY" : 23510,
            "EDUC03_CY" : 13921,
            "EDUC04_CY" : 37918,
            "EDUC05A_CY" : 29403,
            "EDUC06A_CY" : 35,
            "EDUC07_CY" : 5545,
            "UNEMP_CY" : 1905,
            "PP_CY" : 4.9817747347459E11,
            "PPPRM_CY" : 1.6,
            "PPPC_CY" : 3869309.55,
            "PPIDX_CY" : 157.6
          }
        } ]
Expand

Get spending facts

Go to the Data Collection Finder tool.
In the Country/Region/Territory dropdown, select Japan.
In the Hierarchy dropdown, select Standard (ID:census).
In the Data Collections dropdown, select Spending (ID:Spending).
Browse through the variables within the collection. Some include:
- 2022 Clothing Expenditures: Total (ID:CS04_CY)
- 2022 Recreational & Cultural Service Expenditures: Index (ID: CS16IDX_CY)
Make a request to the GeoEnrichment service and specify the country or area code and the data collection ID.

cURL

HTTP

Use dark colors for code blocksCopy

curl https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich? \
-d "studyAreas=[{'geometry':{'x': 139.78444, 'y': 35.68109}}]" \
-d "dataCollections=["Spending"]" \
-d "f=pjson" \
-d "token=<ACCESS_TOKEN>"

Expand
Use dark colors for code blocksCopy
          "features" : [ {
            "attributes" : {
              "ID" : "0",
              "OBJECTID" : 1,
              "sourceCountry" : "JP",
              "areaType" : "RingBuffer",
              "bufferUnits" : "esriMiles",
              "bufferUnitsAlias" : "Miles",
              "bufferRadii" : 1,
              "aggregationMethod" : "BlockApportionment:JP.Blocks;PointsLayer:JP.BlockPoints",
              "populationToPolygonSizeRating" : -1,
              "apportionmentConfidence" : -1,
              "HasData" : 1,
              "CS01_CY" : 6.098527535385E10,
              "CS01PRM_CY" : 1.4,
              "CSPC01_CY" : 473668.36,
              "CS01IDX_CY" : 133.3,
              "CS02_CY" : 7.01306415817E9,
              "CS02PRM_CY" : 1.5,
              "CSPC02_CY" : 54469.98,
              "CS02IDX_CY" : 150,
              "CS03_CY" : 2.88974726815E9,
              "CS03PRM_CY" : 1.2,
              "CSPC03_CY" : 22444.46,
              "CS03IDX_CY" : 119.8,
              "CS04_CY" : 1.288734477204E10,
              "CS04PRM_CY" : 1.4,
              "CSPC04_CY" : 100095.1,
              "CS04IDX_CY" : 138.5,
              "CS05_CY" : 2.06567750913E9,
              "CS05PRM_CY" : 1.4,
              "CSPC05_CY" : 16043.97,
              "CS05IDX_CY" : 137.6,
              "CS06_CY" : 1.99545863592E9,
              "CS06PRM_CY" : 1.5,
              "CSPC06_CY" : 15498.59,
              "CS06IDX_CY" : 143.9,
              "CS07_CY" : 1.18958398735E9,
              "CS07PRM_CY" : 1.4,
              "CSPC07_CY" : 9239.42,
              "CS07IDX_CY" : 138.7,
              "CS08_CY" : 4.27665556301E9,
              "CS08PRM_CY" : 1.3,
              "CSPC08_CY" : 33216.48,
              "CS08IDX_CY" : 130.7,
              "CS09_CY" : 1.82298415612E9,
              "CS09PRM_CY" : 1.4,
              "CSPC09_CY" : 14158.99,
              "CS09IDX_CY" : 135.1,
              "CS10_CY" : 2.9182986173E8,
              "CS10PRM_CY" : 1.3,
              "CSPC10_CY" : 2266.62,
              "CS10IDX_CY" : 122.8,
              "CS11_CY" : 5.33789589085E9,
              "CS11PRM_CY" : 1.3,
              "CSPC11_CY" : 41459.06,
              "CS11IDX_CY" : 131.1,
              "CS12_CY" : 5.37385891008E9,
              "CS12PRM_CY" : 1.2,
              "CSPC12_CY" : 41738.39,
              "CS12IDX_CY" : 120.6,
              "CS13_CY" : 3.05278623847E9,
              "CS13PRM_CY" : 1.4,
              "CSPC13_CY" : 23710.78,
              "CS13IDX_CY" : 138.6,
              "CS14_CY" : 3.719743508E8,
              "CS14PRM_CY" : 1.3,
              "CSPC14_CY" : 2889.1,
              "CS14IDX_CY" : 127.3,
              "CS15_CY" : 5.42915865911E9,
              "CS15PRM_CY" : 1.3,
              "CSPC15_CY" : 42167.9,
              "CS15IDX_CY" : 127.9,
              "CS16_CY" : 1.299681438682E10,
              "CS16PRM_CY" : 1.4,
              "CSPC16_CY" : 100945.35,
              "CS16IDX_CY" : 133,
              "CS17_CY" : 4.94614345102E9,
              "CS17PRM_CY" : 1.3,
              "CSPC17_CY" : 38416.35,
              "CS17IDX_CY" : 128,
              "CS18_CY" : 1.353686526889E10,
              "CS18PRM_CY" : 1.4,
              "CSPC18_CY" : 105139.88,
              "CS18IDX_CY" : 132.6,
              "CS19_CY" : 7.95525031621E9,
              "CS19PRM_CY" : 1.3,
              "CSPC19_CY" : 61787.87,
              "CS19IDX_CY" : 128.7,
              "CS20_CY" : 2.3627233437E9,
              "CS20PRM_CY" : 1.5,
              "CSPC20_CY" : 18351.11,
              "CS20IDX_CY" : 142.4
            }
          } ]
Expand

Get education data

Go to the Data Collection Finder tool.
In the Country/Region/Territory dropdown, select Japan.
In the Hierarchy dropdown, select Esri Japan (ID: EsriJapan).
In the Data Collections dropdown, select Education (ID:EducationEsriJapan).
Browse through the variables within the collection. Some include:
- 2018 Educational Expenses (ID: C0477)
- 2018 Tuition Fees (ID: C0478)
Make a request to the GeoEnrichment service and specify the country or area code and the data collection ID.

cURL

HTTP

Use dark colors for code blocksCopy

curl https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich? \
-d "studyAreas=[{'geometry':{'x': 139.78444, 'y': 35.68109}}]" \
-d "dataCollections=["EducationEsriJapan"]" \
-d "f=pjson" \
-d "token=<ACCESS_TOKEN>"

Expand
Use dark colors for code blocksCopy
          "features" : [ {
            "attributes" : {
              "ID" : "0",
              "OBJECTID" : 1,
              "sourceCountry" : "JP",
              "areaType" : "RingBuffer",
              "bufferUnits" : "esriMiles",
              "bufferUnitsAlias" : "Miles",
              "bufferRadii" : 1,
              "aggregationMethod" : "BlockApportionment:JP.Blocks;PointsLayer:JP.BlockPoints",
              "populationToPolygonSizeRating" : -1,
              "apportionmentConfidence" : -1,
              "HasData" : 1,
              "C0477" : 2219938381,
              "C0478" : 1745225066,
              "C0479" : 81470247,
              "C0480" : 9670132,
              "C0481" : 64664394,
              "C0482" : 306196240,
              "C0483" : 56003105,
              "C0484" : 89294934,
              "C0485" : 160898201,
              "C0486" : 680821582,
              "C0487" : 296206231,
              "C0488" : 71307996,
              "C0489" : 43257232,
              "C0490" : 10752793,
              "C0491" : 32504439,
              "C0492" : 431120566,
              "C0493" : 223594120,
              "C0494" : 150514497,
              "C0495" : 56987343
            }
          } ]
Expand

What's next?

Learn how to use additional tools, APIs, and location services in these tutorials:

Query demographic data

Query demographic information for locations around the world with the GeoEnrichment service.

JavaScript Maps SDK Esri Leaflet MapLibre GL JS OpenLayers CesiumJS REST JS Python API REST API