Input XY locations

The most common method to determine the center point for a study area is a set of one or many point locations defined as XY locations. More specifically, one or many input points (latitude and longitude) can be provided to the service to set the study areas that you want to enrich with additional information. You can create a buffer ring or drive-time service area around the points to aggregate data for the study areas. You can also return enrichment data for buffers around input line features.

Request parameters

ParameterDetails

studyAreas

Required parameter to specify a list of input features to be enriched. Study areas can be input XY point locations.

Examples

Example 1 - One point described as map coordinates:

studyAreas=[{"geometry":{"x":-117.1956,"y":34.0572}}]

Example 2 - Multiple points with attributes described as map coordinates:

studyareas=[{"geometry":{"x":-122.435,"y":37.785},"attributes":{"myID":"point1"}},{"geometry":{"x":-122.433,"y":37.734},"attributes":{"myID":"point2"}}]

Example 3 - One point and intersecting U.S. state:

studyareas=[{"geometry":{"x":-117.1956,"y":34.0572}},{"geometry":{"x":-117.1956,"y":34.0572},"areaType":"StandardGeography","intersectingGeographies":[{"sourceCountry":"US","layer":"US.States"}]}]

Example 4 - One point and and include two comparison levels of geography:

studyareas=[{"geometry":{"x":-122.435,"y":37.785},"comparisonLevels":[{"layer":"Admin2"},{"layer":"Admin3"}]}]

Example 5 - One-kilometer buffer around an input line feature:

studyareas=[{"areaType":"RingBuffer","bufferUnits":"esriKilometers","bufferRadii":[1],"returnGeometry":true,"geometry":{"paths":[[[-13048580,4036370],[-13046151,4036366]]],"spatialReference":{"wkid":102100}}}]

Additional notes

  • When points are specified, the service will analyze the map areas surrounding or associated with the input point locations.
  • All input feature attributes, if provided, will be carried over into the output response. If the input attributes are unique to each input feature, this behavior can be leveraged to uniquely bind or associate the input features with the corresponding output features.
  • If the input features are submitted without attributes, an "id" attribute will be appended to each feature in the output response. The "id" attribute values will represent the zero-based array index of the input features submitted with the studyAreas parameter.
  • The request sent to the service cannot be greater than 10mb.
  • Currently, a maximum of 100 features can be enriched with the service per request.
  • You can also input line feaures as study areas, as illustrated in example #5. Like points, buffer polygons will be created around the input line features.

dataCollections

Optional parameter to specify a list of Data Collections.

A Data Collection is a preassembled list of attributes that will be used to enrich the input features. Enrichment attributes can describe various types of information such as demographic characteristics and geographic context of the locations or areas submitted as input features in studyAreas.

Default value

["KeyGlobalFacts"]

A standard list of enrichment attributes.

Examples

Example 1:

dataCollections=["KeyGlobalFacts"]

Example 2:

dataCollections=["KeyUSFacts"]

Example 3:

dataCollections=["KeyGlobalFacts","KeyUSFacts"]

Additional notes

analysisVariables

Optional parameter to specify a subset of variables to be returned from one or more Data Collections.

A Data Collection is a preassembled list of attributes that will be used to enrich the input features. With the analysisVariables parameter you can return a subset of variables Enrichment attributes can describe various types of information such as demographic characteristics and geographic context of the locations or areas submitted as input features in studyAreas.

Examples

Example 1:

analysisVariables=["KeyGlobalFacts.TOTPOP"]

Example 2:

analysisVariables=["KeyGlobalFacts.TOTPOP", "AGE.MALE0", "AGE.MALE5"]

Example 3:

analysisVariables=["KeyGlobalFacts.TOTPOP", "AGE.* "]

Additional notes

  • The Data Collection for an analysis variable should be appended before an analysis variable.
  • Usage and metering will only be based on the number of variables that are returned.
  • You can use an asterisk to return all variables for a given data collection (e.g. "KeyGlobalFacts.*")
  • You can normalize statistics for a data collection or analysis variable by adding percent, average and/or index calculations as additional variables to your output. See Example 16 below.

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 data collection with the additional variables and associated metadata for percent's, averages and index values:

addDerivativeVariables=all

Example 2 - Return a 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.
  • Example:

    https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/Enrich?studyareas=[{"geometry":{"x":-117.1042,"y":32.7671}}]&analysisvariables=["TravelCEX.X7003_X"]&addDerivativeVariables=index&f=pjson

    {
      "results" : [ {
        "paramName" : "GeoEnrichmentResult",
        "dataType" : "GeoEnrichmentResult",
        "value" : {
          "version" : "2.0",
          "FeatureSet" : [ {
            "displayFieldName" : "",
            "fieldAliases" : {
              "ID" : "ID",
              "OBJECTID" : "Object ID",
              "sourceCountry" : "sourceCountry",
              "areaType" : "areaType",
              "bufferUnits" : "bufferUnits",
              "bufferUnitsAlias" : "bufferUnitsAlias",
              "bufferRadii" : "bufferRadii",
              "aggregationMethod" : "aggregationMethod",
              "HasData" : "HasData",
              "X7003_X" : "Airline Fares",
              "X7003_X_I" : "Airline Fares: Index"
            },
            "spatialReference" : {
              "wkid" : 4326,
              "latestWkid" : 4326
            },
            "fields" : [ {
              "name" : "ID",
              "type" : "esriFieldTypeString",
              "alias" : "ID",
              "length" : 256
            }, {
              "name" : "OBJECTID",
              "type" : "esriFieldTypeOID",
              "alias" : "Object ID"
            }, {
              "name" : "sourceCountry",
              "type" : "esriFieldTypeString",
              "alias" : "sourceCountry",
              "length" : 256
            }, {
              "name" : "areaType",
              "type" : "esriFieldTypeString",
              "alias" : "areaType",
              "length" : 256
            }, {
              "name" : "bufferUnits",
              "type" : "esriFieldTypeString",
              "alias" : "bufferUnits",
              "length" : 256
            }, {
              "name" : "bufferUnitsAlias",
              "type" : "esriFieldTypeString",
              "alias" : "bufferUnitsAlias",
              "length" : 256
            }, {
              "name" : "bufferRadii",
              "type" : "esriFieldTypeDouble",
              "alias" : "bufferRadii"
            }, {
              "name" : "aggregationMethod",
              "type" : "esriFieldTypeString",
              "alias" : "aggregationMethod",
              "length" : 256
            }, {
              "name" : "HasData",
              "type" : "esriFieldTypeInteger",
              "alias" : "HasData"
            }, {
              "name" : "X7003_X",
              "type" : "esriFieldTypeDouble",
              "alias" : "Airline Fares",
              "fullName" : "TravelCEX.X7003_X",
              "component" : "demographics",
              "decimals" : 0,
              "units" : "currency",
              "currency" : "$"
            }, {
              "name" : "X7003_X_I",
              "type" : "esriFieldTypeInteger",
              "alias" : "Airline Fares: Index",
              "fullName" : "TravelCEX.X7003_X_I",
              "decimals" : 0,
              "units" : "other"
            } ],
            "features" : [ {
              "attributes" : {
                "ID" : "0",
                "OBJECTID" : 1,
                "sourceCountry" : "US",
                "areaType" : "RingBuffer",
                "bufferUnits" : "esriMiles",
                "bufferUnitsAlias" : "mile",
                "bufferRadii" : 1,
                "aggregationMethod" : "BlockApportionment:US.BlockGroups",
                "HasData" : 1,
                "X7003_X" : 4691891,
                "X7003_X_I" : 103
              }
            } ]
          } ]
        }
      } ],
      "messages" : [ ]
    }

studyAreasOptions

Optional parameter to specify enrichment behavior. For points described as map coordinates, a 1-mile ring area centered on each site will be used by default. You can use this parameter to change these default settings.

With this parameter, the caller can override the default behavior describing how the enrichment attributes are appended to the input features described in studyAreas. For example, you can change the output ring buffer to 5 miles, change the number of output buffers created around each point, and also change the output buffer type to a drive-time service area rather than a simple ring buffer.

Default value

(null or empty)

The default behavior will be followed.

Examples

Example 1 - Use 1, 2, and 3-mile ring areas each originating at the point-based site:

studyAreasOptions={"areaType":"RingBuffer","bufferUnits":"esriMiles","bufferRadii":[1,2,3]}

Example 2 - Use 1, 3, and 5-kilometer banded ring areas centered on the point-based site:

studyAreasOptions={"areaType":"RingBufferBands","bufferUnits":"esriKilometers","bufferRadii":[1,3,5]}

Example 3 - Use 5 minute drive time-based ring areas centered on the point-based site:

studyAreasOptions={"areaType":"DriveTimeBuffer","bufferUnits":"esriDriveTimeUnitsMinutes","bufferRadii":[5]}

Example 4 - Use 3, 5, and 7-minute drive time-based banded ring areas centered on the point-based site:

studyAreasOptions={"areaType":"DriveTimeBufferBands","bufferUnits":"esriDriveTimeUnitsMinutes","bufferRadii":[3,5,7]}

Additional notes

  • Banded ring areas define radial bands that do not necessarily originate from the ring center. For example, 1, 3, and 5-mile ring bands describe a 0-to-1 mile band, 1-to-3 mile band, and 3-to-5 mile band.
  • Examples 1-4 above can be used on the enrichment of point-based study areas only.

