https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/dataCollections?f=pjsonThe GeoEnrichment service uses the concept of a data collection to define the data attributes returned by the enrichment service. Each data collection has a unique name that acts as an ID that is passed in the dataCollections method of the GeoEnrichment service.
Some data collections (such as default) can be used in all supported countries. Other data collections may only be available in one or a collection of countries. Data collections may only be available in a subset of countries because of differences in the demographic data that is available for each country.
Note:
There are a few countries or areas that don't have all 5 variables in the KeyGlobalFacts data collection.
There are two hierarchies of data collections for the U.S. The census2020 hierarchy is the default and indicates the latest data based on the Census 2020 boundaries. The census hierarchy is based on the 2010 census boundaries and can be explicitly used in the URL request to override the default value. See Examples 2 and 3 below.
Note:
An examination of the entire global listing of variables, and associated datasets, can be conveyed with the use of this data browser.
Request parameters
| Parameter | Details |
|---|---|
Optional parameter to specify an array of string values that describe what derivative variables to include in the output. Example - Return a data collection with the additional variables and associated metadata for percent, average, and index values: addDerivativeVariables=all | |
Optional parameter to return only values that are not NULL in the output response. Adding the optional suppressNullValues parameter to any statistical data collections discovery method will reduce the size of the output that is returned. Default value false | |
Optional parameter to specify the output response format. Default value json |
Optional parameters
addDerivativeVariables
Optional parameter to specify an array of string values that describe what derivative variables to include in the output.
Examples
Example 1 - Return a statistical data collection with the additional variables and associated metadata for percent's, averages and index values:
addDerivativeVariables=all
Example 2 - Return a statistical data collection with the additional variables and associated metadata for index values:
addDerivativeVariables=index
Additional notes
- The enumerated list of accepted values are as follows:
addDerivativeVariables=percent,index,average,all,*
- Support the use of the derivative statistics can also be performed in the enrich operation through the analysisVariables parameter.
suppressNullValues
Optional parameter to return only values that are not NULL in the output response. Adding the optional suppressNullValues parameter to any statistical data collections discovery method will reduce the size of the output that is returned.
Default value
false
Examples
suppressNullValues=true
Additional notes
- Setting this optional parameter to true will significantly reduce the size of the output of the statistical data collection response.
- You will have to handle duck typed cases where some metadata may not be returned for a given variables because a value is set to NULL.
f
Optional parameter to specify the output response format.
Default value
json
The output response will be returned in HTML format.
Examples
Example 1 - Request the output geometries in JSON format:
f=json
Additional notes
- Supported formats include JSON and XML.
Example usage
Request example 1
Return a list of data collections that can be run in any country. In this example you can see all the data collections and variables available for any country.
https%3A%2F%2Fgeoenrich.arcgis.com%2Farcgis%2Frest%2Fservices%2FWorld%2Fgeoenrichmentserver%2FGeoenrichment%2FdataCollections%3Ff%3DpjsonRequest example 2
Return a list of data collections for the US based on the default data source.
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/dataCollections/US?f=pjsonhttps%3A%2F%2Fgeoenrich.arcgis.com%2Farcgis%2Frest%2Fservices%2FWorld%2Fgeoenrichmentserver%2FGeoenrichment%2FdataCollections%2FUS%3Ff%3DpjsonRequest example 3
Return a list of data collections for the US based on the 2010 census boundaries.
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/dataCollections/US/census?f=pjsonhttps%3A%2F%2Fgeoenrich.arcgis.com%2Farcgis%2Frest%2Fservices%2FWorld%2Fgeoenrichmentserver%2FGeoenrichment%2FdataCollections%2FUS%2Fcensus%3Ff%3DpjsonRequest example 4
View a description for a single data collection within a given country. You can use the child resources within a discovery page to view a particular data collection available for Sweden.
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/dataCollections/se/EducationalAttainment?f=pjsonhttps%3A%2F%2Fgeoenrich.arcgis.com%2Farcgis%2Frest%2Fservices%2FWorld%2Fgeoenrichmentserver%2FGeoenrichment%2FdataCollections%2Fse%2FEducationalAttainment%3Ff%3DpjsonRequest example 5
Suppress null values for a given request. Applying the suppressNullValues parameter reduces the size of your output.
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/dataCollections/se/EducationalAttainment?f=pjson&suppressNullValues=truehttps%3A%2F%2Fgeoenrich.arcgis.com%2Farcgis%2Frest%2Fservices%2FWorld%2Fgeoenrichmentserver%2FGeoenrichment%2FdataCollections%2Fse%2FEducationalAttainment%3Ff%3Dpjson%26amp%3BsuppressNullValues%3DtrueRequest example 4
Optionally return a subset of output fields in the data collection. Using the optional outfields parameter you can significantly improve the performance of requests by reducing the size of the output.
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/dataCollections/se/EducationalAttainment?f=pjson&outfields=["id","alias"]https%3A%2F%2Fgeoenrich.arcgis.com%2Farcgis%2Frest%2Fservices%2FWorld%2Fgeoenrichmentserver%2FGeoenrichment%2FdataCollections%2Fse%2FEducationalAttainment%3Ff%3Dpjson%26amp%3Boutfields%3D%5B%22id%22%2C%22alias%22%5DRequest example 5
Return derivative statistics for a data collection. Specifies a list of field names that make up the travel consumer spending data collection. This list will include variables for the averages and index values.
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/dataCollections/US/TravelCEX?addDerivativeVariables=["average","index"]&f=pjsonhttps%3A%2F%2Fgeoenrich.arcgis.com%2Farcgis%2Frest%2Fservices%2FWorld%2Fgeoenrichmentserver%2FGeoenrichment%2FdataCollections%2FUS%2FTravelCEX%3FaddDerivativeVariables%3D%5B%22average%22%2C%22index%22%5D%26amp%3Bf%3DpjsonPrimary data collections
The following table lists the data collections and countries that are currently available:
Note:
The primary data collections are used in each country's summary report.
| Primary Data Collection Name(s) | Country or area | Supported Languages |
|---|---|---|
| KeyGlobalFacts | All | English |
| KeyWEFacts | Western Europe | English |
| KeyUSFacts | US | English |
| KeyCanFacts | Canada (CA) | English |
| ALFacts ALSpend | Albania (AL) | English |
| DZFacts | Algeria (DZ) | English |
| ADFacts | Andorra (AD) | English |
| AOFacts | Angola (AO) | English |
AIFacts | Anguilla (AI) | English |
| ARFacts | Argentina (AR) | English |
| AMFacts | Armenia (AM) | English |
| AWFacts | Aruba (AW) | English |
| AUFacts AUSpend | Australia (AU) | English |
| ATFacts ATSpend | Austria (AT) | English |
| AZFacts | Azerbaijan (AZ) | English |
| BSFacts | Bahamas (BS) | English |
| BHFacts BUSpend | Bahrain (BH) | English |
| BDFacts | Bangladesh (BD) | English |
| BYFacts BYSpend | Belarus (BY) | English |
| BEFacts BESpend | Belgium (BE) | English |
BJFacts | Benin (BJ) | English |
| BMFacts | Bermuda (BM) | English |
| BOFacts | Bolivia (BO) | English |
| BAFacts BASpend | Bosnia and Herzegovina (BA) | English |
| BWFacts | Botswana (BW) | English |
| BRFacts BRSpend | Brazil (BR) | English |
BNFacts | Brunei Darussalam | English |
| BGFacts BGSpend | Bulgaria (BG) | English |
BFFacts | Burkina Faso (BF) | English |
BIFacts | Burundi (BI) | English |
CVFacts | Cabo Verde (CV) | English |
KHFacts | Cambodia (KH) | English |
| CMFacts | Cameroon (CM) | English |
| KYFacts | Cayman Islands (KY) | English |
CFFacts | Central African Republic (CF) | English |
TDFacts | Chad (TD) | English |
| CLFacts CLSpend | Chile (CL) | English |
| CNFacts CNSpend | China (CN) | English |
| COFacts COSpend | Colombia (CO) | English |
CGFacts | Congo the (CG) | English |
| CRFacts CRSpend | Costa Rica (CR) | English |
| CIFacts | Côte d'Ivoire (CI) | English |
| HRFacts HRSpend | Croatia (HR) | English |
| CYFacts CYSpend | Cyprus (CY) | English |
| CZFacts CZSpend | Czech Republic (CZ) | English |
| DKFacts DKSpend | Denmark (DK) | English |
| DOFacts | Dominican Republic (DO) | English |
| ECFacts | Ecuador (EC) | English |
| EGFacts | Egypt (EG) | English |
| SVFacts | El Salvador (SV) | English |
GQFacts | Equatorial Guinea (GQ) | English |
| EEFacts EESpend | Estonia (EE) | English |
SZFacts | Eswatini (SZ) | English |
ETFacts | Ethiopia (ET) | English |
| FOFacts | Faroe Islands (FO) | English |
FJFacts | Fiji (FJ) | English |
| FIFacts FISpend | Finland (FI) | English |
| FRFacts FRSpend | France (FR) | English |
GFFacts | French Guiana (GF) | English |
| PFFacts | French Polynesia (PF) | English |
GAFacts | Gabon (GA) | English |
GMFacts | Gambia (GM) | English |
| GEFacts | Georgia (GE) | English |
| DEFacts DESpend | Germany (DE) | English |
| GHFacts | Ghana (GH) | English |
| GRFacts GRSpend | Greece (GR) | English |
| GLFacts | Greenland (GL) | English |
| GPFacts | Guadaloupe (GP) | English |
| GTFacts | Guatamala (GT) | English |
GNFacts | Guinea (GN) | English |
GWFacts | Guinea-Bissau (GW) | English |
GYFacts | Guyana (GY) | English |
| HNFacts | Honduras (HN) | English |
| HKFacts HKSpend | Hong Kong (HK) | English |
| HUFacts HUSpend | Hungary (HU) | English |
| ISFacts ISSpend | Iceland (IS) | English |
| INFacts INSpend | India (IN) | English |
| IDFacts | Indonesia (ID) | English |
IRFacts | Iran (IR) | English |
| IEFacts IESpend | Ireland (IE) | English |
| ILFacts ILSpend | Israel (IL) | English |
| ITFacts ITSpend | Italy (IT) | English |
| JMFacts | Jamaica (JM) | English |
| JPFacts JPSpend | Japan (JP) | English |
| JOFacts | Jordan (JO) | English |
| KZFacts | Kazakhstan (KZ) | English |
| KEFacts | Kenya (KE) | English |
| XKFacts | Kosovo (XK) | English |
| KWFacts | Kuwait (KW) | English |
| KGFacts | Kyrgyzstan (KG) | English |
| LVFacts LVSpend | Latvia (LV) | English |
| LBFacts | Lebanon (LB) | English |
| LSFacts | Lesotho (LS) | English |
LRFacts | Liberia (LR) | English |
| LIFacts LISpend | Liechtenstein (LI) | English |
| LTFacts LTSpend | Lithuania (LT) | English |
| LUFacts LUSpend | Luxembourg (LU) | English |
| MOFacts | Macau (MO) | English |
| MKFacts MKSpend | Macedonia (MK) | English |
MGFacts | Madagascar (MG) | English |
| MWFacts | Malawi (MW) | English |
| MYFacts MYSpend | Malaysia (MY) | English |
MVFacts | Maldives (MV) | English |
MLFacts | Mali (ML) | English |
| MTFacts MTSpend | Malta (MT) | English |
| MQFacts | Martinique (MQ) | English |
MRFacts | Mauritania (MR) | English |
| MUFacts MUSpend | Mauritius (MU) | English |
YTFacts | Mayotte (YT) | English |
| MXFacts MXSpend | Mexico (MX) | English |
| MDFacts MDSpend | Moldova (MD) | English |
| MCFacts | Monaco (MC) | English |
| MNFacts | Mongolia (MN) | English |
| MEFacts MESpend | Montenegro (ME) | English |
MSFacts | Montserrat (MS) | English |
| MAFacts | Morocco (MA) | English |
| MZFacts | Mozambique (MZ) | English |
MMFacts | Myanmar (MM) | English |
| NAFacts | Namibia (NA) | English |
NPFacts | Nepal (NP) | English |
| NLFacts NLSpend | Netherlands (NL) | English |
| NCFacts | New Caledonia (NC) | English |
| NZFacts NZSpend | New Zealand (NZ) | English |
| NIFacts | Nicaragua (NI) | English |
NEFacts | Niger (NE) | English |
| NGFacts | Nigeria (NG) | English |
| NOFacts NOSpend | Norway (NO) | English |
| OMFacts | Oman (OM) | English |
| PKFacts | Pakistan (PK) | English |
| PAFacts | Panama (PA) | English |
PGFacts | Papua New Guinea (PG) | English |
| PYFacts | Paraguay (PY) | English |
| PEFacts | Peru (PE) | English |
| PHFacts PHSpend | Philippines (PH) | English |
| PLFacts PLSpend | Poland (PL) | English |
| PTFacts PTSpend | Portugal (PT) | English |
| PRFacts | Puerto Rico (PR) | English |
| QAFacts | Qatar (QA) | English |
| REFacts RESpend | Réunion (RE) | English |
| ROFacts ROSpend | Romania (RO) | English |
| RUFacts RUSpend | Russia (RU) | English |
LCFacts | Saint Lucia (LC) | English |
| SAFacts SASpend | Saudi Arabia (SA) | English |
SNFacts | Senegal (SN) | English |
| RSFacts RSSpend | Serbia (RS) | English |
SLFacts | Sierra Leone (SL) | English |
| SGFacts SGSpend | Singapore (SG) | English |
| SKFacts SKSpend | Slovakia (SK) | English |
| SIFacts SISpend | Slovenia (SI) | English |
| ZAFacts | South Africa (ZA) | English |
| KRFacts KRSpend | South Korea (KR) | English |
| ESFacts ESSpend | Spain (ES) | English |
| LKFacts | Sri Lanka (LK) | English |
| SDFacts | Sudan (SD) | English |
| SEFacts SESpend | Sweden (SE) | English |
| CHFacts CHSpend | Switzerland (CH) | English |
| SYFacts | Syria (SY) | English |
| TWFacts TWSpend | Taiwan (TW) | English |
| TJFacts | Tajikistan (TJ) | English |
| TZFacts | Tanzania (TZ) | English |
| THFacts THSpend | Thailand (TH) | English |
TGFacts | Togo (TG) | English |
| TTFacts | Trinidad and Tobago (TT) | English |
| TNFacts | Tunisia (TN) | English |
| TRFacts TRSpend | Türkiye (TR) | English |
TCFacts | Turks And Caicos Islands (TC) | English |
| UGFacts | Uganda (UG) | English |
| UAFacts UASpend | Ukraine (UA) | English |
| AEFacts | United Arab Emirates (AE) | English |
| GBFacts GBSpend | United Kingdom (GB) | English |
| UYFacts | Uruguay (UY) | English |
UZFacts | Uzbekistan (UZ) | English |
| VEFacts | Venezuela (VE) | English |
| VNFacts | Vietnam (VN) | English |
VIFacts | Virgin Islands (VI) | English |
| ZMFacts | Zambia (ZM) | English |
ZWFacts | Zimbabwe (ZW) | English |