Tutorial: Get global data

Import modules and log in

1. Import the GIS class from the arcgis.gis module. The GIS class provides helper objects to manage (search, create, retrieve) GIS resources such as content, users, and groups. Additionally, import the Geometry and Point classes from the arcgis.geometry module and the enrich method from the arcgis.geoenrichment module.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   
   from arcgis.gis import GIS
   from arcgis.geometry import Geometry, Point
   from arcgis.features import FeatureCollection, FeatureSet
   from arcgis.geoenrichment import BufferStudyArea, Country, enrich
   
   
   

2. Log in to ArcGIS Online using your credentials. In hosted notebooks, You can use the "home" parameter to use the credentials of the currently logged in account.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   
   from arcgis.gis import GIS
   from arcgis.geometry import Geometry, Point
   from arcgis.features import FeatureCollection, FeatureSet
   from arcgis.geoenrichment import BufferStudyArea, Country, enrich
   
   
   portal = GIS("home")
   print(f"Connected to {portal.properties.name} as {portal.properties.user.username}")
   
   

Create study area point

1. Use the Point class to construct a point geometry by passing in the coordinates and spatial reference representing a location in London, England.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   
   portal = GIS("home")
   print(f"Connected to {portal.properties.name} as {portal.properties.user.username}")
   
   study_area_pt = Point(
       {"x": 0.1278, "y": 51.5074, "spatialReference": {"wkid": 4326}}
   )  # London, England
   
   

Get demographic data

1. Use the enrich function, passing in the study area point and the data collection text string of `KeyGlobalFacts to get the demographic data. To learn more about data collections, goto the data enrichment section of this guide.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   
   study_area_pt = Point(
       {"x": 0.1278, "y": 51.5074, "spatialReference": {"wkid": 4326}}
   )  # London, England
   
   enrichment_results = enrich(
       study_areas=[study_area_pt], data_collections=["KeyGlobalFacts"]
   )
   enrichment_results
   
   enriched_features = FeatureSet.from_dataframe(enrichment_results)
   enriched_features
   
   

Display the results

1. Create a map and set it's basemap to "streets-navigation-vector".

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   
   enrichment_results = enrich(
       study_areas=[study_area_pt], data_collections=["KeyGlobalFacts"]
   )
   enrichment_results
   
   enriched_features = FeatureSet.from_dataframe(enrichment_results)
   enriched_features
   
   map_view = portal.map("London, England")
   map_view.basemap = "streets-navigation-vector"
   map_view
   
   

2. Use the enrichment results to construct a popup object.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   
   popup_data = [
       f"Population: {enriched_features.features[0].attributes['totpop']}",
       f"Males: {enriched_features.features[0].attributes['totmales']}",
       f"Females: {enriched_features.features[0].attributes['totfemales']}",
       f"Average household size: {enriched_features.features[0].attributes['avghhsz']}",
   ]
   popup_info = {
       "title": "<b>Data for a 1 mile search radius</b>",
       "content": "<br>".join(popup_data),
   }
   
   

3. Call the clear_graphics method to remove any previous graphics from the map. Use the draw method and pass in the enriched geomety and popup info to add the results to the map. Set the extent of the map to the result geometry's extent.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   
   popup_data = [
       f"Population: {enriched_features.features[0].attributes['totpop']}",
       f"Males: {enriched_features.features[0].attributes['totmales']}",
       f"Females: {enriched_features.features[0].attributes['totfemales']}",
       f"Average household size: {enriched_features.features[0].attributes['avghhsz']}",
   ]
   popup_info = {
       "title": "<b>Data for a 1 mile search radius</b>",
       "content": "<br>".join(popup_data),
   }
   
   map_view.clear_graphics()
   map_view.draw(enriched_features.features[0].geometry, popup=popup_info)
   map_view.extent = Geometry(enriched_features.features[0].geometry).extent

You should now see a map centered around London, England with a polygon graphic representing a 1 mile radius around the study area point. Click on the graphic to display a popup to view global demographic values.