useData

Optional parameter to explicitly specify the country or dataset to query.

When all input features specified in the studyAreas parameter describe locations or areas that lie in the same country or dataset, this optional parameter can be specified to provide an additional "performance hint" to the service.

By default, the service will automatically determine the country or dataset that is associated with each location or area submitted in the studyAreas parameter; however, there is an associated computational cost which may lengthen the time it takes to return a response. To skip this intermediate step and potentially improve the speed and performance of the service, the caller can specify the country or dataset information up front through this parameter.

Default value

(null or empty)

The default behavior will be followed.

Examples

Example 1 - Indicate to the service that all of the input features in the studyAreas parameter describe locations or areas in the U.S.:

useData={"sourceCountry":"US"}

Example 2 - Indicate to the service that all of the input features in the studyAreas parameter describe locations or areas in Canada:

useData={"sourceCountry":"CA"}

Example 3 - Indicate to the service that all of the input features in the studyAreas parameter describe locations or areas in the U.S. "USA_ESRI_2013" dataset:

useData={"sourceCountry":"US","dataset":"USA_ESRI_2013"}

Additional notes

  • GeoEnrichment is available for a number of countries described in the coverage section of the documentation. New countries will be added in the future.
  • Use the countries discovery method to obtain a list of available datasets:

    https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/Countries/United States?f=pjson

    {
      "countries": [
        {
          "id": "US",
          "name": "United States",
          "abbr3": "USA",
          "altName": "UNITED STATES",
          "continent": "North America",
          "distanceUnits": "Miles",
          "esriUnits": "esriMiles",
          "defaultExtent": {
            "xmin": -178.48633078,
            "ymin": 18.8717424169,
            "xmax": -66.9076521618,
            "ymax": 71.403759084
          },
          "defaultDatasetID": "USA_ESRI_2016",
          "datasets": [
            "USA_ACS_2016",
            "Landscape",
            "USA_ASR_2016",
            "USA_ESRI_2016",
            "USA_RMP_2016"
          ],
          "hierarchies": [
            {
              "ID": "landscape",
              "alias": "Landscape",
              "longDescription": "<p>The Esri Landscape Layers are a collection of data, currently available for the United States, that are applicable to a wide range of uses such as biogeographic analysis, natural resource management, and land use and conservation planning.  There are map layers that describe the physical structure of the land, such as hydrography, soil characteristics, geologic units, and land surface forms.  Plus, there are a variety of map layers in the biological and climatological domains, such as ecological systems, evapotranspiration, and critical habitat and other protected areas.  The term “landscape” also refers to the recoverable resources and manmade features that influence how we use the land and water.  Coal bed methane basins, oil shale basins, agricultural potential, and infrastructure, such as pipelines and transmission lines are examples of these types of landscape layers.</p><p><a href='http://arcg.is/WILhrp' target='_blank'>Learn more.</a></p>",
              "shortDescription": "This data source for the landscape US data is ESRI. Vintage 2012.",
              "variablesInfo": {
                "categories": [
                  "Landscape"
                ]
              },
              "levelsInfo": {
                "geographyLevels": [
                  "st",
                  "huc4",
                  "huc8",
                  "huc12",
                  "cy",
                  "huc10",
                  "huc2",
                  "huc6",
                  "us"
                ]
              },
              "datasets": [
                "Landscape"
              ]
            },
            {
              "ID": "census",
              "alias": "Standard",
              "longDescription": "<p>This data source is provided by Esri Inc.</p><p>Esri offers comprehensive demographic, lifestyle segmentation, consumer spending, and business content for a variety of geographic levels in the United States for use in applications such as site selection, profiling customers, analyzing markets, evaluating competitors, identifying opportunities, and many more.</p><p><a href='http://doc.arcgis.com/en/esri-demographics/data/us-intro.htm' target='_blank'>Learn more.</a></p>",
              "shortDescription": "This data source for the standard US data is ESRI. Vintage 2015.",
              "variablesInfo": {
                "categories": [
                  "Age",
                  "At Risk",
                  "Behaviors",
                  "Business",
                  "Education",
                  "Health",
                  "Households",
                  "Housing",
                  "Income",
                  "Jobs",
                  "Key Facts",
                  "Marital Status",
                  "Policy",
                  "Population",
                  "Poverty",
                  "Race",
                  "Spending",
                  "Supply and Demand",
                  "Tapestry"
                ]
              },
              "levelsInfo": {
                "geographyLevels": [
                  "Country",
                  "CensusTracts",
                  "BlockGroups",
                  "States",
                  "Counties",
                  "ZIPCodes",
                  "CBSAs",
                  "DMAs",
                  "CountySubdivisions",
                  "CongressionalDistricts",
                  "Places"
                ]
              },
              "datasets": [
                "USA_ASR_2016",
                "USA_ESRI_2016",
                "USA_ACS_2016",
                "USA_RMP_2016"
              ]
            }
          ],
          "defaultDataCollection": "KeyGlobalFacts",
          "dataCollections": "",
          "defaultReportTemplate": "Demographic and Income Profile",
          "currencySymbol": "$",
          "currencyFormat": "$0;-$0"
        }
      ]
    }

Note:

You can now navigate using the ISO standardized two-digit country code for each country.

https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/Countries/US?f=pjson

intersectingGeographies

Optional parameter to explicitly define the geographic layers used to provide geographic context during the enrichment process. For example, you can use this optional parameter to return the U.S. county and ZIP Code that each input study area intersects.

You can intersect input features defined in the studyAreas parameter with standard geography layers that are provided by the GeoEnrichment service for each country. You can also intersect features from a publicly available feature service.

The intersectingGeographies parameter should be constructed as a JSON array of an IntersectingGeographies object which consists of the following elements:

Value Description

geographyType

Used to specify the type of intersection layer. Specify standard to intersect with standard geography layers that are provided by the GeoEnrichment service for each country. Specify external to intersect features from a publicly available feature service.

layer

Specifies which standard geography layer should be intersected (e.g., U.S.Counties). These are an array of layers, so you can set one or many layers to intersect. These layers are defined in the Coverage section. At least one layer must be defined if geographyType is set to standard.

URL

Optional URL if you want to intersect features from an external feature service. This layer must be defined if geographyType is set to external.

name

Optional alias name you want to give the output geography layer being intersected. For example, you can set the name of U.S.Counties to just Counties in the GeoEnrichment output.

geometryType

Specifies how input studyAreas should intersect specified geography. If this is set to esriGeometryPoint, one intersecting feature is returned that intersects the centroid of each feature. If this is set to esriGeometryPolygon, all intersecting features are returned that intersect the input study area polygon.

For point-based input features, if geometryType is set to esriGeometryPoint, each input point is intersected with the geography layer that is being intersected. One intersecting feature will be returned for each input feature in this case. If the value is set to esriGeometryPolygon, all geographic features that intersect the buffer study area polygon that is created around each input point will be returned. There can be one or many intersecting features in this case.

If no features intersect the input points or polygons, no geocontext features will be returned.

outFields

You can optionally define the list of output fields from the intersected layer that will be appended to the GeoEnrichment response as geocontext items.

spatialRel

The optional spatial relationship to be applied on the intersecting layer. The supported spatial relationships include intersects, contains, envelope intersects, within, and so on. The default spatial relationship is intersects (esriSpatialRelIntersects).

where

You can define an optional where clause.

Default value

none

No intersecting geographies will be included in the output response.

Examples

Example 1 - Return all the U.S. county ID and names that intersect each input study area point:

intersectingGeographies=[{"geographyType":"standard","sourceCountry":"US","layer":"US.Counties","name":"Counties","outfields":["ID","Name"],"intersectionInfo":{"geometryType":"esriGeometryPolygon","spatialRel":"esriSpatialRelIntersects"}}]

[
    {
        "geographyType": "standard",
        "sourceCountry": "<country code>",
        "layer": "<standard geography level being intersected>",
        "name": "<alias name of geography layer>",
        "outfields":[<list of fields>],
        "intersectionInfo": {
            "geometryType": <"esriGeometryPoint" OR "esriGeometryPolygon">,
            "spatialRel": "esriSpatialRelIntersects"
        }
    }
]

Example 2 - Return all the U.S. ZIP Codes that intersect each output study area ring buffer:

intersectingGeographies=[{"geographyType":"standard","sourceCountry":"US", "layer":"US.ZIP5","name":"USZips","outfields":["ID"],"intersectionInfo":{"geometryType":"esriGeometryPolygon","spatialRel": "esriSpatialRelIntersects"}}]

Example 3 - Intersect features with an external feature service to provide additional geocontext:

intersectingGeographies=[{"geographyType":"external","sourceCountry":"US","url":"http://sampleserver5.arcgisonline.com/ArcGIS/rest/services/LocalGovernment/Recreation/FeatureServer/0","name":"USExtPoint","outfields":["*"],"intersectionInfo":{"geometryType":"esriGeometryPolygon","spatialRel":"esriSpatialRelIntersects"}}]

[
    {
        "geographyType": "external",
        "sourceCountry": "<country code>",
        "url": "<URL of feature service>",
        "name": "<name of layer>",
        "outfields":[<list of fields>],
        "intersectionInfo": {
            "geometryType": <"esriGeometryPoint" OR "esriGeometryPolygon">,
            "spatialRel": "esriSpatialRelIntersects"
        }
    }
]

