Create data

Overview

You will learn: how to use the ArcGIS API for Python to populate an empty feature layer in the cloud.

Feature layers created using the Create Layer tool have a schema, but they aren't yet populated with data. The ArcGIS API for Python can be used to publish edits. Once new features have been added, your apps can access the layer to query, draw or edit them.

In this lab you will draw graphic markers by clicking on a map. You'll use the Point class and Feature class to construct data features to add to the layer. The lab will create points near Los Angeles, California. The data will be stored in your own ArcGIS Online account and can be used in other labs.

Before You Begin

The ArcGIS API for Python DevLabs use Jupyter Notebooks to execute Python code. If you are new to Python, please see the ArcGIS API for Python guide to Using the Jupyter notebook environment.

Complete the Create a new dataset DevLab. You will use the output feature layer to complete this DevLab.

Steps

Add features with the ArcGIS API for Python

1. Go to the Esri Jupyter Notebook and click New > Python 3 to create a new notebook.

   In each step below, type (or copy and paste) the commands into a new notebook cell and run the code by clicking run cell or pressing shift + Enter.

2. Add the following code to import the ArcGIS API for Python.

   from arcgis.gis import *
   

3. Log into ArcGIS Online by making a GIS connection to ArcGIS Online using your developer account. Replace username and password with your own credentials.

   dev_gis = GIS("https://www.arcgis.com", "username", "password")
   

4. Search for the Griffith Park Access layer created in the Create a new dataset DevLab.

   feature_layer_srch_results = dev_gis.content.search(query='title: "Griffith*" AND type: "Feature Service"')
   feature_layer_srch_results
   

5. Retrieve the feature layer collection item from the list of results.

   feature_layer_coll_item = feature_layer_srch_results[0]
   

6. Retrieve the list of layers from the feature layer collection, and assign the feature layer to a variable.

   feature_layers = feature_layer_coll_item.layers
   feature_layer = feature_layers[0]
   

7. Retrieve a list of all the field names for the feature layer so you can populate the values in the step below.

   for field in feature_layer.properties['fields']:
       print(field['name'])
   

8. Write a function to serve as the event handler for the map widget's on_click event.

   from arcgis import geometry
   from arcgis import features
   
   def create_feature(map1, g):
      try:
          oid = 1
          pt = geometry.Point(g)
          feat = features.Feature(geometry=pt, attributes={'OBJECTID': oid,
                                                           'name': 'name',
                                                           'type': 'park',
                                                           'surface': 'dirt'})
          flayer.edit_features([feat])
          map1.draw(pt)
      except:
          print("Couldn't draw the point. Try again...")
   

9. Load a map of Los Angeles in your notebook.

   map1 = gis.map('Los Angeles', 10)
   map1
   

10. Assign the function you defined in step 7 to the callback parameter of the map widget's on_click() method. Run the cell and begin clicking locations on the map.

    map1.on_click(create_feature)
    

11. Clear the map graphics.

    map1.clear_graphics()
    

12. Add the layer to the map to visualize features.

    map1.add_layer(feature_layer)
    

Congratulations, you're done!

Your map and layer (feature service) should look something like this.

Next labs

Add a layer from an item

Load a layer from an ArcGIS Online item and add it to a map.

10 minutes Start Lab

Display a web map

Build an app that loads and displays a web map.

10 minutes Start Lab

Display a web scene

Display a web scene using the map widget in the ArcGIS API for Python.

10 minutes Start Lab

Share maps and layers

Automate sharing your layers or keeping them private.

10 minutes Start Lab

Challenge

Explore the Item Details Page.

Find the URL

Set permissions

Set the styles

Explore the Table View