GeoEnrichment service

The GeoEnrichment service finds demographic information and other location facts for places around the world. A point or polygon can be used to retrieve data associated with the location and surrounding area. The service supports over 15,000 data fields to choose from with coverage for more than 130 countries and regions.

Key features

• Demographic data enrichment for many countries and regions.
• Supports study areas such as rings and drive times derived from point locations.
• Contains curated data collections of demographic analysis variables for areas.
• Supports a custom list of data fields from one or more data collections.
• Return geometry and data for a study area that can be displayed on a map.

How the GeoEnrichment service works

The GeoEnrichment service uses a sophisticated data apportionment methodology to aggregate demographic information for rings and other polygons. For example, in the U.S. and Canada, data apportionment relies mostly on census block points. Block points are centroids derived from census block boundaries, the most detailed level of census tabulation available. They contain attributes for the actual count of people and households living in the associated block. For most other countries and regions settlement points are used for data apportionment. Settlement points are modeled by Esri and provide an estimate of the likelihood of human settlement.

The main tasks are:

• Enrich an area: Find demographic data for an area.

To use the service, you typically:

1. Determine the country of interest.
2. Determine the place or area e.g. buffered point, drivetime polygon, custom polygon to search.
3. Determine the demographic analysis variables of interest.
4. Query a study area with the fields of interest.

Service URL

The GeoEnrichment service only supports an enhanced endpoint. The base URL for the service is:

1
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/

Learn more about standard and enhanced endpoints in Service endpoints.

GeoEnrichment

To GeoEnrich a location, use the enrich operation.

This returns a JSON structure containing an array of features. Each feature includes a number of attributes which fall into three categories:

Area and geometry:
These attributes describe the geographic study area:

• OBJECTID An integer used to uniquely identify features in the enrich response.
• sourceCountry The country or region in which the feature is located.
• areaType The type of buffer created around a point study area. Examples include: ring buffer and network service area.
• bufferUnits The unit of measurement used when creating a buffer. Examples include Miles and Kilometers.
• bufferRadii An integer which defines the distance of the buffer.

Demographic data:
These attributes include demographic data for each data field specified in the request.

If none were specified, the following default data fields are returned from the Key Global Facts data collection:

• TOTPOP (Total Population)
• TOTHH (Total Households)
• AVGHHSZ (Average Household Size)
• TOTMALES (Male Population)
• TOTFEMALES (Female Population).

To request other data fields, see the analysisVariables and dataCollections parameters.

** Apportionment details:**
These properties provide further details about how demographic data was calculated for the geographic study area:

• hasData A value of 1 means the area intersects human settlement. A value of 0 means the area does not intersect human settlement.
• aggregationMethod The method used by GeoEnrichment to apportion demographic data to an area. The most detailed level of apportionment is Block Apportionment.
• populationToPolygonSizeRating An area to population reliability score which is based on the size of a census geography unit and the number of people estimated to live in that polygon. The larger the area of a census tabulation area, the less likely the specific locations where people live can reliably be found.
• apportionmentConfidence The overall reliability score which encompasses all aspects of reliability and includes the Area to population score.

URL Request

1
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich?<params>

Required parameters

Key parameters

Other parameters

Example

1
2
3
4
curl https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich? \
-d "studyAreas=[{'geometry':{'x': -117.1956, 'y': 34.0572}}]"
-d "f=json"
-d "token=<ACCESS_TOKEN>"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
        "features" : [ {
          "attributes" : {
            "ID" : "0",
            "OBJECTID" : 1,
            "sourceCountry" : "US",
            "areaType" : "RingBuffer",
            "bufferUnits" : "esriMiles",
            "bufferUnitsAlias" : "Miles",
            "bufferRadii" : 1,
            "aggregationMethod" : "BlockApportionment:US.BlockGroups;PointsLayer:US.BlockPoints",
            "populationToPolygonSizeRating" : 2.191,
            "apportionmentConfidence" : 2.576,
            "HasData" : 1,
            "TOTPOP" : 12799,
            "TOTHH" : 5158,
            "AVGHHSZ" : 2.46,
            "TOTMALES" : 6190,
            "TOTFEMALES" : 6609
          }

Authentication

API support

Pricing

Service data

Source

The main sources of data may be different depending on the country or region and can be explored in the interactive map below. For the U.S. Esri's team of demographers model independent small-area demographic and socioeconomic estimates and forecasts. Additional sources include the U.S. Census Bureau, the Bureau of Labor Statistics and American Community Survey (ACS). For most other countries and regions the main source of standard demographics is Michael Bauer Research (MBR).

Quality

Esri is an industry leader in reviewing and processing census information as well as understanding and accurately updating demographic trends. Leveraging nearly forty years of experience, Esri has developed and refined its models and methods to improve data quality and precision. In addition to the wealth of public source data, particularly from the Census Bureau, source data from carefully chosen partnerships with private vendors are integrated into the modelling process.

Click on the map below to explore data sources for each country and region.