Additional notes

  • An output field will be added to the GeoEnrichment output for each field specified in outFields.

returnGeometry

Optional parameter to request the output geometries in the response.

When this parameter is set to true, the output geometries associated with each feature will be included in the response. The output geometries will be in the spatial reference system defined by outSR.

Default value

false

The output geometries will not be returned with each feature in the response.

Examples

Example 1 - Request the output geometries in the response:

returnGeometry=true

Additional notes

  • Requesting output geometries can significantly increase the payload size of the output response which will increase the amount of time it takes to receive the response and negatively affect the speed and performance of any client applications consuming the service.

inSR

Optional parameter to define the input geometries in the studyAreas parameter in a specified spatial reference system.

When input points are defined in the studyAreas parameter, this optional parameter can be specified to explicitly indicate the spatial reference system of the point features. The parameter value can be specified as the well-known ID describing the projected coordinate system or geographic coordinate system.

Default value

4326

The standard latitude and longitude-based geographic coordinate system based on the WGS 1984 datum will be used.

Examples

Example 1 - Specify the input geometry in the Web Mercator (Auxiliary Sphere) projected coordinate system based on the WGS 1984 datum:

inSR=3857

Example 2 - Defining one point with non-default WKT:

studyareas =[{"geometry":{"x":-13629414,"y":4541375,"spatialReference":{"WKT":"PROJCS[\"WGS_1984_Web_Mercator_Auxiliary_Sphere\",GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Mercator_Auxiliary_Sphere\"],PARAMETER[\"False_Easting\",0.0],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Central_Meridian\",0.0],PARAMETER[\"Standard_Parallel_1\",0.0],PARAMETER[\"Auxiliary_Sphere_Type\",0.0],UNIT[\"Meter\",1.0]]"}}}]

Additional notes

outSR

Optional parameter to request the output geometries in a specified spatial reference system.

When returnGeometry is set to true, this optional parameter can be specified to explicitly indicate the spatial reference system of the output geometry. The parameter value can be specified as the well-known ID describing the projected coordinate system or geographic coordinate system.

Default value

4326

The standard latitude and longitude-based geographic coordinate system based on the WGS 1984 datum will be used.

Examples

Example 1 - Specify the output geometry in the Web Mercator (Auxiliary Sphere) projected coordinate system based on the WGS 1984 datum:

outSR=3857

Additional notes

suppressNullValues

Optional parameter to return only values that are not NULL in the output response. Adding the optional suppressNullValues parameter to any 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 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:

Enrich a single location defined by latitude and longitude coordinates.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-117.1956,"y":34.0572}}]&f=pjson

JSON response example 1
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 12542,
         "TOTHH": 4940,
         "AVGHHSZ": 2.52,
         "TOTMALES": 6027,
         "TOTFEMALES": 6516
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • A 1-mile ring buffer area is generated around the input location.
  • A list of attributes describing the location's demographic characteristics and geographic context, as defined in the default Data Collection and based on the generated area, is returned in the response.

        
      

Request example 2:

Simultaneously enrich multiple locations defined by latitude and longitude coordinates.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-122.435,"y":37.785},"attributes":{"myID":"point1"}},{"geometry":{"x":-122.433,"y":37.734},"attributes":{"myID":"point2"}}]&dataCollections=["KeyGlobalFacts"]&f=pjson

JSON response example 2
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "myID": "myID",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "myID",
        "type": "esriFieldTypeString",
        "alias": "myID",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "US",
         "myID": "point1",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 104173,
         "TOTHH": 56477,
         "AVGHHSZ": 1.79,
         "TOTMALES": 51587,
         "TOTFEMALES": 52586
        }
       },
       {
        "attributes": {
         "ID": "1",
         "OBJECTID": 2,
         "sourceCountry": "US",
         "myID": "point2",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 66242,
         "TOTHH": 23823,
         "AVGHHSZ": 2.75,
         "TOTMALES": 33115,
         "TOTFEMALES": 33127
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • A 1-mile ring buffer area is generated around each input location.
  • A list of attributes describing each location's demographic characteristics and geographic context, as defined in the KeyGlobalFacts Data Collection and based on the generated areas, is returned in the response.
  • User defined attributes are submitted with the input features and will be carried over into the response. This can be useful in associating the input features with the output.

        
      

Request example 3:

Enrich a single location defined by latitude and longitude coordinates with attributes defined in a specified Data Collection.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-117.1956,"y":34.0572}}]&dataCollections=["KeyUSFacts"]&f=pjson

JSON response example 3
{
  "results" : [ {
    "paramName" : "GeoEnrichmentResult",
    "dataType" : "GeoEnrichmentResult",
    "value" : {
      "version" : "2.0",
      "FeatureSet" : [ {
        "displayFieldName" : "",
        "fieldAliases" : {
          "ID" : "ID",
          "OBJECTID" : "Object ID",
          "sourceCountry" : "sourceCountry",
          "areaType" : "areaType",
          "bufferUnits" : "bufferUnits",
          "bufferUnitsAlias" : "bufferUnitsAlias",
          "bufferRadii" : "bufferRadii",
          "aggregationMethod" : "aggregationMethod",
          "HasData" : "HasData",
          "TOTPOP00" : "2000 Total Population",
          "TOTPOP10" : "2010 Total Population",

          ...

          "PCIGRWCYFY" : "2016-2021 Growth/Yr: Per Capita Income"
        },
        "spatialReference" : {
          "wkid" : 4326,
          "latestWkid" : 4326
        },
        "fields" : [ {
          "name" : "ID",
          "type" : "esriFieldTypeString",
          "alias" : "ID",
          "length" : 256
        }, {
          "name" : "OBJECTID",
          "type" : "esriFieldTypeOID",
          "alias" : "Object ID"
        }, {
          "name" : "sourceCountry",
          "type" : "esriFieldTypeString",
          "alias" : "sourceCountry",
          "length" : 256
        }, {
          "name" : "areaType",
          "type" : "esriFieldTypeString",
          "alias" : "areaType",
          "length" : 256
        }, {
          "name" : "bufferUnits",
          "type" : "esriFieldTypeString",
          "alias" : "bufferUnits",
          "length" : 256
        }, {
          "name" : "bufferUnitsAlias",
          "type" : "esriFieldTypeString",
          "alias" : "bufferUnitsAlias",
          "length" : 256
        }, {
          "name" : "bufferRadii",
          "type" : "esriFieldTypeDouble",
          "alias" : "bufferRadii"
        }, {
          "name" : "aggregationMethod",
          "type" : "esriFieldTypeString",
          "alias" : "aggregationMethod",
          "length" : 256
        }, {
          "name" : "HasData",
          "type" : "esriFieldTypeInteger",
          "alias" : "HasData"
        }, {
          "name" : "TOTPOP00",
          "type" : "esriFieldTypeDouble",
          "alias" : "2000 Total Population",
          "fullName" : "KeyUSFacts.TOTPOP00",
          "component" : "demographics",
          "decimals" : 0,
          "units" : "count"
        }, {
          "name" : "TOTPOP10",
          "type" : "esriFieldTypeDouble",
          "alias" : "2010 Total Population",
          "fullName" : "KeyUSFacts.TOTPOP10",
          "component" : "demographics",
          "decimals" : 0,
          "units" : "count"
        }, 

        ...

           {
          "name" : "PCIGRWCYFY",
          "type" : "esriFieldTypeDouble",
          "alias" : "2016-2021 Growth/Yr: Per Capita Income",
          "fullName" : "KeyUSFacts.PCIGRWCYFY",
          "component" : "demographics",
          "decimals" : 2,
          "units" : "pct"
        } ],
        "features" : [ {
          "attributes" : {
            "ID" : "0",
            "OBJECTID" : 1,
            "sourceCountry" : "US",
            "areaType" : "RingBuffer",
            "bufferUnits" : "esriMiles",
            "bufferUnitsAlias" : "mile",
            "bufferRadii" : 1,
            "aggregationMethod" : "BlockApportionment:US.BlockGroups",
            "HasData" : 1,
            "TOTPOP00" : 11914,
            "TOTPOP10" : 12637,

            ...

            "PCIGRWCYFY" : 1.04
          }
        } ]
      } ]
    }
  } ],
  "messages" : [ ]
}

Notes:

  • The response has been abbreviated in the example where "..." is noted.
  • A 1-mile ring buffer area is generated around the input location.
  • A list of attributes describing the location's demographic characteristics and geographic context, as defined in the KeyUSFacts Data Collection and based on the generated area, is returned in the response.

        
      

Request example 4:

Simultaneously enrich locations in multiple countries or datasets defined by latitude and longitude coordinates with attributes defined in the default Data Collection (KeyGlobalFacts).

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-122.435,"y":37.785}},{"geometry":{"x":-122.433,"y":37.734}},{"geometry":{"x":-79.345, "y":43.69}}]&dataCollections=["KeyGlobalFacts"]&f=pjson

