Tutorial: Add a point, line, and polygon

Import modules and log in

1. Import the arcgis.gis and arcgis.geometry modules. The GIS class provides the information model for a GIS hosted in ArcGIS Online or Portal for ArcGIS. The geometry module provides functions for managing and working with different geometric types.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   from arcgis.gis import GIS
   from arcgis.geometry import Point, Polyline, Polygon
   
   
   

2. Log in anonymously to access publicly shared content. The data used in this tutorial is public so you do not need credentials to access it. If it were private data, you would be required to provide authentication.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   from arcgis.gis import GIS
   from arcgis.geometry import Point, Polyline, Polygon
   
   
   portal = GIS()  # anonymously
   
   

Create the graphics

1. Use the Point class to create a new graphic. Use a dict object to create the symbol and attributes.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   portal = GIS()  # anonymously
   
   point = Point({"x": -118.8066, "y": 34.0006, "z": 100})
   
   point_attributes = {"name": "Point", "description": "I am a point"}
   
   simple_marker_symbol = {
       "type": "esriSMS",
       "style": "esriSMSCircle",
       "color": [0, 0, 0],
       "outline": {"color": [255, 255, 255], "width": 1},
   }
   
   

2. Use the Polyline class to create a new graphic object. Use a dict objects to create the symbol and attributes objects.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   point = Point({"x": -118.8066, "y": 34.0006, "z": 100})
   
   point_attributes = {"name": "Point", "description": "I am a point"}
   
   simple_marker_symbol = {
       "type": "esriSMS",
       "style": "esriSMSCircle",
       "color": [0, 0, 0],
       "outline": {"color": [255, 255, 255], "width": 1},
   }
   
   polyline = Polyline(
       {
           "paths": [
               [-118.821527826096, 34.0139576938577],
               [-118.814893761649, 34.0080602407843],
               [-118.808878330345, 34.0016642996246],
           ]
       }
   )
   
   polyline_attributes = {"name": "Polyline", "description": "I am a Polyline"}
   
   simple_line_symbol = {
       "type": "esriSLS",
       "style": "esriSLSolid",
       "color": [255, 155, 128],
       "width": 2,
   }
   
   

3. Use the Polygon class to create a new graphic object. Use a dict objects to create the symbol and attributes objects.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   polyline = Polyline(
       {
           "paths": [
               [-118.821527826096, 34.0139576938577],
               [-118.814893761649, 34.0080602407843],
               [-118.808878330345, 34.0016642996246],
           ]
       }
   )
   
   polyline_attributes = {"name": "Polyline", "description": "I am a Polyline"}
   
   simple_line_symbol = {
       "type": "esriSLS",
       "style": "esriSLSolid",
       "color": [255, 155, 128],
       "width": 2,
   }
   
   polygon = Polygon(
       {
           "rings": [
               [
                   [-118.818984489994, 34.0137559967283],
                   [-118.806796597377, 34.0215816298725],
                   [-118.791432890735, 34.0163883241613],
                   [-118.79596686535, 34.008564864635],
                   [-118.808558110679, 34.0035027131376],
               ]
           ]
       }
   )
   
   polygon_attributes = {"name": "Polygon", "description": "I am a Polygon"}
   
   simple_fill_symbol = {
       "type": "esriSFS",
       "color": [50, 100, 200, 125],
       "outline": {"color": [255, 255, 255], "width": 1},
   }
   
   

Display the results

1. Use the map method to create a new map widget.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   polygon = Polygon(
       {
           "rings": [
               [
                   [-118.818984489994, 34.0137559967283],
                   [-118.806796597377, 34.0215816298725],
                   [-118.791432890735, 34.0163883241613],
                   [-118.79596686535, 34.008564864635],
                   [-118.808558110679, 34.0035027131376],
               ]
           ]
       }
   )
   
   polygon_attributes = {"name": "Polygon", "description": "I am a Polygon"}
   
   simple_fill_symbol = {
       "type": "esriSFS",
       "color": [50, 100, 200, 125],
       "outline": {"color": [255, 255, 255], "width": 1},
   }
   
   map = portal.map()
   map
   
   

2. Use the draw method to add each of the graphics, with their associated symbology and attributes, to the map. Use the popup parameter to build a popup object from attribute values.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   map = portal.map()
   map
   
   map.draw(
       shape=point,
       symbol=simple_marker_symbol,
       attributes=point_attributes,
       popup={
           "title": point_attributes["name"],
           "content": point_attributes["description"],
       },
   )
   
   map.draw(
       shape=polyline,
       symbol=simple_line_symbol,
       attributes=polyline_attributes,
       popup={
           "title": polyline_attributes["name"],
           "content": polyline_attributes["description"],
       },
   )
   
   map.draw(
       shape=polygon,
       symbol=simple_fill_symbol,
       attributes=polygon_attributes,
       popup={
           "title": polygon_attributes["name"],
           "content": polygon_attributes["description"],
       },
   )
   
   

3. Set the map center by passing in coordinates and provide a scale level. This will update the map extent so that the newly added graphics are displayed prominently in the view.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   map.draw(
       shape=point,
       symbol=simple_marker_symbol,
       attributes=point_attributes,
       popup={
           "title": point_attributes["name"],
           "content": point_attributes["description"],
       },
   )
   
   map.draw(
       shape=polyline,
       symbol=simple_line_symbol,
       attributes=polyline_attributes,
       popup={
           "title": polyline_attributes["name"],
           "content": polyline_attributes["description"],
       },
   )
   
   map.draw(
       shape=polygon,
       symbol=simple_fill_symbol,
       attributes=polygon_attributes,
       popup={
           "title": polygon_attributes["name"],
           "content": polygon_attributes["description"],
       },
   )
   
   map.center = [34.0110, -118.8047]
   map.zoom = 14
   
   

4. Optional: Use the export_to_html method to export the current state of the map widget to a static HTML file which can be viewed in any web browser.

   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
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89
   90
   91
   92
   93
   94
   95
   96
   97
   98
   99
   100
   101
   102
   103
   104
   
   map.center = [34.0110, -118.8047]
   map.zoom = 14
   
   import os
   
   file_dir = os.path.join(os.getcwd(), "home")
   if not os.path.isdir(file_dir):
       os.mkdir(file_dir)
   
   file_path = os.path.join(file_dir, "add-a-point-line-and-polygon.html")
   
   map.export_to_html(file_path, title="Add a point, line, and polygon")

Your map should display three graphics in the Santa Monica Mountains. Click on a graphic to display its popup.