GeoEnrichment

GeoEnrichment#

1. What is GeoEnrichment#

GeoEnrichment, also known as Data Enrichment, is the process of finding demographic data and local facts for locations around the world. It allows you to gain “location-based” insight about the people and places in an area. The additional information can drive better understanding, analysis, and decision-making.

data-enrichment-gif

Use Cases

  • Create tools or apps to support interactive exploration of any area of interest.

  • Automate and simplify the process social, economic, and demographic data retrieval.

  • Access more data beyond Census, including Jobs, Behaviors, Spending, Crime, and Health data.

1.1. How to use GeoEnrichment#

To perform GeoEnrichment, we need to utilize Esri’s GeoEnrichment service. The service provides over 15,000 data variables (data fields) with coverage for more than 150 countries and regions.

An access token is required to use the service for developers who have an ArcGIS Location Platform account or ArcGIS Online account.

The service can be used with many Esri APIs (Application Programming Interfaces), such as ArcGIS Maps SDK and ArcGIS REST JS. Among them, only ArcGIS Python API offers Full Support. It is also how we will access this service in this class.

1.2 What data are available#

There are two main types of data: Global Data and Local Data.

The global (demographic) data, also known as standard demographics, covers 170 countries and regions. The data include population, income, age, households, education, spending, jobs, marital status, and key facts. The map below shows coverage of global data.

To see the standard demographics available for each country or region you can review the regional data tables for Africa, Asia, Europe, North America, Oceania, and South America. Within the link for each of the continent, you can also view an individual country or region page to find the current list of variables in the related links section for that country.

The local data, also known as advanced demographics, to get detailed information for specific countries, counties, cities, and locations. Each individual data field is represented by an analysis variable, and analysis variables are organized into data categories. The map below shows coverage of local data.

Tools to discover data variables

You can explore interactively with the following tools to find data that you are looking for.

For more details on how to find data variables using ArcGIS API for Python, check out this tutorial.

2. User Authentication#

You will need Developer Credentials to access the GeoEnrichment service. Read more about Security in ArcGIS, including what is authentication, how it works, and types of authentication. We will use user authentication, i.e., OAuth 2.0, in this class.

OAuth2.0

The steps to create OAuth credentials with an ArcGIS Online account are:

  1. Sign in to your ArcGIS Online account.

  2. Click Content > My content > New item and select Developer credentials.

  3. Select OAuth 2.0 credentials and click Next.

  4. Add a Redirect URLs (https://localhost:8080) and click Next.

  5. Name the credentials and click Next to review. When you are ready to create the credentials, click Create.

  6. Go to Settings on the top right of the item. Under Application, click Register application.

  7. Add the Redirect URLs (https://localhost:8080) one more time and click Register. Now, you have a developer credential created.

After creating the developer credential, you can view the item, an example showing below. Note there are two important items you need from the item to get access to the service you have chosen, Client ID and Client Secret.

developer-credential

Contents