JSON response example 4
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 104173,
         "TOTHH": 56477,
         "AVGHHSZ": 1.79,
         "TOTMALES": 51587,
         "TOTFEMALES": 52586
        }
       },
       {
        "attributes": {
         "ID": "1",
         "OBJECTID": 2,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 66242,
         "TOTHH": 23823,
         "AVGHHSZ": 2.75,
         "TOTMALES": 33115,
         "TOTFEMALES": 33127
        }
       },
       {
        "attributes": {
         "ID": "2",
         "OBJECTID": 3,
         "sourceCountry": "CA",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:CAN.DA",
         "HasData": 1,
         "TOTPOP": 56681,
         "TOTHH": 13653,
         "AVGHHSZ": 2.41,
         "TOTMALES": 27672,
         "TOTFEMALES": 29008
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • A 1-mile ring buffer area is generated around each input location.
  • A list of attributes describing each location's demographic characteristics and geographic context, as defined in the KeyGlobalFacts Data Collection and based on the generated areas, is returned in the response.

        
      

Request example 5:

Simultaneously enrich locations in multiple countries or datasets defined by latitude and longitude coordinates with attributes defined from the default Data Collection (KeyGlobalFacts).

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-122.435,"y":37.785}},{"geometry":{"x":-122.433,"y":37.734}},{"geometry":{"x":-79.345,"y":43.69}}]&f=pjson

JSON response example 5
{
  "results" : [ {
    "paramName" : "GeoEnrichmentResult",
    "dataType" : "GeoEnrichmentResult",
    "value" : {
      "version" : "2.0",
      "FeatureSet" : [ {
        "displayFieldName" : "",
        "fieldAliases" : {
          "ID" : "ID",
          "OBJECTID" : "Object ID",
          "sourceCountry" : "sourceCountry",
          "areaType" : "areaType",
          "bufferUnits" : "bufferUnits",
          "bufferUnitsAlias" : "bufferUnitsAlias",
          "bufferRadii" : "bufferRadii",
          "aggregationMethod" : "aggregationMethod",
          "HasData" : "HasData",
          "TOTPOP" : "Total Population",
          "TOTHH" : "Total Households",
          "AVGHHSZ" : "Average Household Size",
          "TOTMALES" : "Male Population",
          "TOTFEMALES" : "Female Population"
        },
        "spatialReference" : {
          "wkid" : 4326,
          "latestWkid" : 4326
        },
        "fields" : [ {
          "name" : "ID",
          "type" : "esriFieldTypeString",
          "alias" : "ID",
          "length" : 256
        }, {
          "name" : "OBJECTID",
          "type" : "esriFieldTypeOID",
          "alias" : "Object ID"
        }, {
          "name" : "sourceCountry",
          "type" : "esriFieldTypeString",
          "alias" : "sourceCountry",
          "length" : 256
        }, {
          "name" : "areaType",
          "type" : "esriFieldTypeString",
          "alias" : "areaType",
          "length" : 256
        }, {
          "name" : "bufferUnits",
          "type" : "esriFieldTypeString",
          "alias" : "bufferUnits",
          "length" : 256
        }, {
          "name" : "bufferUnitsAlias",
          "type" : "esriFieldTypeString",
          "alias" : "bufferUnitsAlias",
          "length" : 256
        }, {
          "name" : "bufferRadii",
          "type" : "esriFieldTypeDouble",
          "alias" : "bufferRadii"
        }, {
          "name" : "aggregationMethod",
          "type" : "esriFieldTypeString",
          "alias" : "aggregationMethod",
          "length" : 256
        }, {
          "name" : "HasData",
          "type" : "esriFieldTypeInteger",
          "alias" : "HasData"
        }, {
          "name" : "TOTPOP",
          "type" : "esriFieldTypeDouble",
          "alias" : "Total Population",
          "fullName" : "KeyGlobalFacts.TOTPOP",
          "component" : "demographics",
          "decimals" : 0,
          "units" : "count"
        }, {
          "name" : "TOTHH",
          "type" : "esriFieldTypeDouble",
          "alias" : "Total Households",
          "fullName" : "KeyGlobalFacts.TOTHH",
          "component" : "demographics",
          "decimals" : 0,
          "units" : "count"
        }, {
          "name" : "AVGHHSZ",
          "type" : "esriFieldTypeDouble",
          "alias" : "Average Household Size",
          "fullName" : "KeyGlobalFacts.AVGHHSZ",
          "component" : "scripts",
          "decimals" : 2,
          "units" : "count"
        }, {
          "name" : "TOTMALES",
          "type" : "esriFieldTypeDouble",
          "alias" : "Male Population",
          "fullName" : "KeyGlobalFacts.TOTMALES",
          "component" : "demographics",
          "decimals" : 0,
          "units" : "count"
        }, {
          "name" : "TOTFEMALES",
          "type" : "esriFieldTypeDouble",
          "alias" : "Female Population",
          "fullName" : "KeyGlobalFacts.TOTFEMALES",
          "component" : "demographics",
          "decimals" : 0,
          "units" : "count"
        } ],
        "features" : [ {
          "attributes" : {
            "ID" : "0",
            "OBJECTID" : 1,
            "sourceCountry" : "US",
            "areaType" : "RingBuffer",
            "bufferUnits" : "esriMiles",
            "bufferUnitsAlias" : "Miles",
            "bufferRadii" : 1,
            "aggregationMethod" : "BlockApportionment:US.BlockGroups",
            "HasData" : 1,
            "TOTPOP" : 104173,
            "TOTHH" : 56477,
            "AVGHHSZ" : 1.79,
            "TOTMALES" : 51587,
            "TOTFEMALES" : 52586
          }
        }, {
          "attributes" : {
            "ID" : "1",
            "OBJECTID" : 2,
            "sourceCountry" : "US",
            "areaType" : "RingBuffer",
            "bufferUnits" : "esriMiles",
            "bufferUnitsAlias" : "Miles",
            "bufferRadii" : 1,
            "aggregationMethod" : "BlockApportionment:US.BlockGroups",
            "HasData" : 1,
            "TOTPOP" : 66242,
            "TOTHH" : 23823,
            "AVGHHSZ" : 2.75,
            "TOTMALES" : 33115,
            "TOTFEMALES" : 33127
          }
        }, {
          "attributes" : {
            "ID" : "2",
            "OBJECTID" : 3,
            "sourceCountry" : "CA",
            "areaType" : "RingBuffer",
            "bufferUnits" : "esriMiles",
            "bufferUnitsAlias" : "Miles",
            "bufferRadii" : 1,
            "aggregationMethod" : "BlockApportionment:CAN.DA",
            "HasData" : 1,
            "TOTPOP" : 61899,
            "TOTHH" : 15770,
            "AVGHHSZ" : 2.36,
            "TOTMALES" : 30104,
            "TOTFEMALES" : 31795
          }
        } ]
      } ]
    }
  } ],
  "messages" : [ ]
}

Notes:

  • A 1-mile ring buffer area is generated around each input location and the associated geometry is returned in the response.
  • A list of attributes describing each location's demographic characteristics and geographic context, as defined in the KeyGlobalFacts Data Collection and based on the generated areas, is returned in the response.

        
      

Request example 6:

Simultaneously enrich multiple locations in a single country defined by latitude and longitude coordinates with attributes defined in a specified Data Collection and include the associated geometry in the response. Additionally, specify the country or dataset through the useData parameter to provide the service with a performance hint.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-122.435,"y":37.785}},{"geometry":{"x":-122.433,"y":37.734}}]&dataCollections=["KeyUSFacts"]&useData={"sourceCountry":"US"}&returngeometry=true&f=pjson

JSON response example 6
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP00": "2000 Total Population",
       "TOTPOP10": "2010 Total Population",
       "TOTPOP_CY": "2016 Total Population",
       "TOTPOP_FY": "2021 Total Population",
       "GQPOP_CY": "2016 Population in Group Quarters",
       "DIVINDX_CY": "2016 Diversity Index",
       "TOTHH00": "2000 Total Households",
       "TOTHH10": "2010 Total Households",
       "TOTHH_CY": "2016 Total Households",
       "TOTHH_FY": "2021 Total Households",
       "AVGHHSZ_CY": "2016 Average Household Size",
       "MEDHINC_CY": "2016 Median Household Income",
       "MEDHINC_FY": "2021 Median Household Income",
       "AVGHINC_CY": "2016 Average Household Income",
       "AVGHINC_FY": "2021 Average Household Income",
       "PCI_CY": "2016 Per Capita Income",
       "PCI_FY": "2021 Per Capita Income",
       "TOTHU00": "2000 Total Housing Units",
       "TOTHU10": "2010 Total Housing Units",
       "TOTHU_CY": "2016 Total Housing Units",
       "TOTHU_FY": "2021 Total Housing Units",
       "OWNER_CY": "2016 Owner Occupied HUs",
       "OWNER_FY": "2021 Owner Occupied HUs",
       "RENTER_CY": "2016 Renter Occupied HUs",
       "RENTER_FY": "2021 Renter Occupied HUs",
       "VACANT_CY": "2016 Vacant Housing Units",
       "VACANT_FY": "2021 Vacant Housing Units",
       "MEDVAL_CY": "2016 Median Home Value",
       "MEDVAL_FY": "2021 Median Home Value",
       "AVGVAL_CY": "2016 Average Home Value",
       "AVGVAL_FY": "2021 Average Home Value",
       "POPGRW10CY": "2010-2016 Growth Rate: Population",
       "HHGRW10CY": "2010-2016 Growth Rate: Households",
       "FAMGRW10CY": "2010-2016 Growth Rate: Families",
       "POPGRWCYFY": "2016-2021 Growth/Yr: Population",
       "HHGRWCYFY": "2016-2021 Growth/Yr: Households",
       "FAMGRWCYFY": "2016-2021 Growth/Yr: Families",
       "MHIGRWCYFY": "2016-2021 Growth/Yr: Median HH Inc",
       "PCIGRWCYFY": "2016-2021 Growth/Yr: Per Capita Income"
      },
      "geometryType": "esriGeometryPolygon",
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP00",
        "type": "esriFieldTypeDouble",
        "alias": "2000 Total Population",
        "fullName": "KeyUSFacts.TOTPOP00",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTPOP10",
        "type": "esriFieldTypeDouble",
        "alias": "2010 Total Population",
        "fullName": "KeyUSFacts.TOTPOP10",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTPOP_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Total Population",
        "fullName": "KeyUSFacts.TOTPOP_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTPOP_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Total Population",
        "fullName": "KeyUSFacts.TOTPOP_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "GQPOP_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Population in Group Quarters",
        "fullName": "KeyUSFacts.GQPOP_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "DIVINDX_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Diversity Index",
        "fullName": "KeyUSFacts.DIVINDX_CY",
        "component": "demographics",
        "decimals": 1,
        "units": "count"
       },
       {
        "name": "TOTHH00",
        "type": "esriFieldTypeDouble",
        "alias": "2000 Total Households",
        "fullName": "KeyUSFacts.TOTHH00",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH10",
        "type": "esriFieldTypeDouble",
        "alias": "2010 Total Households",
        "fullName": "KeyUSFacts.TOTHH10",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Total Households",
        "fullName": "KeyUSFacts.TOTHH_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Total Households",
        "fullName": "KeyUSFacts.TOTHH_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Average Household Size",
        "fullName": "KeyUSFacts.AVGHHSZ_CY",
        "component": "demographics",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "MEDHINC_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Median Household Income",
        "fullName": "KeyUSFacts.MEDHINC_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "MEDHINC_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Median Household Income",
        "fullName": "KeyUSFacts.MEDHINC_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "AVGHINC_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Average Household Income",
        "fullName": "KeyUSFacts.AVGHINC_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "AVGHINC_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Average Household Income",
        "fullName": "KeyUSFacts.AVGHINC_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "PCI_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Per Capita Income",
        "fullName": "KeyUSFacts.PCI_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "PCI_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Per Capita Income",
        "fullName": "KeyUSFacts.PCI_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "TOTHU00",
        "type": "esriFieldTypeDouble",
        "alias": "2000 Total Housing Units",
        "fullName": "KeyUSFacts.TOTHU00",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHU10",
        "type": "esriFieldTypeDouble",
        "alias": "2010 Total Housing Units",
        "fullName": "KeyUSFacts.TOTHU10",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHU_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Total Housing Units",
        "fullName": "KeyUSFacts.TOTHU_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHU_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Total Housing Units",
        "fullName": "KeyUSFacts.TOTHU_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "OWNER_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Owner Occupied HUs",
        "fullName": "KeyUSFacts.OWNER_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "OWNER_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Owner Occupied HUs",
        "fullName": "KeyUSFacts.OWNER_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "RENTER_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Renter Occupied HUs",
        "fullName": "KeyUSFacts.RENTER_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "RENTER_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Renter Occupied HUs",
        "fullName": "KeyUSFacts.RENTER_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "VACANT_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Vacant Housing Units",
        "fullName": "KeyUSFacts.VACANT_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "VACANT_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Vacant Housing Units",
        "fullName": "KeyUSFacts.VACANT_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "MEDVAL_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Median Home Value",
        "fullName": "KeyUSFacts.MEDVAL_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "MEDVAL_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Median Home Value",
        "fullName": "KeyUSFacts.MEDVAL_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "AVGVAL_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Average Home Value",
        "fullName": "KeyUSFacts.AVGVAL_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "AVGVAL_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Average Home Value",
        "fullName": "KeyUSFacts.AVGVAL_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "POPGRW10CY",
        "type": "esriFieldTypeDouble",
        "alias": "2010-2016 Growth Rate: Population",
        "fullName": "KeyUSFacts.POPGRW10CY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "HHGRW10CY",
        "type": "esriFieldTypeDouble",
        "alias": "2010-2016 Growth Rate: Households",
        "fullName": "KeyUSFacts.HHGRW10CY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "FAMGRW10CY",
        "type": "esriFieldTypeDouble",
        "alias": "2010-2016 Growth Rate: Families",
        "fullName": "KeyUSFacts.FAMGRW10CY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "POPGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Population",
        "fullName": "KeyUSFacts.POPGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "HHGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Households",
        "fullName": "KeyUSFacts.HHGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "FAMGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Families",
        "fullName": "KeyUSFacts.FAMGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "MHIGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Median HH Inc",
        "fullName": "KeyUSFacts.MHIGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "PCIGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Per Capita Income",
        "fullName": "KeyUSFacts.PCIGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP00": 97301,
         "TOTPOP10": 98177,
         "TOTPOP_CY": 104173,
         "TOTPOP_FY": 110262,
         "GQPOP_CY": 3016,
         "DIVINDX_CY": 64.6,
         "TOTHH00": 52642,
         "TOTHH10": 53219,
         "TOTHH_CY": 56477,
         "TOTHH_FY": 59820,
         "AVGHHSZ_CY": 1.79,
         "MEDHINC_CY": 76917,
         "MEDHINC_FY": 87188,
         "AVGHINC_CY": 118946,
         "AVGHINC_FY": 129146,
         "PCI_CY": 65652,
         "PCI_FY": 71181,
         "TOTHU00": 55550,
         "TOTHU10": 58211,
         "TOTHU_CY": 61307,
         "TOTHU_FY": 64913,
         "OWNER_CY": 11226,
         "OWNER_FY": 11814,
         "RENTER_CY": 45251,
         "RENTER_FY": 48006,
         "VACANT_CY": 4830,
         "VACANT_FY": 5093,
         "MEDVAL_CY": 945202,
         "MEDVAL_FY": 969175,
         "AVGVAL_CY": 925283,
         "AVGVAL_FY": 953885,
         "POPGRW10CY": 0.95,
         "HHGRW10CY": 0.96,
         "FAMGRW10CY": 1.05,
         "POPGRWCYFY": 1.14,
         "HHGRWCYFY": 1.16,
         "FAMGRWCYFY": 1.22,
         "MHIGRWCYFY": 2.54,
         "PCIGRWCYFY": 1.63
        },
        "geometry": {
         "rings": [
          [
           [
            -122.43499999999999,
            37.79949959688911
           ],
           [
            -122.43373930598597,
            37.799465041596754
           ],

           ...

           [
            -122.43499999999999,
            37.79949959688911
           ]
          ]
         ]
        }
       },
       {
        "attributes": {
         "ID": "1",
         "OBJECTID": 2,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP00": 64278,
         "TOTPOP10": 64376,
         "TOTPOP_CY": 66242,
         "TOTPOP_FY": 68917,
         "GQPOP_CY": 672,
         "DIVINDX_CY": 80.4,
         "TOTHH00": 23069,
         "TOTHH10": 23249,
         "TOTHH_CY": 23823,
         "TOTHH_FY": 24712,
         "AVGHHSZ_CY": 2.75,
         "MEDHINC_CY": 90626,
         "MEDHINC_FY": 102977,
         "AVGHINC_CY": 124424,
         "AVGHINC_FY": 135946,
         "PCI_CY": 45050,
         "PCI_FY": 49020,
         "TOTHU00": 23724,
         "TOTHU10": 24509,
         "TOTHU_CY": 25040,
         "TOTHU_FY": 25980,
         "OWNER_CY": 13946,
         "OWNER_FY": 14427,
         "RENTER_CY": 9877,
         "RENTER_FY": 10285,
         "VACANT_CY": 1217,
         "VACANT_FY": 1268,
         "MEDVAL_CY": 768780,
         "MEDVAL_FY": 798287,
         "AVGVAL_CY": 805536,
         "AVGVAL_FY": 832485,
         "POPGRW10CY": 0.46,
         "HHGRW10CY": 0.39,
         "FAMGRW10CY": 0.5,
         "POPGRWCYFY": 0.79,
         "HHGRWCYFY": 0.74,
         "FAMGRWCYFY": 0.81,
         "MHIGRWCYFY": 2.59,
         "PCIGRWCYFY": 1.7
        },
        "geometry": {
         "rings": [
          [
           [
            -122.43299999999999,
            37.74849972269633
           ],
           [
            -122.43174017166517,
            37.748465167116514
           ],

           ...

           [
            -122.43299999999999,
            37.74849972269633
           ]
          ]
         ]
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • The response has been abbreviated in the example where "..." is noted.
  • Further information about the significant benefits of explicitly specifying the country or dataset in advance can be found in the useData parameter description.
  • A 1-mile ring buffer area is generated around each input location.
  • A list of attributes describing each location's demographic characteristics and geographic context, as defined in the KeyUSFacts Data Collection and based on the generated areas, is returned in the response.

JSON response rendered with ArcGIS for Desktop.

Two 1 mile rings

Notes:

  • Transparency and fill properties have been adjusted for illustrative purposes.

        
      

Request example 7:

Simultaneously enrich multiple locations in a single country defined by latitude and longitude coordinates with attributes defined in the default Data Collection. Instead of generating the default 1-mile ring buffer areas, generate and use a custom-defined ring buffer area around each location. Additionally, specify the country or dataset through the useData parameter to provide the service with a performance hint.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-122.435,"y":37.785}},{"geometry":{"x":-122.433,"y":37.734}}]&UseData={"sourceCountry":"US"}&StudyAreasOptions={"areaType":"RingBuffer","bufferUnits":"esriMiles","bufferRadii":[3]}&dataCollections=["KeyGlobalFacts"]&f=pjson

JSON response example 7
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "miles",
         "bufferRadii": 3,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 504871,
         "TOTHH": 251905,
         "AVGHHSZ": 1.93,
         "TOTMALES": 262129,
         "TOTFEMALES": 242742
        }
       },
       {
        "attributes": {
         "ID": "1",
         "OBJECTID": 2,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "miles",
         "bufferRadii": 3,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 481637,
         "TOTHH": 179047,
         "AVGHHSZ": 2.64,
         "TOTMALES": 245970,
         "TOTFEMALES": 235666
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • Further information about the significant benefits of explicitly specifying the country or dataset in advance can be found in the useData parameter description.
  • A 3-mile ring buffer area is generated around each input location.
  • A list of attributes describing each location's demographic characteristics and geographic context, as defined in the KeyGlobalFacts Data Collection and based on the generated areas, is returned in the response.

        
      

Request example 8:

Simultaneously enrich multiple locations in a single country defined by latitude and longitude coordinates with attributes defined in a specified Data Collection. Instead of generating the default 1-mile ring buffer areas for all locations, you will generate and use varying ring buffer areas around each location.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-73.270588,"y":45.599518},"areaType":"RingBuffer","bufferUnits":"esriMiles","bufferRadii":[1]},{"geometry":{"x":-75.320576,"y":40.048835},"areaType":"RingBuffer","bufferUnits":"esriMiles","bufferRadii":[5]}]&dataCollections=["KeyUSFacts"]&f=pjson

JSON response example 8
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP00": "2000 Total Population",
       "TOTPOP10": "2010 Total Population",
       "TOTPOP_CY": "2016 Total Population",
       "TOTPOP_FY": "2021 Total Population",
       "GQPOP_CY": "2016 Population in Group Quarters",
       "DIVINDX_CY": "2016 Diversity Index",
       "TOTHH00": "2000 Total Households",
       "TOTHH10": "2010 Total Households",
       "TOTHH_CY": "2016 Total Households",
       "TOTHH_FY": "2021 Total Households",
       "AVGHHSZ_CY": "2016 Average Household Size",
       "MEDHINC_CY": "2016 Median Household Income",
       "MEDHINC_FY": "2021 Median Household Income",
       "AVGHINC_CY": "2016 Average Household Income",
       "AVGHINC_FY": "2021 Average Household Income",
       "PCI_CY": "2016 Per Capita Income",
       "PCI_FY": "2021 Per Capita Income",
       "TOTHU00": "2000 Total Housing Units",
       "TOTHU10": "2010 Total Housing Units",
       "TOTHU_CY": "2016 Total Housing Units",
       "TOTHU_FY": "2021 Total Housing Units",
       "OWNER_CY": "2016 Owner Occupied HUs",
       "OWNER_FY": "2021 Owner Occupied HUs",
       "RENTER_CY": "2016 Renter Occupied HUs",
       "RENTER_FY": "2021 Renter Occupied HUs",
       "VACANT_CY": "2016 Vacant Housing Units",
       "VACANT_FY": "2021 Vacant Housing Units",
       "MEDVAL_CY": "2016 Median Home Value",
       "MEDVAL_FY": "2021 Median Home Value",
       "AVGVAL_CY": "2016 Average Home Value",
       "AVGVAL_FY": "2021 Average Home Value",
       "POPGRW10CY": "2010-2016 Growth Rate: Population",
       "HHGRW10CY": "2010-2016 Growth Rate: Households",
       "FAMGRW10CY": "2010-2016 Growth Rate: Families",
       "POPGRWCYFY": "2016-2021 Growth/Yr: Population",
       "HHGRWCYFY": "2016-2021 Growth/Yr: Households",
       "FAMGRWCYFY": "2016-2021 Growth/Yr: Families",
       "MHIGRWCYFY": "2016-2021 Growth/Yr: Median HH Inc",
       "PCIGRWCYFY": "2016-2021 Growth/Yr: Per Capita Income"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP00",
        "type": "esriFieldTypeDouble",
        "alias": "2000 Total Population",
        "fullName": "KeyUSFacts.TOTPOP00",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTPOP10",
        "type": "esriFieldTypeDouble",
        "alias": "2010 Total Population",
        "fullName": "KeyUSFacts.TOTPOP10",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTPOP_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Total Population",
        "fullName": "KeyUSFacts.TOTPOP_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTPOP_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Total Population",
        "fullName": "KeyUSFacts.TOTPOP_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "GQPOP_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Population in Group Quarters",
        "fullName": "KeyUSFacts.GQPOP_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "DIVINDX_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Diversity Index",
        "fullName": "KeyUSFacts.DIVINDX_CY",
        "component": "demographics",
        "decimals": 1,
        "units": "count"
       },
       {
        "name": "TOTHH00",
        "type": "esriFieldTypeDouble",
        "alias": "2000 Total Households",
        "fullName": "KeyUSFacts.TOTHH00",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH10",
        "type": "esriFieldTypeDouble",
        "alias": "2010 Total Households",
        "fullName": "KeyUSFacts.TOTHH10",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Total Households",
        "fullName": "KeyUSFacts.TOTHH_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Total Households",
        "fullName": "KeyUSFacts.TOTHH_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Average Household Size",
        "fullName": "KeyUSFacts.AVGHHSZ_CY",
        "component": "demographics",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "MEDHINC_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Median Household Income",
        "fullName": "KeyUSFacts.MEDHINC_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "MEDHINC_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Median Household Income",
        "fullName": "KeyUSFacts.MEDHINC_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "AVGHINC_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Average Household Income",
        "fullName": "KeyUSFacts.AVGHINC_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "AVGHINC_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Average Household Income",
        "fullName": "KeyUSFacts.AVGHINC_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "PCI_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Per Capita Income",
        "fullName": "KeyUSFacts.PCI_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "PCI_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Per Capita Income",
        "fullName": "KeyUSFacts.PCI_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "TOTHU00",
        "type": "esriFieldTypeDouble",
        "alias": "2000 Total Housing Units",
        "fullName": "KeyUSFacts.TOTHU00",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHU10",
        "type": "esriFieldTypeDouble",
        "alias": "2010 Total Housing Units",
        "fullName": "KeyUSFacts.TOTHU10",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHU_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Total Housing Units",
        "fullName": "KeyUSFacts.TOTHU_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHU_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Total Housing Units",
        "fullName": "KeyUSFacts.TOTHU_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "OWNER_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Owner Occupied HUs",
        "fullName": "KeyUSFacts.OWNER_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "OWNER_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Owner Occupied HUs",
        "fullName": "KeyUSFacts.OWNER_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "RENTER_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Renter Occupied HUs",
        "fullName": "KeyUSFacts.RENTER_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "RENTER_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Renter Occupied HUs",
        "fullName": "KeyUSFacts.RENTER_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "VACANT_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Vacant Housing Units",
        "fullName": "KeyUSFacts.VACANT_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "VACANT_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Vacant Housing Units",
        "fullName": "KeyUSFacts.VACANT_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "MEDVAL_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Median Home Value",
        "fullName": "KeyUSFacts.MEDVAL_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "MEDVAL_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Median Home Value",
        "fullName": "KeyUSFacts.MEDVAL_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "AVGVAL_CY",
        "type": "esriFieldTypeDouble",
        "alias": "2016 Average Home Value",
        "fullName": "KeyUSFacts.AVGVAL_CY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "AVGVAL_FY",
        "type": "esriFieldTypeDouble",
        "alias": "2021 Average Home Value",
        "fullName": "KeyUSFacts.AVGVAL_FY",
        "component": "demographics",
        "decimals": 0,
        "units": "currency",
        "currency": "$"
       },
       {
        "name": "POPGRW10CY",
        "type": "esriFieldTypeDouble",
        "alias": "2010-2016 Growth Rate: Population",
        "fullName": "KeyUSFacts.POPGRW10CY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "HHGRW10CY",
        "type": "esriFieldTypeDouble",
        "alias": "2010-2016 Growth Rate: Households",
        "fullName": "KeyUSFacts.HHGRW10CY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "FAMGRW10CY",
        "type": "esriFieldTypeDouble",
        "alias": "2010-2016 Growth Rate: Families",
        "fullName": "KeyUSFacts.FAMGRW10CY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "POPGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Population",
        "fullName": "KeyUSFacts.POPGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "HHGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Households",
        "fullName": "KeyUSFacts.HHGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "FAMGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Families",
        "fullName": "KeyUSFacts.FAMGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "MHIGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Median HH Inc",
        "fullName": "KeyUSFacts.MHIGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       },
       {
        "name": "PCIGRWCYFY",
        "type": "esriFieldTypeDouble",
        "alias": "2016-2021 Growth/Yr: Per Capita Income",
        "fullName": "KeyUSFacts.PCIGRWCYFY",
        "component": "demographics",
        "decimals": 2,
        "units": "pct"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "1",
         "OBJECTID": 1,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "miles",
         "bufferRadii": 5,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP00": 204729,
         "TOTPOP10": 207593,
         "TOTPOP_CY": 211756,
         "TOTPOP_FY": 215676,
         "GQPOP_CY": 12183,
         "DIVINDX_CY": 41.5,
         "TOTHH00": 79727,
         "TOTHH10": 80615,
         "TOTHH_CY": 81959,
         "TOTHH_FY": 83360,
         "AVGHHSZ_CY": 2.44,
         "MEDHINC_CY": 88938,
         "MEDHINC_FY": 101141,
         "AVGHINC_CY": 132874,
         "AVGHINC_FY": 144030,
         "PCI_CY": 52691,
         "PCI_FY": 56910,
         "TOTHU00": 82914,
         "TOTHU10": 86564,
         "TOTHU_CY": 88625,
         "TOTHU_FY": 90247,
         "OWNER_CY": 53783,
         "OWNER_FY": 54534,
         "RENTER_CY": 28176,
         "RENTER_FY": 28826,
         "VACANT_CY": 6666,
         "VACANT_FY": 6887,
         "MEDVAL_CY": 388435,
         "MEDVAL_FY": 388799,
         "AVGVAL_CY": 498243,
         "AVGVAL_FY": 502986,
         "POPGRW10CY": 0.32,
         "HHGRW10CY": 0.26,
         "FAMGRW10CY": 0.08,
         "POPGRWCYFY": 0.37,
         "HHGRWCYFY": 0.34,
         "FAMGRWCYFY": 0.22,
         "MHIGRWCYFY": 2.6,
         "PCIGRWCYFY": 1.55
        }
       }
      ]
     }
    ]
   }
  }
 ],
}

Notes:

  • A 1-mile ring buffer area is generated around the first input location and a 5-mile ring buffer area is generated around the second input location.
  • A list of attributes describing each location's demographic characteristics and geographic context, as defined in the KeyUSFacts Data Collection and based on the generated areas, is returned in the response.

        
      

Request example 9:

Enrich a single location defined by latitude and longitude coordinates with attributes defined in the default Data Collection. Instead of generating the default 1-mile ring buffer areas for the location, generate and use a drive-time service area around the location.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-117.1956,"y":34.0572}}]&studyAreasOptions={"areaType":"DriveTimeBuffer","bufferUnits":"esriDriveTimeUnitsMinutes","bufferRadii":[5]}&dataCollections=["KeyGlobalFacts"]&f=pjson

JSON response example 9
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "US",
         "areaType": "DriveTimeBuffer",
         "bufferUnits": "esriDriveTimeUnitsMinutes",
         "bufferUnitsAlias": "minutes",
         "bufferRadii": 5,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 11111,
         "TOTHH": 4294,
         "AVGHHSZ": 2.57,
         "TOTMALES": 5353,
         "TOTFEMALES": 5758
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • A 5-minute drive-time service area is generated around the input location.
  • A list of attributes describing the location's demographic characteristics and geographic context, as defined in the KeyGlobalFacts Data Collection and based on the generated area, is returned in the response.

        
      

Request example 10:

Enrich a single location defined by latitude and longitude coordinates with attributes defined in the default Data Collection and return data only for the intersecting county. This example will return data for the county feature from which the point intersects.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyareas=[{"geometry":{"x":-117.1956,"y":34.0572},"areaType":"StandardGeography","intersectingGeographies":[{"sourceCountry":"US","layer":"US.Counties"}]}]&useData={"sourceCountry":"US"}&f=pjson

JSON response example 10
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "StdGeographyLevel": "StdGeographyLevel",
       "StdGeographyName": "StdGeographyName",
       "StdGeographyID": "StdGeographyID",
       "sourceCountry": "sourceCountry",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "StdGeographyLevel",
        "type": "esriFieldTypeString",
        "alias": "StdGeographyLevel",
        "length": 256
       },
       {
        "name": "StdGeographyName",
        "type": "esriFieldTypeString",
        "alias": "StdGeographyName",
        "length": 256
       },
       {
        "name": "StdGeographyID",
        "type": "esriFieldTypeString",
        "alias": "StdGeographyID",
        "length": 256
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "StdGeographyLevel": "US.Counties",
         "StdGeographyName": "San Bernardino County",
         "StdGeographyID": "06071",
         "sourceCountry": "US",
         "aggregationMethod": "Query:US.Counties",
         "HasData": 1,
         "TOTPOP": 2118866,
         "TOTHH": 628314,
         "AVGHHSZ": 3.31,
         "TOTMALES": 1054127,
         "TOTFEMALES": 1064739
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • A list of attributes describing the location's demographic characteristics and geographic context, as defined in the KeyGlobalFacts Data Collection and based on the generated area, is returned in the response.
  • Data Collection data is also returned for the intersecting county feature.

        
      

Request example 11:

Enrich a single location defined by latitude and longitude coordinates with attributes defined in the default Data Collection and return comparison data for two administration levels. This example will return data for three areas in a single call: the default 1-mile buffer ring for the input point, along with the state and county features that the point intersects.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/GeoEnrichment/enrich?studyAreas=[{"geometry":{"x":-122.435,"y":37.785},"comparisonLevels":[{"layer":"Admin2"},{"layer":"Admin3"}]}]&useData={"sourceCountry":"US"}&f=pjson

JSON response example 11
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "StdGeographyLevel": "StdGeographyLevel",
       "StdGeographyName": "StdGeographyName",
       "StdGeographyID": "StdGeographyID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "StdGeographyLevel",
        "type": "esriFieldTypeString",
        "alias": "StdGeographyLevel",
        "length": 256
       },
       {
        "name": "StdGeographyName",
        "type": "esriFieldTypeString",
        "alias": "StdGeographyName",
        "length": 256
       },
       {
        "name": "StdGeographyID",
        "type": "esriFieldTypeString",
        "alias": "StdGeographyID",
        "length": 256
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "US",
         "areaType": "RingBuffer",
         "bufferUnits": "esriMiles",
         "bufferUnitsAlias": "mile",
         "bufferRadii": 1,
         "aggregationMethod": "BlockApportionment:US.BlockGroups",
         "HasData": 1,
         "TOTPOP": 104173,
         "TOTHH": 56477,
         "AVGHHSZ": 1.79,
         "TOTMALES": 51587,
         "TOTFEMALES": 52586
        }
       },
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 2,
         "StdGeographyLevel": "US.States",
         "StdGeographyName": "California",
         "StdGeographyID": "06",
         "sourceCountry": "US",
         "aggregationMethod": "Query:US.States",
         "HasData": 1,
         "TOTPOP": 38986171,
         "TOTHH": 13029292,
         "AVGHHSZ": 2.93,
         "TOTMALES": 19393908,
         "TOTFEMALES": 19592263
        }
       },
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 3,
         "StdGeographyLevel": "US.Counties",
         "StdGeographyName": "San Francisco County",
         "StdGeographyID": "06075",
         "sourceCountry": "US",
         "aggregationMethod": "Query:US.Counties",
         "HasData": 1,
         "TOTPOP": 847576,
         "TOTHH": 364216,
         "AVGHHSZ": 2.26,
         "TOTMALES": 430199,
         "TOTFEMALES": 417377
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • A 1-mile buffer ring service area is generated around the input location.
  • A list of attributes describing the location's demographic characteristics and geographic context, as defined in the KeyGlobalFacts Data Collection and based on the generated area, is returned in the response.
  • Data Collection data is also returned for the intersecting U.S. state and county features.

        
      

Request example 12:

Set a drive time buffer from a defined point and return total households and median household income for the current year (2016) with the associated geometry in the response.

http://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/Enrich?studyAreas=[{"geometry":{"x":-117.2459,"y":32.8307}}]&studyAreasOptions={"areaType":"DriveTimeBuffer","bufferUnits":"esriDriveTimeUnitsMinutes","bufferRadii":[5]}& analysisVariables=["KeyUSFacts.TOTHH_CY","KeyUsFacts.MEDHINC_CY"]&returngeometry=true&f=pjson

JSON response example 12
{
    "results": [{
        "paramName": "GeoEnrichmentResult",
        "dataType": "GeoEnrichmentResult",
        "value": {
            "version": "2.0",
            "FeatureSet": [{
                "displayFieldName": "",
                "fieldAliases": {
                    "ID": "ID",
                    "OBJECTID": "Object ID",
                    "sourceCountry": "sourceCountry",
                    "areaType": "areaType",
                    "bufferUnits": "bufferUnits",
                    "bufferUnitsAlias": "bufferUnitsAlias",
                    "bufferRadii": "bufferRadii",
                    "aggregationMethod": "aggregationMethod",
                    "HasData": "HasData",
                    "TOTHH_CY": "2016 Total Households",
                    "MEDHINC_CY": "2016 Median Household Income"
                },
                "geometryType": "esriGeometryPolygon",
                "spatialReference": {
                    "wkid": 4326,
                    "latestWkid": 4326
                },
                "fields": [{
                    "name": "ID",
                    "type": "esriFieldTypeString",
                    "alias": "ID",
                    "length": 256
                }, {
                    "name": "OBJECTID",
                    "type": "esriFieldTypeOID",
                    "alias": "Object ID"
                }, {
                    "name": "sourceCountry",
                    "type": "esriFieldTypeString",
                    "alias": "sourceCountry",
                    "length": 256
                }, {
                    "name": "areaType",
                    "type": "esriFieldTypeString",
                    "alias": "areaType",
                    "length": 256
                }, {
                    "name": "bufferUnits",
                    "type": "esriFieldTypeString",
                    "alias": "bufferUnits",
                    "length": 256
                }, {
                    "name": "bufferUnitsAlias",
                    "type": "esriFieldTypeString",
                    "alias": "bufferUnitsAlias",
                    "length": 256
                }, {
                    "name": "bufferRadii",
                    "type": "esriFieldTypeDouble",
                    "alias": "bufferRadii"
                }, {
                    "name": "aggregationMethod",
                    "type": "esriFieldTypeString",
                    "alias": "aggregationMethod",
                    "length": 256
                }, {
                    "name": "HasData",
                    "type": "esriFieldTypeInteger",
                    "alias": "HasData"
                }, {
                    "name": "TOTHH_CY",
                    "type": "esriFieldTypeDouble",
                    "alias": "2016 Total Households",
                    "fullName": "KeyUSFacts.TOTHH_CY",
                    "component": "demographics",
                    "decimals": 0,
                    "units": "count"
                }, {
                    "name": "MEDHINC_CY",
                    "type": "esriFieldTypeDouble",
                    "alias": "2016 Median Household Income",
                    "fullName": "KeyUSFacts.MEDHINC_CY",
                    "component": "demographics",
                    "decimals": 0,
                    "units": "currency",
                    "currency": "$"
                }],
                "features": [{
                    "attributes": {
                        "ID": "0",
                        "OBJECTID": 1,
                        "sourceCountry": "US",
                        "areaType": "DriveTimeBuffer",
                        "bufferUnits": "esriDriveTimeUnitsMinutes",
                        "bufferUnitsAlias": "Minutes",
                        "bufferRadii": 5,
                        "aggregationMethod": "BlockApportionment:US.BlockGroups",
                        "HasData": 1,
                        "TOTHH_CY": 2623,
                        "MEDHINC_CY": 149926
                    },
                    "geometry": {
                        "rings": [
                            [
                                [
                                  -117.24810409471134,
                                    32.846578598251185
                                ],
                                [
                                  -117.24787902810513,
                                    32.845453261718916
                                ],
                              
                                ...
                              
                                [
                                  -117.24810409471134,
                                    32.846578598251185
                                ]
                            ]
                        ]
                    }
                }]
            }]
        }
    }],
    "messages": []
}

Notes:

  • The response has been abbreviated in the example where "..." is noted.
  • A 5-minute drivetime buffer area is generated around the input location.

JSON response rendered with ArcGIS for Desktop.

5 minute drive time

Notes:

  • Transparency and fill properties have been adjusted for illustrative purposes.

        
      

Request example 13:

Enrich a study area that intersects several countries - returning multiple features.

http://geoenrich.arcgis.com/arcgis/rest/services/World/GeoEnrichmentServer/Geoenrichment/Enrich?studyareas=[{"geometry":{"x": 20.0391, "y": 42.4397}}]&studyareasoptions={"areaType":"RingBuffer","bufferUnits":"esriKilometers","bufferRadii":[50]}&f=pjson

JSON response example 13
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "AL",
         "areaType": "RingBuffer",
         "bufferUnits": "esriKilometers",
         "bufferUnitsAlias": "kilometers",
         "bufferRadii": 50,
         "aggregationMethod": "CentroidsInPolygon:AL.Districts",
         "HasData": 1,
         "TOTPOP": 257695,
         "TOTHH": 64758,
         "AVGHHSZ": 3.98,
         "TOTMALES": 128076,
         "TOTFEMALES": 129619
        }
       },
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 2,
         "sourceCountry": "ME",
         "areaType": "RingBuffer",
         "bufferUnits": "esriKilometers",
         "bufferUnitsAlias": "kilometers",
         "bufferRadii": 50,
         "aggregationMethod": "CentroidsInPolygon:ME.Municipalities",
         "HasData": 1,
         "TOTPOP": 74231,
         "TOTHH": 19590,
         "AVGHHSZ": 3.79,
         "TOTMALES": 37695,
         "TOTFEMALES": 36536
        }
       },
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 3,
         "sourceCountry": "XK",
         "areaType": "RingBuffer",
         "bufferUnits": "esriKilometers",
         "bufferUnitsAlias": "kilometers",
         "bufferRadii": 50,
         "aggregationMethod": "CentroidsInPolygon:XK.Municipalities",
         "HasData": 1,
         "TOTPOP": 306634,
         "TOTHH": 51081,
         "AVGHHSZ": 6,
         "TOTMALES": 145694,
         "TOTFEMALES": 160940
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • Each country intersected by the study area is listed as a separate feature.
  • A 50 kilometer ring buffer area is generated around the single input location.
  • Multiple features are returned - using the global data / KeyGlobal facts data collection.

        
      

Request example 14:

Enrich a study area that intersects several countries - returning a single feature.

http://geoenrich.arcgis.com/arcgis/rest/services/World/GeoEnrichmentServer/Geoenrichment/Enrich?studyareas=[{"geometry":{"x": 20.0391, "y": 42.4397}, "aggregateMultipleCountries":"true"}]&studyareasoptions={"areaType":"RingBuffer","bufferUnits":"esriKilometers","bufferRadii":[50]}&f=pjson

JSON response example 14
{
 "results": [
  {
   "paramName": "GeoEnrichmentResult",
   "dataType": "GeoEnrichmentResult",
   "value": {
    "version": "2.0",
    "FeatureSet": [
     {
      "displayFieldName": "",
      "fieldAliases": {
       "ID": "ID",
       "OBJECTID": "Object ID",
       "sourceCountry": "sourceCountry",
       "areaType": "areaType",
       "bufferUnits": "bufferUnits",
       "bufferUnitsAlias": "bufferUnitsAlias",
       "bufferRadii": "bufferRadii",
       "aggregationMethod": "aggregationMethod",
       "HasData": "HasData",
       "TOTPOP": "Total Population",
       "TOTHH": "Total Households",
       "AVGHHSZ": "Average Household Size",
       "TOTMALES": "Male Population",
       "TOTFEMALES": "Female Population"
      },
      "spatialReference": {
       "wkid": 4326,
       "latestWkid": 4326
      },
      "fields": [
       {
        "name": "ID",
        "type": "esriFieldTypeString",
        "alias": "ID",
        "length": 256
       },
       {
        "name": "OBJECTID",
        "type": "esriFieldTypeOID",
        "alias": "Object ID"
       },
       {
        "name": "sourceCountry",
        "type": "esriFieldTypeString",
        "alias": "sourceCountry",
        "length": 256
       },
       {
        "name": "areaType",
        "type": "esriFieldTypeString",
        "alias": "areaType",
        "length": 256
       },
       {
        "name": "bufferUnits",
        "type": "esriFieldTypeString",
        "alias": "bufferUnits",
        "length": 256
       },
       {
        "name": "bufferUnitsAlias",
        "type": "esriFieldTypeString",
        "alias": "bufferUnitsAlias",
        "length": 256
       },
       {
        "name": "bufferRadii",
        "type": "esriFieldTypeDouble",
        "alias": "bufferRadii"
       },
       {
        "name": "aggregationMethod",
        "type": "esriFieldTypeString",
        "alias": "aggregationMethod",
        "length": 256
       },
       {
        "name": "HasData",
        "type": "esriFieldTypeInteger",
        "alias": "HasData"
       },
       {
        "name": "TOTPOP",
        "type": "esriFieldTypeDouble",
        "alias": "Total Population",
        "fullName": "KeyGlobalFacts.TOTPOP",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTHH",
        "type": "esriFieldTypeDouble",
        "alias": "Total Households",
        "fullName": "KeyGlobalFacts.TOTHH",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "AVGHHSZ",
        "type": "esriFieldTypeDouble",
        "alias": "Average Household Size",
        "fullName": "KeyGlobalFacts.AVGHHSZ",
        "component": "scripts",
        "decimals": 2,
        "units": "count"
       },
       {
        "name": "TOTMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Male Population",
        "fullName": "KeyGlobalFacts.TOTMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       },
       {
        "name": "TOTFEMALES",
        "type": "esriFieldTypeDouble",
        "alias": "Female Population",
        "fullName": "KeyGlobalFacts.TOTFEMALES",
        "component": "demographics",
        "decimals": 0,
        "units": "count"
       }
      ],
      "features": [
       {
        "attributes": {
         "ID": "0",
         "OBJECTID": 1,
         "sourceCountry": "AL, ME, XK",
         "areaType": "RingBuffer",
         "bufferUnits": "esriKilometers",
         "bufferUnitsAlias": "kilometers",
         "bufferRadii": 50,
         "aggregationMethod": "CentroidsInPolygon:Multiple Layers",
         "HasData": 1,
         "TOTPOP": 638560,
         "TOTHH": 135429,
         "AVGHHSZ": 4.72,
         "TOTMALES": 311465,
         "TOTFEMALES": 327095
        }
       }
      ]
     }
    ]
   }
  }
 ],
 "messages": []
}

Notes:

  • A single feature, spanning multiple countries, is returned by setting the agregateMultipleCountries parameter to true.
  • A 50 kilometer ring buffer area is generated around the single input location.
  • Multiple features are returned - using the global data / KeyGlobal facts data collection.