├── .gitignore
├── README.md
├── REST
    ├── AddFeaturesOnTimer.py
    └── README.md
├── build_org
    ├── README.md
    ├── clone_groups.ipynb
    ├── configure_org.ipynb
    ├── create_share_group.ipynb
    └── register_application.ipynb
├── common_workflows
    ├── README.md
    ├── csv_geocode.ipynb
    ├── distribute_items.ipynb
    ├── standard_geography.ipynb
    ├── update_webmaps.ipynb
    └── vector_data_products.ipynb
├── feature_layers
    ├── README.md
    ├── create_views.ipynb
    ├── csv_upload.ipynb
    ├── enable_time.ipynb
    ├── geojson_upload.ipynb
    ├── manage_fields.ipynb
    ├── manage_indexes.ipynb
    ├── shapefile_upload.ipynb
    └── update_data.ipynb
├── partnerutils
    ├── README.md
    ├── __init__.py
    ├── clone_utils.py
    ├── cool_utils.py
    ├── etl_utils.py
    ├── feature_utils.py
    ├── processing_utils.py
    └── user_utils.py
├── sample_data
    ├── NYC_Restaurant_Inspections.csv
    ├── NYC_Restaurant_Inspections.geojson
    └── sample_census_tract_geoid.csv
└── setup.py


/.gitignore:
--------------------------------------------------------------------------------
  1 | # local
  2 | client_server
  3 | *DS_STORE
  4 | *test.csv
  5 | test/
  6 | test_data/
  7 | stage/
  8 | .vscode/
  9 | !.vscode/settings.json
 10 | !.vscode/tasks.json
 11 | !.vscode/launch.json
 12 | !.vscode/extensions.json
 13 | 
 14 | # Byte-compiled / optimized / DLL files
 15 | __pycache__/
 16 | *.py[cod]
 17 | *$py.class
 18 | 
 19 | # C extensions
 20 | *.so
 21 | 
 22 | # Distribution / packaging
 23 | .Python
 24 | env/
 25 | build/
 26 | develop-eggs/
 27 | dist/
 28 | downloads/
 29 | eggs/
 30 | .eggs/
 31 | lib/
 32 | lib64/
 33 | parts/
 34 | sdist/
 35 | var/
 36 | wheels/
 37 | *.egg-info/
 38 | .installed.cfg
 39 | *.egg
 40 | 
 41 | # PyInstaller
 42 | #  Usually these files are written by a python script from a template
 43 | #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 44 | *.manifest
 45 | *.spec
 46 | 
 47 | # Installer logs
 48 | pip-log.txt
 49 | pip-delete-this-directory.txt
 50 | 
 51 | # Unit test / coverage reports
 52 | htmlcov/
 53 | .tox/
 54 | .coverage
 55 | .coverage.*
 56 | .cache
 57 | nosetests.xml
 58 | coverage.xml
 59 | *.cover
 60 | .hypothesis/
 61 | 
 62 | # Translations
 63 | *.mo
 64 | *.pot
 65 | 
 66 | # Django stuff:
 67 | *.log
 68 | local_settings.py
 69 | 
 70 | # Flask stuff:
 71 | instance/
 72 | .webassets-cache
 73 | 
 74 | # Scrapy stuff:
 75 | .scrapy
 76 | 
 77 | # Sphinx documentation
 78 | docs/_build/
 79 | 
 80 | # PyBuilder
 81 | target/
 82 | 
 83 | # Jupyter Notebook
 84 | .ipynb_checkpoints
 85 | 
 86 | # pyenv
 87 | .python-version
 88 | 
 89 | # celery beat schedule file
 90 | celerybeat-schedule
 91 | 
 92 | # SageMath parsed files
 93 | *.sage.py
 94 | 
 95 | # dotenv
 96 | .env
 97 | 
 98 | # virtualenv
 99 | .venv
100 | venv/
101 | ENV/
102 | 
103 | # Spyder project settings
104 | .spyderproject
105 | .spyproject
106 | 
107 | # Rope project settings
108 | .ropeproject
109 | 
110 | # mkdocs documentation
111 | /site
112 | 
113 | # mypy
114 | .mypy_cache/
115 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Esri Partner Tools
 2 | 
 3 | > Useful tools for Esri Partners built with the [ArcGIS API for Python](https://developers.arcgis.com/python/)
 4 | 
 5 | <details>
 6 |   <summary> Contents
 7 |   </summary>
 8 | 
 9 | * [About](#about)
10 | * [Prerequisites](#prerequisites)
11 | * [Contents](#contents)
12 | * [Getting Started](#getting-started)
13 | * [Sample Data](#sample-data)
14 | * [Issues and Contributing](#issues-and-contributing)
15 | 
16 | </details>
17 | 
18 | ## About
19 | 
20 | Partners working with Esri and ArcGIS implement many common workflows. The [ArcGIS API for Python](https://developers.arcgis.com/python/) is an awesome automation library. This repo is meant to be a collection of POC scripts to automate some of these workflows.
21 | 
22 | While much of the code is in Jupyter Notebooks, it can easily be ported to pure python to run on the server or as headless apps. [`partnerutils/`](/partnerutils) can also be installed as a local package:
23 | > `$ pip install -q -U git+https://github.com/mpayson/esri-partner-tools`
24 | 
25 | ## Prerequisites
26 | 
27 | * Install the [ArcGIS API for Python](https://developers.arcgis.com/python/) ([instructions](https://developers.arcgis.com/python/guide/install-and-set-up/))
28 | * Access to [Jupyter Notebooks](http://jupyter.org/)
29 | 
30 | ## Contents
31 | 
32 | * **[`partnerutils/`](/partnerutils) - Functions that I've found helpful**
33 |   * [`cool_utils.py`](/partnerutils/cool_utils.py) - functions I want to remember and hopefully you will too!
34 |   * [`etl_utils.py`](/partnerutils/etl_utils.py) - assist with common ETL logic
35 |   * [`user_utils.py`](/partnerutils/user_utils.py) - assist with adding users
36 |   * [`clone_utils.py`](/partnerutils/clone_utils.py) - assist with cloning groups & items
37 |   * [`feature_utils.py`](partnerutils/feature_utils.py) - assist with features and feature data types
38 | * **[`common_workflows/`](/common_workflows) - Common workflows with the Python API**
39 |   * [`csv_geocode.ipynb`](/common_workflows/csv_geocode.ipynb) - [geocode](https://developers.arcgis.com/features/geocoding/) rows in `csvs` and `dataframes`
40 |   * [`vector_data_products.ipynb`](/common_workflows/vector_data_products.ipynb) - end-to-end workflows for managing vector content and derivative information products
41 |   * [`distribute_items.ipynb`](/common_workflows/distribute_items.ipynb) - common patterns for distributing items to another organization
42 |   * [`standard_geography.ipynb`](/common_workflows/standard_geography.ipynb) - enrich [standard geography](https://developers.arcgis.com/rest/geoenrichment/api-reference/standard-geography-query.htm) ids, such as `census blocks`, with geometries
43 | * **[`feature_layers/`](/feature_layers) - Common operations with [hosted feature layers](https://doc.arcgis.com/en/arcgis-online/share-maps/hosted-web-layers.htm)**
44 |   * [`csv_upload.ipynb`](/feature_layers/csv_upload.ipynb) - upload a folder of `csvs` & `dataframes`
45 |   * [`shapefile_upload.ipynb`](/feature_layers/shapefile_upload.ipynb) - upload a folder of `Shapefiles`
46 |   * [`geojson_upload.ipynb`](/feature_layers/geojson_upload.ipynb) - upload a geojson file
47 |   * [`update_data.ipynb`](/feature_layers/update_data.ipynb) - a couple different workflows for updating uploaded / hosted data
48 |   * [`create_views.ipynb`](/feature_layers/create_views.ipynb) - create database views with separate permissions against one authoritative layer
49 |   * [`manage_fields.ipynb`](/feature_layers/manage_fields.ipynb) - view and edit fields
50 |   * [`manage_indexes.ipynb`](/feature_layers/manage_indexes.ipynb) - view, edit, and refresh indexes
51 |   * [`enable_time.ipynb`](/feature_layers/enable_time.ipynb) - add time metadata that will be reflected in ArcGIS app UIs
52 | * **[`build_org/`](/build_org) - Automate new ArcGIS Online deployments**
53 |   * [`clone_groups.ipynb`](/build_org/clone_groups.ipynb) - clone groups and their items
54 |   * [`configure_org.ipynb`](/build_org/configure_org.ipynb) - customize org UI, create groups, & add users
55 |   * [`create_share_group.ipynb`](/build_org/create_share_group.ipynb) - create a [group](https://doc.arcgis.com/en/arcgis-online/share-maps/groups.htm) and invite members to share content with your users
56 |   * [`register_application.ipynb`](/build_org/register_application.ipynb) automatically create and [register an app](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/)
57 | 
58 | ## Getting Started
59 | 
60 | Many samples use [`partnerutils`](/partnerutils). To use this package, either copy & paste the functions as specified in each notebook OR:
61 | 
62 | `$ pip install -q -U git+https://github.com/mpayson/esri-partner-tools`
63 | 
64 | This will install the `partnerutils` as a local package in your active environment. The utilities can then be used as follows
65 | 
66 | ```python
67 | from arcgis.gis import GIS
68 | from partnerutils.processing_utils import batch_geocode_memo
69 | 
70 | gis = GIS(username="username", password="password")
71 | addresses = ['El Burrito Redlands CA', '380 New York St Redlands CA']
72 | results = batch_geocode_memo(addresses)
73 | 
74 | print(results)
75 | ```
76 | 
77 | Shout out to Ryan @ SafeGraph for showing me this is [a thing](https://github.com/SafeGraphInc/safegraph_py). Otherwise, the notebooks should give enough detail to get started. If not, **[holler](https://github.com/mpayson/esri-partner-tools/issues)**!
78 | 
79 | ## Sample Data
80 | 
81 | I included some sample data for testing and trialing:
82 | * [`NYC_Restaurant_Inspections.csv`](/sample_data/NYC_Restaurant_Inspections.csv) - a slice of DOHMH New York City Restaurant Inspection Results. [Source](https://data.cityofnewyork.us/Health/DOHMH-New-York-City-Restaurant-Inspection-Results/43nn-pn8j])
83 | * [`sample_census_tract_geoid.csv`](/sample_data/sample_census_tract_geoid.csv) - a couple census tract geoids. Copied from [here](https://geo.nyu.edu/catalog/nyu-2451-34513)
84 | 
85 | ## Issues and Contributing
86 | 
87 | Want to request a new sample? Have a question? Would [__love__](https://github.com/mpayson/esri-partner-tools/issues) to hear from you.
88 | 
89 | And PRs always welcome!
90 | 


--------------------------------------------------------------------------------
/REST/AddFeaturesOnTimer.py:
--------------------------------------------------------------------------------
 1 | import threading
 2 | import sys
 3 | import requests
 4 | import json
 5 | from datetime import datetime
 6 | 
 7 | 
 8 | # Disable warnings
 9 | requests.packages.urllib3.disable_warnings()
10 | 
11 | # Get Parameters
12 | addfsURL = str(sys.argv[1])
13 | interval = int(sys.argv[2])
14 | deviceID = int(sys.argv[3])
15 | quantity = int(sys.argv[4])
16 | username = str(sys.argv[5])
17 | password = str(sys.argv[6])
18 | 
19 | # Generate Token
20 | tokenURL = 'https://www.arcgis.com/sharing/rest/generateToken'
21 | params = {'f': 'pjson', 'username': username, 'password': password, 'referer': 'http://www.arcgis.com'}
22 | r = requests.post(tokenURL, data = params, verify=False)
23 | response = json.loads(r.content)
24 | token = response['token']
25 | 
26 | # define timer
27 | def fireTimer():
28 |   threading.Timer(interval, fireTimer).start()
29 | 
30 |   #get timestamp
31 |   noww = datetime.now()
32 |   dateTimeNow = str(noww)
33 | 
34 |   attr = [{"attributes":{"pk":deviceID, "amount":quantity, "datetime1":dateTimeNow}}]
35 |   params = {"features": json.dumps(attr), 'token': token, 'f': 'json'}
36 |   r = requests.post(addfsURL, data = params, verify=False)
37 | 
38 |   print(r.json)
39 | 
40 | fireTimer()
41 | 


--------------------------------------------------------------------------------
/REST/README.md:
--------------------------------------------------------------------------------
 1 | # ArcGISAddFeatures
 2 | Headless ArcGIS python script to push attribute data into an ArcGIS Online hosted data table. The script runs on a timer at a user defined interval. 
 3 | 
 4 | Prerequisites:
 5 | ArcGIS Online account
 6 | Hosted data table with fields 'pk', 'amount', 'datetime1'
 7 | 
 8 | Usage:
 9 | * AddFeaturesOnTimer.py 'URL of the hosted table' 'interval (sec)' 'ID' 'Value' 'My User Name' 'My Password'
10 | 


--------------------------------------------------------------------------------
/build_org/README.md:
--------------------------------------------------------------------------------
1 | # Build Org
2 | 
3 | > Automate new ArcGIS Online deployments
4 | 
5 | * [`clone_groups.ipynb`](/build_org/clone_groups.ipynb) - clone groups and their items
6 | * [`configure_org.ipynb`](/build_org/configure_org.ipynb) - customize org UI, create groups, & add users
7 | * [`create_share_group.ipynb`](/build_org/create_share_group.ipynb) - create a [group](https://doc.arcgis.com/en/arcgis-online/share-maps/groups.htm) and invite members to share content with your users
8 | * [`register_application.ipynb`](/build_org/register_application.ipynb) automatically create and [register an app](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/)


--------------------------------------------------------------------------------
/build_org/clone_groups.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Clone Groups\n",
  8 |     "*Jupyter Notebook to clone groups and their items. Configurable notebook over this awesome [`clone_items`](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html#arcgis.gis.ContentManager.clone_items) function*"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": null,
 14 |    "metadata": {
 15 |     "collapsed": true,
 16 |     "jupyter": {
 17 |      "outputs_hidden": true
 18 |     }
 19 |    },
 20 |    "outputs": [],
 21 |    "source": [
 22 |     "# common imports\n",
 23 |     "from arcgis.gis import GIS"
 24 |    ]
 25 |   },
 26 |   {
 27 |    "cell_type": "markdown",
 28 |    "metadata": {},
 29 |    "source": [
 30 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`clone_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/clone_utils.py)"
 31 |    ]
 32 |   },
 33 |   {
 34 |    "cell_type": "code",
 35 |    "execution_count": null,
 36 |    "metadata": {
 37 |     "collapsed": true,
 38 |     "jupyter": {
 39 |      "outputs_hidden": true
 40 |     }
 41 |    },
 42 |    "outputs": [],
 43 |    "source": [
 44 |     "from partnerutils.clone_utils import search_group_title, search_item_title, clone_items_modify"
 45 |    ]
 46 |   },
 47 |   {
 48 |    "cell_type": "markdown",
 49 |    "metadata": {},
 50 |    "source": [
 51 |     "## User Input"
 52 |    ]
 53 |   },
 54 |   {
 55 |    "cell_type": "markdown",
 56 |    "metadata": {},
 57 |    "source": [
 58 |     "### GIS Configuration\n",
 59 |     "Parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/).\n",
 60 |     "* **source** - the ArcGIS Online organization that contains the default groups & items\n",
 61 |     "* **target** - the new organization"
 62 |    ]
 63 |   },
 64 |   {
 65 |    "cell_type": "code",
 66 |    "execution_count": null,
 67 |    "metadata": {
 68 |     "collapsed": true,
 69 |     "jupyter": {
 70 |      "outputs_hidden": true
 71 |     }
 72 |    },
 73 |    "outputs": [],
 74 |    "source": [
 75 |     "# log in to respective portals\n",
 76 |     "source = GIS(\"<template GIS>\", \"<un>\", \"<pw>\")\n",
 77 |     "target = GIS(\"<project GIS>\", \"<un>\", \"<pw>\")"
 78 |    ]
 79 |   },
 80 |   {
 81 |    "cell_type": "markdown",
 82 |    "metadata": {},
 83 |    "source": [
 84 |     "### Clone Configuration\n",
 85 |     "Defines the groups that will be cloned and the naming structures of cloned items & groups"
 86 |    ]
 87 |   },
 88 |   {
 89 |    "cell_type": "code",
 90 |    "execution_count": null,
 91 |    "metadata": {
 92 |     "collapsed": true,
 93 |     "jupyter": {
 94 |      "outputs_hidden": true
 95 |     }
 96 |    },
 97 |    "outputs": [],
 98 |    "source": [
 99 |     "# groups to be copied from source to target organization\n",
100 |     "GROUPS = [\"<GROUP1>\", \"<GROUP2>\"]\n",
101 |     "\n",
102 |     "# (optional) new item name structure, {} replaced by source item name\n",
103 |     "NAME_TEMPLATE = \"<APP NAME> {}\"\n",
104 |     "# (optional) user folder for new items\n",
105 |     "FOLDER = \"<APP NAME> Content\" "
106 |    ]
107 |   },
108 |   {
109 |    "cell_type": "markdown",
110 |    "metadata": {},
111 |    "source": [
112 |     "## Execution"
113 |    ]
114 |   },
115 |   {
116 |    "cell_type": "markdown",
117 |    "metadata": {},
118 |    "source": [
119 |     "### Modify Functions\n",
120 |     "Sometimes you don't want a 1:1 copy, these functions will modify the cloned item properties. A few notes:\n",
121 |     "* `modify_item_callback` receives the cloned item and its gis. It should return a flattened dict of properties [here](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html?highlight=clone_items#arcgis.gis.Item.update)\n",
122 |     "* `modify_group_callback` receives the cloned group, its expected title, and its gis. It should return a dict of properties [here](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html?highlight=clone_items#arcgis.gis.Group.update)\n",
123 |     "* The default behavior is to update the item to match the NAME_TEMPLATE, if it's not defined these will not be called"
124 |    ]
125 |   },
126 |   {
127 |    "cell_type": "code",
128 |    "execution_count": null,
129 |    "metadata": {
130 |     "collapsed": true,
131 |     "jupyter": {
132 |      "outputs_hidden": true
133 |     }
134 |    },
135 |    "outputs": [],
136 |    "source": [
137 |     "# update title functions\n",
138 |     "def modify_item_callback(item, target_gis):\n",
139 |     "    title = NAME_TEMPLATE.format(item.title)\n",
140 |     "    while search_item_title(target_gis, title):\n",
141 |     "        title = input(\"Title `{0}` for ITEM `{1}` already exists \\n new title: \"\n",
142 |     "                         .format(title, item.title))\n",
143 |     "    return {\"title\": title}\n",
144 |     "def modify_group_callback(group, expected_title, target_gis):\n",
145 |     "    title = NAME_TEMPLATE.format(expected_title)\n",
146 |     "    while search_group_title(target_gis, title):\n",
147 |     "        title = input(\"Title `{0}` for GROUP `{1}` already exists \\n new title: \"\n",
148 |     "                         .format(title, expected_title))\n",
149 |     "    return {\"title\": title}\n",
150 |     "\n",
151 |     "# these functions provide little utility if NAME_TEMPLATE is None\n",
152 |     "# so don't use if this is the case\n",
153 |     "modify_item = modify_item_callback if NAME_TEMPLATE else None\n",
154 |     "modify_group = modify_group_callback if NAME_TEMPLATE else None"
155 |    ]
156 |   },
157 |   {
158 |    "cell_type": "markdown",
159 |    "metadata": {},
160 |    "source": [
161 |     "### Clone"
162 |    ]
163 |   },
164 |   {
165 |    "cell_type": "code",
166 |    "execution_count": null,
167 |    "metadata": {
168 |     "collapsed": true,
169 |     "jupyter": {
170 |      "outputs_hidden": true
171 |     }
172 |    },
173 |    "outputs": [],
174 |    "source": [
175 |     "# get groups\n",
176 |     "source_groups = [search_group_title(source, title) for title in GROUPS]\n",
177 |     "\n",
178 |     "# copy the groups\n",
179 |     "results = clone_items_modify(source_groups, target,\n",
180 |     "                                     modify_item_callback=modify_item,\n",
181 |     "                                     modify_group_callback=modify_group,\n",
182 |     "                                     copy_data=False, search_existing_items=False, folder=FOLDER)"
183 |    ]
184 |   }
185 |  ],
186 |  "metadata": {
187 |   "kernelspec": {
188 |    "display_name": "Python 3",
189 |    "language": "python",
190 |    "name": "python3"
191 |   },
192 |   "language_info": {
193 |    "codemirror_mode": {
194 |     "name": "ipython",
195 |     "version": 3
196 |    },
197 |    "file_extension": ".py",
198 |    "mimetype": "text/x-python",
199 |    "name": "python",
200 |    "nbconvert_exporter": "python",
201 |    "pygments_lexer": "ipython3",
202 |    "version": "3.7.4"
203 |   }
204 |  },
205 |  "nbformat": 4,
206 |  "nbformat_minor": 4
207 | }
208 | 


--------------------------------------------------------------------------------
/build_org/configure_org.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Configure Org\n",
  8 |     "*Jupyter Notebook to customize an ArcGIS Online organization UI & add users*"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": null,
 14 |    "metadata": {
 15 |     "collapsed": true
 16 |    },
 17 |    "outputs": [],
 18 |    "source": [
 19 |     "# common imports\n",
 20 |     "from arcgis.gis import GIS"
 21 |    ]
 22 |   },
 23 |   {
 24 |    "cell_type": "markdown",
 25 |    "metadata": {},
 26 |    "source": [
 27 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`user_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/user_utils.py) and [`clone_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/clone_utils.py)"
 28 |    ]
 29 |   },
 30 |   {
 31 |    "cell_type": "code",
 32 |    "execution_count": 1,
 33 |    "metadata": {
 34 |     "collapsed": true
 35 |    },
 36 |    "outputs": [],
 37 |    "source": [
 38 |     "from partnerutils.user_utils import add_users_csv\n",
 39 |     "from partnerutils.clone_utils import search_group_title"
 40 |    ]
 41 |   },
 42 |   {
 43 |    "cell_type": "markdown",
 44 |    "metadata": {},
 45 |    "source": [
 46 |     "## User Input"
 47 |    ]
 48 |   },
 49 |   {
 50 |    "cell_type": "markdown",
 51 |    "metadata": {},
 52 |    "source": [
 53 |     "### GIS Configuration\n",
 54 |     "Organization to be built. Parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/)."
 55 |    ]
 56 |   },
 57 |   {
 58 |    "cell_type": "code",
 59 |    "execution_count": null,
 60 |    "metadata": {
 61 |     "collapsed": true
 62 |    },
 63 |    "outputs": [],
 64 |    "source": [
 65 |     "# org to be customized\n",
 66 |     "gis = GIS(\"<template GIS>\", \"<un>\", \"<pw>\")"
 67 |    ]
 68 |   },
 69 |   {
 70 |    "cell_type": "markdown",
 71 |    "metadata": {},
 72 |    "source": [
 73 |     "### UI Configuration\n",
 74 |     "Constants to define organization users and UI building blocks. This script will also search for groups and create them if they don't exist, as defined by the [schema](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html#arcgis.gis.GroupManager.create)."
 75 |    ]
 76 |   },
 77 |   {
 78 |    "cell_type": "code",
 79 |    "execution_count": null,
 80 |    "metadata": {
 81 |     "collapsed": true
 82 |    },
 83 |    "outputs": [],
 84 |    "source": [
 85 |     "# path to csv with users to be added\n",
 86 |     "USER_CSV = \"<CSV PATH>\"\n",
 87 |     "\n",
 88 |     "# (optional) groups to share with users\n",
 89 |     "GROUPS = [\"<GROUP 1>\", \"<GROUP 2>\"]\n",
 90 |     "\n",
 91 |     "# (optional) group schema to create new groups if GROUPS don't exist\n",
 92 |     "GROUPSCHEMA = {\n",
 93 |     "    \"tags\": \"test, group, poc, scripts\",\n",
 94 |     "    \"description\": \"Test group for partner python scripts\",\n",
 95 |     "    \"access\": 'private',\n",
 96 |     "    \"is_invitation_only\": True,\n",
 97 |     "    \"users_update_items\": False\n",
 98 |     "}\n",
 99 |     "\n",
100 |     "# (optional) organization UX component locations\n",
101 |     "THUMBNAIL_PATH = \"<THUMBNAIL PATH>\"\n",
102 |     "FOOTER_PATH = \"<FOOTER PATH>\"\n",
103 |     "BANNER_PATH = \"<BANNER PATH>\"\n",
104 |     "BACKGROUND_PATH = \"<BACKGROUND PATH>\"\n",
105 |     "\n",
106 |     "# (optional) featured content group\n",
107 |     "FEATURED_GROUP = \"<GROUP>\""
108 |    ]
109 |   },
110 |   {
111 |    "cell_type": "markdown",
112 |    "metadata": {},
113 |    "source": [
114 |     "## Execution"
115 |    ]
116 |   },
117 |   {
118 |    "cell_type": "markdown",
119 |    "metadata": {},
120 |    "source": [
121 |     "### Fetch & Create Groups"
122 |    ]
123 |   },
124 |   {
125 |    "cell_type": "code",
126 |    "execution_count": null,
127 |    "metadata": {
128 |     "collapsed": true
129 |    },
130 |    "outputs": [],
131 |    "source": [
132 |     "share_groups = []\n",
133 |     "for g in groups:\n",
134 |     "    g_r = search_group_title(gis, g)\n",
135 |     "    if g_r is None:\n",
136 |     "        GROUPSCHEMA[\"title\"] = g\n",
137 |     "        g_r = gis.groups.create_from_dict(group_schema)\n",
138 |     "    share_groups.append(g_r)"
139 |    ]
140 |   },
141 |   {
142 |    "cell_type": "markdown",
143 |    "metadata": {},
144 |    "source": [
145 |     "### Add users"
146 |    ]
147 |   },
148 |   {
149 |    "cell_type": "code",
150 |    "execution_count": null,
151 |    "metadata": {
152 |     "collapsed": true
153 |    },
154 |    "outputs": [],
155 |    "source": [
156 |     "# add users to the organization and specified groups\n",
157 |     "add_users_csv(USER_CSV, gis, groups=share_groups)"
158 |    ]
159 |   },
160 |   {
161 |    "cell_type": "markdown",
162 |    "metadata": {},
163 |    "source": [
164 |     "### Customize UI"
165 |    ]
166 |   },
167 |   {
168 |    "cell_type": "code",
169 |    "execution_count": null,
170 |    "metadata": {
171 |     "collapsed": true
172 |    },
173 |    "outputs": [],
174 |    "source": [
175 |     "# set UX components\n",
176 |     "ux = gis.admin.ux\n",
177 |     "ux.set_background(BACKGROUND_PATH)\n",
178 |     "ux.set_banner(BANNER_PATH)\n",
179 |     "ux.set_logo(THUMBNAIL_PATH)\n",
180 |     "\n",
181 |     "# find and set featured group\n",
182 |     "if FEATURED_GROUP:\n",
183 |     "    featured_group = gis.groups.search(FEATURED_GROUP)[0]\n",
184 |     "    ux.featured_content = {'group': featured_group}"
185 |    ]
186 |   }
187 |  ],
188 |  "metadata": {
189 |   "kernelspec": {
190 |    "display_name": "Python 3",
191 |    "language": "python",
192 |    "name": "python3"
193 |   },
194 |   "language_info": {
195 |    "codemirror_mode": {
196 |     "name": "ipython",
197 |     "version": 3
198 |    },
199 |    "file_extension": ".py",
200 |    "mimetype": "text/x-python",
201 |    "name": "python",
202 |    "nbconvert_exporter": "python",
203 |    "pygments_lexer": "ipython3",
204 |    "version": "3.6.3"
205 |   }
206 |  },
207 |  "nbformat": 4,
208 |  "nbformat_minor": 2
209 | }
210 | 


--------------------------------------------------------------------------------
/build_org/create_share_group.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Create & Share Group\n",
  8 |     "\n",
  9 |     "This script shows how to create a group and invite users. Let's say you're wiring up your product for your users, this script is useful if they already have accounts (as opposed to [configuring](https://github.com/mpayson/esri-partner-tools/blob/master/build_org/configure_org.ipynb) a new org) and you want a mechanism to [grant them access](https://github.com/mpayson/esri-partner-tools/blob/master/common_workflows/distribute_items.ipynb) to your content, without copying it to their instance."
 10 |    ]
 11 |   },
 12 |   {
 13 |    "cell_type": "code",
 14 |    "execution_count": null,
 15 |    "metadata": {
 16 |     "collapsed": true
 17 |    },
 18 |    "outputs": [],
 19 |    "source": [
 20 |     "from arcgis.gis import GIS"
 21 |    ]
 22 |   },
 23 |   {
 24 |    "cell_type": "markdown",
 25 |    "metadata": {},
 26 |    "source": [
 27 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`clone_utils`](https://github.com/mpayson/partner-python-tools/blob/master/partnerutils/clone_utils.py)"
 28 |    ]
 29 |   },
 30 |   {
 31 |    "cell_type": "code",
 32 |    "execution_count": null,
 33 |    "metadata": {
 34 |     "collapsed": true
 35 |    },
 36 |    "outputs": [],
 37 |    "source": [
 38 |     "from partnerutils.clone_utils import search_group_title"
 39 |    ]
 40 |   },
 41 |   {
 42 |    "cell_type": "code",
 43 |    "execution_count": null,
 44 |    "metadata": {
 45 |     "collapsed": true
 46 |    },
 47 |    "outputs": [],
 48 |    "source": [
 49 |     "gis = GIS(username=\"mpayson_startups\")"
 50 |    ]
 51 |   },
 52 |   {
 53 |    "cell_type": "markdown",
 54 |    "metadata": {},
 55 |    "source": [
 56 |     "## Create or Fetch Group\n",
 57 |     "\n",
 58 |     "Groups are used to share content with other organizations. This section is used to fetch an existing group or build a new one. More on [groups](https://doc.arcgis.com/en/arcgis-online/share-maps/groups.htm) and [schema](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html#arcgis.gis.GroupManager.create)."
 59 |    ]
 60 |   },
 61 |   {
 62 |    "cell_type": "code",
 63 |    "execution_count": null,
 64 |    "metadata": {
 65 |     "collapsed": true
 66 |    },
 67 |    "outputs": [],
 68 |    "source": [
 69 |     "# Group Schema\n",
 70 |     "# users_update_items must be false to invite members from other organizations\n",
 71 |     "group_schema = {\n",
 72 |     "    \"title\": \"My Test Title\",\n",
 73 |     "    \"tags\": \"test, group, poc, scripts\",\n",
 74 |     "    \"description\": \"Test group for partner python scripts\",\n",
 75 |     "    \"access\": 'private',\n",
 76 |     "    \"is_invitation_only\": True,\n",
 77 |     "    \"users_update_items\": False\n",
 78 |     "}"
 79 |    ]
 80 |   },
 81 |   {
 82 |    "cell_type": "code",
 83 |    "execution_count": null,
 84 |    "metadata": {
 85 |     "collapsed": true
 86 |    },
 87 |    "outputs": [],
 88 |    "source": [
 89 |     "# create the group if it doesn't already exist\n",
 90 |     "group = search_group_title(gis, group_schema[\"title\"])\n",
 91 |     "if group is None:\n",
 92 |     "    group = gis.groups.create_from_dict(group_schema)\n",
 93 |     "group"
 94 |    ]
 95 |   },
 96 |   {
 97 |    "cell_type": "markdown",
 98 |    "metadata": {},
 99 |    "source": [
100 |     "## Invite Users to Group\n",
101 |     "\n",
102 |     "Invite users to the group so you can share content. Two quick notes:\n",
103 |     "1. The API does not currently support programmatically accepting invites on behalf of users\n",
104 |     "2. You can also [search](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html#arcgis.gis.UserManager.search) for existing users, instead of hard-coding"
105 |    ]
106 |   },
107 |   {
108 |    "cell_type": "code",
109 |    "execution_count": null,
110 |    "metadata": {
111 |     "collapsed": true
112 |    },
113 |    "outputs": [],
114 |    "source": [
115 |     "usernames = ['mspatialstartups']"
116 |    ]
117 |   },
118 |   {
119 |    "cell_type": "code",
120 |    "execution_count": null,
121 |    "metadata": {
122 |     "collapsed": true
123 |    },
124 |    "outputs": [],
125 |    "source": [
126 |     "group.invite_users(usernames)"
127 |    ]
128 |   }
129 |  ],
130 |  "metadata": {
131 |   "kernelspec": {
132 |    "display_name": "Python 3",
133 |    "language": "python",
134 |    "name": "python3"
135 |   },
136 |   "language_info": {
137 |    "codemirror_mode": {
138 |     "name": "ipython",
139 |     "version": 3
140 |    },
141 |    "file_extension": ".py",
142 |    "mimetype": "text/x-python",
143 |    "name": "python",
144 |    "nbconvert_exporter": "python",
145 |    "pygments_lexer": "ipython3",
146 |    "version": "3.6.3"
147 |   }
148 |  },
149 |  "nbformat": 4,
150 |  "nbformat_minor": 2
151 | }
152 | 


--------------------------------------------------------------------------------
/build_org/register_application.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Register Application\n",
  8 |     "This script quickly demonstrates how to automatically [register an application](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/signing-in-arcgis-online-users/). If you're building an app that needs to authenticate into multiple [Enterprise](https://www.esri.com/en-us/arcgis/products/arcgis-enterprise/overview) instances, that app needs to be registered as an item in each instance. This script, with the appropriate credentials, can save pressing a few buttons."
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": null,
 14 |    "metadata": {},
 15 |    "outputs": [],
 16 |    "source": [
 17 |     "import requests\n",
 18 |     "import json\n",
 19 |     "from arcgis.gis import GIS"
 20 |    ]
 21 |   },
 22 |   {
 23 |    "cell_type": "code",
 24 |    "execution_count": null,
 25 |    "metadata": {},
 26 |    "outputs": [],
 27 |    "source": [
 28 |     "gis = GIS(username='mpayson_startups')"
 29 |    ]
 30 |   },
 31 |   {
 32 |    "cell_type": "markdown",
 33 |    "metadata": {},
 34 |    "source": [
 35 |     "## Configuration Parameters"
 36 |    ]
 37 |   },
 38 |   {
 39 |    "cell_type": "code",
 40 |    "execution_count": null,
 41 |    "metadata": {},
 42 |    "outputs": [],
 43 |    "source": [
 44 |     "app_props = {\n",
 45 |     "    'title': 'My Awesome App',\n",
 46 |     "    'tags': 'these, are, awesome, tags',\n",
 47 |     "    'description': 'An awesome app with awesome tags',\n",
 48 |     "    'type': 'Application'\n",
 49 |     "}\n",
 50 |     "redirect_uris = [\n",
 51 |     "  \"https://app.foo.com\",\n",
 52 |     "  \"urn:ietf:wg:oauth:2.0:oob\"\n",
 53 |     "]"
 54 |    ]
 55 |   },
 56 |   {
 57 |    "cell_type": "markdown",
 58 |    "metadata": {},
 59 |    "source": [
 60 |     "## Add and Register the Item\n",
 61 |     "An app is first added as an item then registered. More on [add item](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html#arcgis.gis.ContentManager.add) and [registration](https://developers.arcgis.com/rest/users-groups-and-items/register-app.htm)"
 62 |    ]
 63 |   },
 64 |   {
 65 |    "cell_type": "code",
 66 |    "execution_count": null,
 67 |    "metadata": {},
 68 |    "outputs": [],
 69 |    "source": [
 70 |     "app_item = gis.content.add(app_props)\n",
 71 |     "app_item"
 72 |    ]
 73 |   },
 74 |   {
 75 |    "cell_type": "code",
 76 |    "execution_count": null,
 77 |    "metadata": {},
 78 |    "outputs": [],
 79 |    "source": [
 80 |     "# note, for now assumes the portal supports https\n",
 81 |     "register_url = '{0}/oauth2/registerApp'.format(gis._portal.resturl)\n",
 82 |     "uri_str = json.dumps(redirect_uris)\n",
 83 |     "register_props = {\n",
 84 |     "    'itemId': app_item.id,\n",
 85 |     "    'appType': 'multiple',\n",
 86 |     "    'redirect_uris': uri_str,\n",
 87 |     "    'token': gis._portal.con._token,\n",
 88 |     "    'f': 'json'\n",
 89 |     "}"
 90 |    ]
 91 |   },
 92 |   {
 93 |    "cell_type": "code",
 94 |    "execution_count": null,
 95 |    "metadata": {},
 96 |    "outputs": [],
 97 |    "source": [
 98 |     "# register it!\n",
 99 |     "r = requests.post(register_url, data=register_props)\n",
100 |     "resp_dict = json.loads(r.text)\n",
101 |     "if \"error\" in resp_dict:\n",
102 |     "    print(resp_dict)\n",
103 |     "else:\n",
104 |     "    print(\"client id: {0}\".format(resp_dict[\"client_id\"]))"
105 |    ]
106 |   }
107 |  ],
108 |  "metadata": {
109 |   "kernelspec": {
110 |    "display_name": "Python 3",
111 |    "language": "python",
112 |    "name": "python3"
113 |   },
114 |   "language_info": {
115 |    "codemirror_mode": {
116 |     "name": "ipython",
117 |     "version": 3
118 |    },
119 |    "file_extension": ".py",
120 |    "mimetype": "text/x-python",
121 |    "name": "python",
122 |    "nbconvert_exporter": "python",
123 |    "pygments_lexer": "ipython3",
124 |    "version": "3.6.3"
125 |   }
126 |  },
127 |  "nbformat": 4,
128 |  "nbformat_minor": 2
129 | }
130 | 


--------------------------------------------------------------------------------
/common_workflows/README.md:
--------------------------------------------------------------------------------
1 | # Common
2 | 
3 | > Common workflows with the Python API
4 | 
5 | * [`csv_geocode.ipynb`](/common_workflows/csv_geocode.ipynb) - [geocode](https://developers.arcgis.com/features/geocoding/) rows in `csvs` and `dataframes`
6 | * [`vector_data_products`](/common_workflows/vector_data_products.ipynb) - end-to-end workflows for managing vector content and derivative information products
7 | * [`distribute_items.ipynb`](/common_workflows/distribute_items.ipynb) - common patterns for distributing items to another organization
8 | * [`standard_geography.ipynb`](/common_workflows/standard_geography.ipynb) - enrich [standard geography](https://developers.arcgis.com/rest/geoenrichment/api-reference/standard-geography-query.htm) ids, such as `census blocks`, with geometries


--------------------------------------------------------------------------------
/common_workflows/csv_geocode.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Bulk CSV Geocode\n",
  8 |     "*A notebook to [geocode](https://developers.arcgis.com/features/geocoding/) rows in a `csv`*"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": null,
 14 |    "metadata": {
 15 |     "collapsed": true,
 16 |     "jupyter": {
 17 |      "outputs_hidden": true
 18 |     }
 19 |    },
 20 |    "outputs": [],
 21 |    "source": [
 22 |     "# common imports\n",
 23 |     "import csv\n",
 24 |     "from arcgis.gis import GIS\n",
 25 |     "from arcgis.geocoding import batch_geocode"
 26 |    ]
 27 |   },
 28 |   {
 29 |    "cell_type": "markdown",
 30 |    "metadata": {},
 31 |    "source": [
 32 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`cool_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/cool_utils.py)"
 33 |    ]
 34 |   },
 35 |   {
 36 |    "cell_type": "code",
 37 |    "execution_count": null,
 38 |    "metadata": {
 39 |     "collapsed": true,
 40 |     "jupyter": {
 41 |      "outputs_hidden": true
 42 |     }
 43 |    },
 44 |    "outputs": [],
 45 |    "source": [
 46 |     "from partnerutils.cool_utils import chunk"
 47 |    ]
 48 |   },
 49 |   {
 50 |    "cell_type": "markdown",
 51 |    "metadata": {},
 52 |    "source": [
 53 |     "## User Input\n",
 54 |     "* **GIS**: Your GIS instance, parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/). Not specifying a password creates a password prompt"
 55 |    ]
 56 |   },
 57 |   {
 58 |    "cell_type": "code",
 59 |    "execution_count": null,
 60 |    "metadata": {
 61 |     "collapsed": true,
 62 |     "jupyter": {
 63 |      "outputs_hidden": true
 64 |     }
 65 |    },
 66 |    "outputs": [],
 67 |    "source": [
 68 |     "gis = GIS(username=\"mpayson_startups\")"
 69 |    ]
 70 |   },
 71 |   {
 72 |    "cell_type": "markdown",
 73 |    "metadata": {},
 74 |    "source": [
 75 |     "* **csv_path**: path to the `csv` to be geocoded\n",
 76 |     "* **out_path**: path to the output `csv`\n",
 77 |     "* **address_fields**: map geocode request fields to csv fields, can also be a SingleLine field string--more [here](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-geocode-addresses.htm) "
 78 |    ]
 79 |   },
 80 |   {
 81 |    "cell_type": "code",
 82 |    "execution_count": null,
 83 |    "metadata": {
 84 |     "collapsed": true,
 85 |     "jupyter": {
 86 |      "outputs_hidden": true
 87 |     }
 88 |    },
 89 |    "outputs": [],
 90 |    "source": [
 91 |     "csv_path = \"NYC Inspection test.csv\"\n",
 92 |     "out_path = \"Geocode Results.csv\"\n",
 93 |     "address_fields = {\n",
 94 |     "    \"Address\": \"ADDRESS\",\n",
 95 |     "    \"City\": \"CITY\",\n",
 96 |     "    \"Region\": \"STATE\",\n",
 97 |     "    \"Postal\": \"ZIPCODE\"\n",
 98 |     "}"
 99 |    ]
100 |   },
101 |   {
102 |    "cell_type": "markdown",
103 |    "metadata": {},
104 |    "source": [
105 |     "## Functions"
106 |    ]
107 |   },
108 |   {
109 |    "cell_type": "code",
110 |    "execution_count": null,
111 |    "metadata": {
112 |     "collapsed": true,
113 |     "jupyter": {
114 |      "outputs_hidden": true
115 |     }
116 |    },
117 |    "outputs": [],
118 |    "source": [
119 |     "# translate csv fields to geocode request fields\n",
120 |     "def format_request_address(row, address_fields):\n",
121 |     "    if type(address_fields) == str:\n",
122 |     "        return row[address_fields]\n",
123 |     "    return {field: row[address_fields[field]] for field in address_fields}\n",
124 |     "\n",
125 |     "# get output location dictionary from geocode result\n",
126 |     "def get_location(res):\n",
127 |     "    if res:\n",
128 |     "        return {\n",
129 |     "            \"x\": res['location']['x'],\n",
130 |     "            \"y\": res['location']['y'],\n",
131 |     "            \"score\": res['score']\n",
132 |     "        }\n",
133 |     "    return {}"
134 |    ]
135 |   },
136 |   {
137 |    "cell_type": "markdown",
138 |    "metadata": {},
139 |    "source": [
140 |     "## Execution"
141 |    ]
142 |   },
143 |   {
144 |    "cell_type": "code",
145 |    "execution_count": null,
146 |    "metadata": {
147 |     "collapsed": true,
148 |     "jupyter": {
149 |      "outputs_hidden": true
150 |     }
151 |    },
152 |    "outputs": [],
153 |    "source": [
154 |     "# read the csv\n",
155 |     "with open(csv_path, 'r') as data_csv:\n",
156 |     "    rows = csv.DictReader(data_csv)\n",
157 |     "    data = [row for row in rows]"
158 |    ]
159 |   },
160 |   {
161 |    "cell_type": "code",
162 |    "execution_count": null,
163 |    "metadata": {
164 |     "collapsed": true,
165 |     "jupyter": {
166 |      "outputs_hidden": true
167 |     }
168 |    },
169 |    "outputs": [],
170 |    "source": [
171 |     "output = []\n",
172 |     "\n",
173 |     "# iterate through chunks, format the address requests, geocode, merge location results with chunk data\n",
174 |     "for c in chunk(data):\n",
175 |     "    adrs = [format_request_address(r, address_fields) for r in c]\n",
176 |     "    results = batch_geocode(addresses=adrs)\n",
177 |     "    chunk_out = [{**r, **get_location(results[i])} for i, r in enumerate(c)]\n",
178 |     "    output += chunk_out"
179 |    ]
180 |   },
181 |   {
182 |    "cell_type": "code",
183 |    "execution_count": null,
184 |    "metadata": {
185 |     "collapsed": true,
186 |     "jupyter": {
187 |      "outputs_hidden": true
188 |     }
189 |    },
190 |    "outputs": [],
191 |    "source": [
192 |     "# write output\n",
193 |     "with open(out_path, 'w') as csvfile:\n",
194 |     "    writer = csv.DictWriter(csvfile, fieldnames=output[0].keys())\n",
195 |     "    writer.writeheader()\n",
196 |     "    for row in output:\n",
197 |     "        writer.writerow(row)"
198 |    ]
199 |   }
200 |  ],
201 |  "metadata": {
202 |   "kernelspec": {
203 |    "display_name": "Python 3",
204 |    "language": "python",
205 |    "name": "python3"
206 |   },
207 |   "language_info": {
208 |    "codemirror_mode": {
209 |     "name": "ipython",
210 |     "version": 3
211 |    },
212 |    "file_extension": ".py",
213 |    "mimetype": "text/x-python",
214 |    "name": "python",
215 |    "nbconvert_exporter": "python",
216 |    "pygments_lexer": "ipython3",
217 |    "version": "3.7.4"
218 |   }
219 |  },
220 |  "nbformat": 4,
221 |  "nbformat_minor": 4
222 | }
223 | 


--------------------------------------------------------------------------------
/common_workflows/distribute_items.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Distribute Items\n",
  8 |     "Jupyter Notebook to show different patterns for distributing items to another organization.\n",
  9 |     "\n",
 10 |     "The patterns can include: [share items](#Share-Item) || [copy & share items](#Copy-then-Share-Item) || [clone items](#Clone-Item) || [clone and modify applications](#Clone-and-Modify-Applications) and more\n",
 11 |     "\n",
 12 |     "> ***Note** [Groups](https://doc.arcgis.com/en/arcgis-online/share-maps/groups.htm) can be used to share data so that you maintain ownership without cloning the content. To set up groups, see [configure](https://github.com/mpayson/esri-partner-tools/blob/master/build_org/configure_org.ipynb) for new users, or [create_share](https://github.com/mpayson/esri-partner-tools/blob/master/build_org/create_share_group.ipynb) for existing users."
 13 |    ]
 14 |   },
 15 |   {
 16 |    "cell_type": "code",
 17 |    "execution_count": null,
 18 |    "metadata": {},
 19 |    "outputs": [],
 20 |    "source": [
 21 |     "from arcgis.gis import GIS, Item"
 22 |    ]
 23 |   },
 24 |   {
 25 |    "cell_type": "markdown",
 26 |    "metadata": {},
 27 |    "source": [
 28 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`clone_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/clone_utils.py)"
 29 |    ]
 30 |   },
 31 |   {
 32 |    "cell_type": "code",
 33 |    "execution_count": null,
 34 |    "metadata": {},
 35 |    "outputs": [],
 36 |    "source": [
 37 |     "from partnerutils.clone_utils import search_group_title, clone_items_modify, search_item_title"
 38 |    ]
 39 |   },
 40 |   {
 41 |    "cell_type": "code",
 42 |    "execution_count": null,
 43 |    "metadata": {},
 44 |    "outputs": [],
 45 |    "source": [
 46 |     "src = GIS(username=\"mpayson_startups\")\n",
 47 |     "tar = GIS(username=\"mspatialstartups\")"
 48 |    ]
 49 |   },
 50 |   {
 51 |    "cell_type": "markdown",
 52 |    "metadata": {},
 53 |    "source": [
 54 |     "#### Example Constants"
 55 |    ]
 56 |   },
 57 |   {
 58 |    "cell_type": "code",
 59 |    "execution_count": null,
 60 |    "metadata": {},
 61 |    "outputs": [],
 62 |    "source": [
 63 |     "GROUP_NAMES = ['Max Test']\n",
 64 |     "\n",
 65 |     "SHARE_ITEMID = \"90dffd24537240a59eede871ade5856a\"\n",
 66 |     "COPY_ITEMID = \"90dffd24537240a59eede871ade5856a\"\n",
 67 |     "CLONE_ITEMID = \"90dffd24537240a59eede871ade5856a\"\n",
 68 |     "APP_ID = \"1bbda506fdfd4c82a90fea57426f5603\"\n",
 69 |     "\n",
 70 |     "NAME_TEMPLATE = \"{} -- \" + tar.properties['urlKey']\n",
 71 |     "FOLDER = \"Content -- \" + tar.properties['urlKey']"
 72 |    ]
 73 |   },
 74 |   {
 75 |    "cell_type": "code",
 76 |    "execution_count": null,
 77 |    "metadata": {},
 78 |    "outputs": [],
 79 |    "source": [
 80 |     "groups = [search_group_title(target=src, title=n, outside_org=True) for n in GROUP_NAMES]\n",
 81 |     "groups"
 82 |    ]
 83 |   },
 84 |   {
 85 |    "cell_type": "markdown",
 86 |    "metadata": {},
 87 |    "source": [
 88 |     "### Modify Functions\n",
 89 |     "Sometimes you don't want a 1:1 copy, these functions will modify the cloned item properties. A few notes:\n",
 90 |     "* `modify_item_callback` receives the cloned item and its gis. It should return a flattened dict of properties [here](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html?highlight=clone_items#arcgis.gis.Item.update)\n",
 91 |     "* The default behavior is to update the item to match the NAME_TEMPLATE"
 92 |    ]
 93 |   },
 94 |   {
 95 |    "cell_type": "code",
 96 |    "execution_count": null,
 97 |    "metadata": {},
 98 |    "outputs": [],
 99 |    "source": [
100 |     "def modify_item_callback(item, target_gis):\n",
101 |     "    title = NAME_TEMPLATE.format(item.title)\n",
102 |     "    while search_item_title(target_gis, title):\n",
103 |     "        title = input(\"Title `{0}` for ITEM `{1}` already exists \\n new title: \"\n",
104 |     "                         .format(title, item.title))\n",
105 |     "    return {\"title\": title}"
106 |    ]
107 |   },
108 |   {
109 |    "cell_type": "markdown",
110 |    "metadata": {},
111 |    "source": [
112 |     "## Execution"
113 |    ]
114 |   },
115 |   {
116 |    "cell_type": "markdown",
117 |    "metadata": {},
118 |    "source": [
119 |     "### Share Item\n",
120 |     "Shares an item with an existing group. Use this pattern if you want to own and maintain single authoritative items that all of your user organizations can access."
121 |    ]
122 |   },
123 |   {
124 |    "cell_type": "code",
125 |    "execution_count": null,
126 |    "metadata": {},
127 |    "outputs": [],
128 |    "source": [
129 |     "share_item = Item(src, SHARE_ITEMID)"
130 |    ]
131 |   },
132 |   {
133 |    "cell_type": "code",
134 |    "execution_count": null,
135 |    "metadata": {},
136 |    "outputs": [],
137 |    "source": [
138 |     "share_item.share(groups=groups)"
139 |    ]
140 |   },
141 |   {
142 |    "cell_type": "markdown",
143 |    "metadata": {},
144 |    "source": [
145 |     "### Copy then Share Item\n",
146 |     "Copies and shares an item to an existing group. Use this pattern if you have a template item and you want each user organization to access a copy while **you own and maintain the copies**."
147 |    ]
148 |   },
149 |   {
150 |    "cell_type": "code",
151 |    "execution_count": null,
152 |    "metadata": {},
153 |    "outputs": [],
154 |    "source": [
155 |     "copy_item = Item(src, COPY_ITEMID)"
156 |    ]
157 |   },
158 |   {
159 |    "cell_type": "code",
160 |    "execution_count": null,
161 |    "metadata": {},
162 |    "outputs": [],
163 |    "source": [
164 |     "paste_items = clone_items_modify([copy_item], src,\n",
165 |     "                               modify_item_callback=modify_item_callback,\n",
166 |     "                               copy_data=False, search_existing_items=False,\n",
167 |     "                               folder=FOLDER)\n",
168 |     "paste_share_res = [i.share(groups=groups) for i in paste_items]\n",
169 |     "paste_share_res"
170 |    ]
171 |   },
172 |   {
173 |    "cell_type": "markdown",
174 |    "metadata": {},
175 |    "source": [
176 |     "### Clone Item\n",
177 |     "Clones an item to a target organization. Use this pattern if you have a template item and you want **each user organization to own their copy**."
178 |    ]
179 |   },
180 |   {
181 |    "cell_type": "code",
182 |    "execution_count": null,
183 |    "metadata": {},
184 |    "outputs": [],
185 |    "source": [
186 |     "clone_item = Item(src, CLONE_ITEMID)"
187 |    ]
188 |   },
189 |   {
190 |    "cell_type": "code",
191 |    "execution_count": null,
192 |    "metadata": {},
193 |    "outputs": [],
194 |    "source": [
195 |     "clones = clone_items_modify([clone_item], tar,\n",
196 |     "                               modify_item_callback=modify_item_callback,\n",
197 |     "                               copy_data=True, search_existing_items=False,\n",
198 |     "                               folder=FOLDER)\n",
199 |     "clones"
200 |    ]
201 |   },
202 |   {
203 |    "cell_type": "markdown",
204 |    "metadata": {},
205 |    "source": [
206 |     "### Clone and Modify Applications\n",
207 |     "Clones an application (or webmap) then swizzles the dependencies. Use this pattern if you have a template application/map that should be configured for data that your user organizations can now access.\n",
208 |     "\n",
209 |     "By default, the clone_items functions will also clone dependencies. This example shows how to reference the newly shared item via a group, so that the end-organization owns the application but you maintain the underlying data."
210 |    ]
211 |   },
212 |   {
213 |    "cell_type": "code",
214 |    "execution_count": null,
215 |    "metadata": {},
216 |    "outputs": [],
217 |    "source": [
218 |     "app_item = Item(src, APP_ID)\n",
219 |     "item_map = {copy_item.id: paste_items[0].id}\n",
220 |     "item_map"
221 |    ]
222 |   },
223 |   {
224 |    "cell_type": "code",
225 |    "execution_count": null,
226 |    "metadata": {},
227 |    "outputs": [],
228 |    "source": [
229 |     "app_clones = clone_items_modify([app_item], tar,\n",
230 |     "                               modify_item_callback=modify_item_callback,\n",
231 |     "                               copy_data=False, search_existing_items=False,\n",
232 |     "                               folder=FOLDER,\n",
233 |     "                               item_mapping=item_map)\n",
234 |     "app_clones"
235 |    ]
236 |   },
237 |   {
238 |    "cell_type": "code",
239 |    "execution_count": null,
240 |    "metadata": {},
241 |    "outputs": [],
242 |    "source": []
243 |   }
244 |  ],
245 |  "metadata": {
246 |   "kernelspec": {
247 |    "display_name": "Python 3",
248 |    "language": "python",
249 |    "name": "python3"
250 |   },
251 |   "language_info": {
252 |    "codemirror_mode": {
253 |     "name": "ipython",
254 |     "version": 3
255 |    },
256 |    "file_extension": ".py",
257 |    "mimetype": "text/x-python",
258 |    "name": "python",
259 |    "nbconvert_exporter": "python",
260 |    "pygments_lexer": "ipython3",
261 |    "version": "3.7.4"
262 |   }
263 |  },
264 |  "nbformat": 4,
265 |  "nbformat_minor": 4
266 | }
267 | 


--------------------------------------------------------------------------------
/common_workflows/standard_geography.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Bulk Standard Geography\n",
  8 |     "A notebook to enrich **[standard geography](https://developers.arcgis.com/rest/geoenrichment/api-reference/standard-geography-query.htm) ids**, such as `census block groups`, with their geometries and publish as a geographic layer. This uses the [`standard_geography_query`](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.geoenrichment.html#standard-geography-query) function and there's a blog about these queries [here](https://blogs.esri.com/esri/arcgis/2017/07/10/best-practices-how-to-query-standard-geographies-branches/)."
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": null,
 14 |    "metadata": {},
 15 |    "outputs": [],
 16 |    "source": [
 17 |     "# common imports\n",
 18 |     "import pandas as pd\n",
 19 |     "from arcgis.gis import GIS\n",
 20 |     "from arcgis.geoenrichment import standard_geography_query"
 21 |    ]
 22 |   },
 23 |   {
 24 |    "cell_type": "markdown",
 25 |    "metadata": {},
 26 |    "source": [
 27 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`cool_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/cool_utils.py)"
 28 |    ]
 29 |   },
 30 |   {
 31 |    "cell_type": "code",
 32 |    "execution_count": null,
 33 |    "metadata": {},
 34 |    "outputs": [],
 35 |    "source": [
 36 |     "from partnerutils.cool_utils import chunk"
 37 |    ]
 38 |   },
 39 |   {
 40 |    "cell_type": "markdown",
 41 |    "metadata": {},
 42 |    "source": [
 43 |     "## User Input\n",
 44 |     "* **GIS**: Your GIS instance, parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/). Not specifying a password creates a password prompt"
 45 |    ]
 46 |   },
 47 |   {
 48 |    "cell_type": "code",
 49 |    "execution_count": null,
 50 |    "metadata": {},
 51 |    "outputs": [],
 52 |    "source": [
 53 |     "gis = GIS(username=\"mpayson_startups\")"
 54 |    ]
 55 |   },
 56 |   {
 57 |    "cell_type": "markdown",
 58 |    "metadata": {},
 59 |    "source": [
 60 |     "* **csv_path**: Path to the `csv` with geography IDs\n",
 61 |     "* **lyr_title**: Title for output hosted layer\n",
 62 |     "* **layers**: The standard geography layers whose geometry you want to fetch. Here's the [US list](http://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer/Geoenrichment/StandardGeographyLevels/US/census?f=pjson) of layers.\n",
 63 |     "* **f_std_id**: The `csv` field with the ids corresponding to a standard geography layer"
 64 |    ]
 65 |   },
 66 |   {
 67 |    "cell_type": "code",
 68 |    "execution_count": null,
 69 |    "metadata": {},
 70 |    "outputs": [],
 71 |    "source": [
 72 |     "csv_path = '../sample_data/sample_census_tract_geoid.csv'\n",
 73 |     "lyr_title = 'test out'\n",
 74 |     "layers = ['US.Tracts']\n",
 75 |     "f_std_id = 'census_tract_geoid'"
 76 |    ]
 77 |   },
 78 |   {
 79 |    "cell_type": "markdown",
 80 |    "metadata": {},
 81 |    "source": [
 82 |     "## Execution"
 83 |    ]
 84 |   },
 85 |   {
 86 |    "cell_type": "code",
 87 |    "execution_count": null,
 88 |    "metadata": {},
 89 |    "outputs": [],
 90 |    "source": [
 91 |     "# read df\n",
 92 |     "df = pd.read_csv(csv_path, dtype={f_std_id: 'object'})"
 93 |    ]
 94 |   },
 95 |   {
 96 |    "cell_type": "code",
 97 |    "execution_count": null,
 98 |    "metadata": {},
 99 |    "outputs": [],
100 |    "source": [
101 |     "# get and concat geometries, chunking because of request time-outs\n",
102 |     "ids = [i for i in df[f_std_id]]\n",
103 |     "gdf = pd.concat((standard_geography_query(layers=layers, ids=c, return_geometry=True) for c in chunk(ids)), ignore_index=True)"
104 |    ]
105 |   },
106 |   {
107 |    "cell_type": "code",
108 |    "execution_count": null,
109 |    "metadata": {},
110 |    "outputs": [],
111 |    "source": [
112 |     "# merge geometries\n",
113 |     "sdf = pd.merge(gdf, df, left_on='AreaID', right_on=f_std_id)"
114 |    ]
115 |   },
116 |   {
117 |    "cell_type": "code",
118 |    "execution_count": null,
119 |    "metadata": {},
120 |    "outputs": [],
121 |    "source": [
122 |     "# Send it!\n",
123 |     "sdf.spatial.to_featurelayer(lyr_title, tags=\"esri_partner_tools_sample\")"
124 |    ]
125 |   },
126 |   {
127 |    "cell_type": "markdown",
128 |    "metadata": {},
129 |    "source": [
130 |     "## Clean up"
131 |    ]
132 |   },
133 |   {
134 |    "cell_type": "code",
135 |    "execution_count": null,
136 |    "metadata": {},
137 |    "outputs": [],
138 |    "source": [
139 |     "delete_items = gis.content.search(\"tags:esri_partner_tools_sample\")\n",
140 |     "gis.content.delete_items(delete_items)"
141 |    ]
142 |   }
143 |  ],
144 |  "metadata": {
145 |   "kernelspec": {
146 |    "display_name": "Python 3",
147 |    "language": "python",
148 |    "name": "python3"
149 |   },
150 |   "language_info": {
151 |    "codemirror_mode": {
152 |     "name": "ipython",
153 |     "version": 3
154 |    },
155 |    "file_extension": ".py",
156 |    "mimetype": "text/x-python",
157 |    "name": "python",
158 |    "nbconvert_exporter": "python",
159 |    "pygments_lexer": "ipython3",
160 |    "version": "3.7.4"
161 |   }
162 |  },
163 |  "nbformat": 4,
164 |  "nbformat_minor": 4
165 | }
166 | 


--------------------------------------------------------------------------------
/common_workflows/update_webmaps.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Update Webmaps\n",
  8 |     "Short snippets for updating webmaps!"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": 1,
 14 |    "metadata": {},
 15 |    "outputs": [],
 16 |    "source": [
 17 |     "import json\n",
 18 |     "from arcgis.gis import GIS, Item"
 19 |    ]
 20 |   },
 21 |   {
 22 |    "cell_type": "code",
 23 |    "execution_count": 2,
 24 |    "metadata": {},
 25 |    "outputs": [
 26 |     {
 27 |      "name": "stdin",
 28 |      "output_type": "stream",
 29 |      "text": [
 30 |       "Enter password:  ········\n"
 31 |      ]
 32 |     }
 33 |    ],
 34 |    "source": [
 35 |     "gis = GIS(username=\"mpayson_startups\")"
 36 |    ]
 37 |   },
 38 |   {
 39 |    "cell_type": "markdown",
 40 |    "metadata": {},
 41 |    "source": [
 42 |     "## Initialization"
 43 |    ]
 44 |   },
 45 |   {
 46 |    "cell_type": "code",
 47 |    "execution_count": 3,
 48 |    "metadata": {},
 49 |    "outputs": [
 50 |     {
 51 |      "data": {
 52 |       "text/html": [
 53 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
 54 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
 55 |        "                       <a href='https://Startups.maps.arcgis.com/home/item.html?id=185a060995a44e98b3db2c27f3f533e2' target='_blank'>\n",
 56 |        "                        <img src='data:image/png;base64,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' width='200' height='133' class=\"itemThumbnail\">\n",
 57 |        "                       </a>\n",
 58 |        "                    </div>\n",
 59 |        "\n",
 60 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
 61 |        "                        <a href='https://Startups.maps.arcgis.com/home/item.html?id=185a060995a44e98b3db2c27f3f533e2' target='_blank'><b>Demo Map Updates</b>\n",
 62 |        "                        </a>\n",
 63 |        "                        <br/><img src='https://Startups.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/maps16.png' style=\"vertical-align:middle;\">Web Map by mpayson_startups\n",
 64 |        "                        <br/>Last Modified: December 29, 2019\n",
 65 |        "                        <br/>0 comments, 11 views\n",
 66 |        "                    </div>\n",
 67 |        "                </div>\n",
 68 |        "                "
 69 |       ],
 70 |       "text/plain": [
 71 |        "<Item title:\"Demo Map Updates\" type:Web Map owner:mpayson_startups>"
 72 |       ]
 73 |      },
 74 |      "execution_count": 3,
 75 |      "metadata": {},
 76 |      "output_type": "execute_result"
 77 |     }
 78 |    ],
 79 |    "source": [
 80 |     "# Get map item and fetch the JSON representation\n",
 81 |     "map_item = Item(gis, '185a060995a44e98b3db2c27f3f533e2')\n",
 82 |     "map_item"
 83 |    ]
 84 |   },
 85 |   {
 86 |    "cell_type": "code",
 87 |    "execution_count": 4,
 88 |    "metadata": {},
 89 |    "outputs": [],
 90 |    "source": [
 91 |     "map_dict = dict(map_item.get_data())\n",
 92 |     "revert_dict = map_dict"
 93 |    ]
 94 |   },
 95 |   {
 96 |    "cell_type": "markdown",
 97 |    "metadata": {},
 98 |    "source": [
 99 |     "## Change basemap\n",
100 |     "\n",
101 |     "Replaces a webmap basemap with **[an existing basemap](https://www.arcgis.com/home/group.html?id=30de8da907d240a0bccd5ad3ff25ef4a&view=list&focus=maps-webmaps#content)** in ArcGIS Online."
102 |    ]
103 |   },
104 |   {
105 |    "cell_type": "code",
106 |    "execution_count": 5,
107 |    "metadata": {},
108 |    "outputs": [
109 |     {
110 |      "data": {
111 |       "text/plain": [
112 |        "True"
113 |       ]
114 |      },
115 |      "execution_count": 5,
116 |      "metadata": {},
117 |      "output_type": "execute_result"
118 |     }
119 |    ],
120 |    "source": [
121 |     "# colored pencil basemap\n",
122 |     "bm_item = Item(gis, '826498a48bd0424f9c9315214f2165d4')\n",
123 |     "\n",
124 |     "map_dict = dict(map_item.get_data())\n",
125 |     "bm_dict = dict(bm_item.get_data())\n",
126 |     "\n",
127 |     "map_dict['baseMap'] = bm_dict['baseMap']\n",
128 |     "\n",
129 |     "map_item.update(data=json.dumps(map_dict))"
130 |    ]
131 |   },
132 |   {
133 |    "cell_type": "markdown",
134 |    "metadata": {},
135 |    "source": [
136 |     "## Change layer visibility\n",
137 |     "Controls whether a specific layer is visible when the map first loads"
138 |    ]
139 |   },
140 |   {
141 |    "cell_type": "code",
142 |    "execution_count": 6,
143 |    "metadata": {},
144 |    "outputs": [
145 |     {
146 |      "data": {
147 |       "text/plain": [
148 |        "True"
149 |       ]
150 |      },
151 |      "execution_count": 6,
152 |      "metadata": {},
153 |      "output_type": "execute_result"
154 |     }
155 |    ],
156 |    "source": [
157 |     "lyr_i = [\n",
158 |     "    i for i,l in enumerate(map_dict['operationalLayers'])\n",
159 |     "    if l['id'] == 'USA_Consumer_Expenditures_1_2019_5133'\n",
160 |     "][0]\n",
161 |     "\n",
162 |     "is_vis = not map_dict['operationalLayers'][lyr_i]['visibility']\n",
163 |     "map_dict['operationalLayers'][lyr_i]['visibility'] = is_vis\n",
164 |     "\n",
165 |     "map_item.update(data=json.dumps(map_dict))"
166 |    ]
167 |   },
168 |   {
169 |    "cell_type": "markdown",
170 |    "metadata": {},
171 |    "source": [
172 |     "## Change layer title & id\n",
173 |     "Updates a specific layer title & id. **NOTE** Esri configurable apps use the ID to configure & define a layers behavior, so if you change the ID it will likely break any pre-created apps."
174 |    ]
175 |   },
176 |   {
177 |    "cell_type": "code",
178 |    "execution_count": 7,
179 |    "metadata": {},
180 |    "outputs": [
181 |     {
182 |      "data": {
183 |       "text/plain": [
184 |        "True"
185 |       ]
186 |      },
187 |      "execution_count": 7,
188 |      "metadata": {},
189 |      "output_type": "execute_result"
190 |     }
191 |    ],
192 |    "source": [
193 |     "lyr_dict = map_dict['operationalLayers'][0]\n",
194 |     "update_lyr_dict = {\n",
195 |     "    **lyr_dict,\n",
196 |     "    'title': 'Some cool demographic data',\n",
197 |     "    'id': 'my_well_known_id'\n",
198 |     "}\n",
199 |     "map_dict['operationalLayers'][0] = update_lyr_dict\n",
200 |     "\n",
201 |     "map_item.update(data=json.dumps(map_dict))"
202 |    ]
203 |   },
204 |   {
205 |    "cell_type": "markdown",
206 |    "metadata": {},
207 |    "source": [
208 |     "## Apply filter to layer\n",
209 |     "Limits what data gets drawn on the map. Note, this is used as an initial configuration, not to securely limit what data the end-user can access. For the latter, [create a new view item](https://github.com/mpayson/esri-partner-tools/blob/master/feature_layers/create_views.ipynb).\n",
210 |     "\n",
211 |     "TODO: the mapviewer also automatically builds an index when a filter is applied, might be worth doing the same. Similar code and index paramss:\n",
212 |     "```python\n",
213 |     "\"indexes\":[{\n",
214 |     "    \"name\":\"GRADE_Index\",\n",
215 |     "    \"fields\":\"GRADE\",\n",
216 |     "    \"isUnique\":False,\n",
217 |     "    \"isAscending\":True,\n",
218 |     "    \"description\":\"GRADE_Index\"\n",
219 |     "}]\n",
220 |     "```"
221 |    ]
222 |   },
223 |   {
224 |    "cell_type": "code",
225 |    "execution_count": 8,
226 |    "metadata": {},
227 |    "outputs": [
228 |     {
229 |      "data": {
230 |       "text/plain": [
231 |        "True"
232 |       ]
233 |      },
234 |      "execution_count": 8,
235 |      "metadata": {},
236 |      "output_type": "execute_result"
237 |     }
238 |    ],
239 |    "source": [
240 |     "lyr_i = [\n",
241 |     "    i for i,l in enumerate(map_dict['operationalLayers'])\n",
242 |     "    if l['id'] == 'aff768_9005'\n",
243 |     "][0]\n",
244 |     "lyr_dict = map_dict['operationalLayers'][lyr_i]\n",
245 |     "\n",
246 |     "sql_where = \"GRADE = 'A'\"\n",
247 |     "update_lyr_dict = {\n",
248 |     "    **lyr_dict,\n",
249 |     "    \"layerDefinition\": {\n",
250 |     "        \"definitionExpression\": sql_where\n",
251 |     "    }\n",
252 |     "}\n",
253 |     "\n",
254 |     "map_dict['operationalLayers'][lyr_i] = update_lyr_dict\n",
255 |     "map_item.update(data=json.dumps(map_dict))"
256 |    ]
257 |   },
258 |   {
259 |    "cell_type": "markdown",
260 |    "metadata": {},
261 |    "source": [
262 |     "## Clean up"
263 |    ]
264 |   },
265 |   {
266 |    "cell_type": "code",
267 |    "execution_count": 9,
268 |    "metadata": {},
269 |    "outputs": [
270 |     {
271 |      "data": {
272 |       "text/plain": [
273 |        "True"
274 |       ]
275 |      },
276 |      "execution_count": 9,
277 |      "metadata": {},
278 |      "output_type": "execute_result"
279 |     }
280 |    ],
281 |    "source": [
282 |     "map_item.update(data=json.dumps(revert_dict))"
283 |    ]
284 |   },
285 |   {
286 |    "cell_type": "code",
287 |    "execution_count": null,
288 |    "metadata": {},
289 |    "outputs": [],
290 |    "source": []
291 |   }
292 |  ],
293 |  "metadata": {
294 |   "kernelspec": {
295 |    "display_name": "Python 3",
296 |    "language": "python",
297 |    "name": "python3"
298 |   },
299 |   "language_info": {
300 |    "codemirror_mode": {
301 |     "name": "ipython",
302 |     "version": 3
303 |    },
304 |    "file_extension": ".py",
305 |    "mimetype": "text/x-python",
306 |    "name": "python",
307 |    "nbconvert_exporter": "python",
308 |    "pygments_lexer": "ipython3",
309 |    "version": "3.7.4"
310 |   }
311 |  },
312 |  "nbformat": 4,
313 |  "nbformat_minor": 4
314 | }
315 | 


--------------------------------------------------------------------------------
/feature_layers/README.md:
--------------------------------------------------------------------------------
 1 | # Feature Layers
 2 | 
 3 | > Common operations with [hosted feature layers](https://doc.arcgis.com/en/arcgis-online/share-maps/hosted-web-layers.htm)
 4 | 
 5 | * [`csv_upload.ipynb`](/feature_layers/csv_upload.ipynb) - upload a folder of `csvs` & `dataframes`
 6 | * [`shapefile_upload.ipynb`](/feature_layers/shapefile_upload.ipynb) - upload a folder of `Shapefiles`
 7 | * [`geojson_upload.ipynb`](/feature_layers/geojson_upload.ipynb) - upload a geojson file
 8 | * [`update_data.ipynb`](/feature_layers/update_data.ipynb) - a couple different workflows for updating uploaded / hosted data
 9 | * [`create_views.ipynb`](/feature_layers/create_views.ipynb) - create database views with separate permissions against one authoritative layer
10 | * [`manage_fields.ipynb`](/feature_layers/manage_fields.ipynb) - view and edit fields
11 | * [`manage_indexes.ipynb`](/feature_layers/manage_indexes.ipynb) - view, edit, and refresh indexes
12 | * [`enable_time.ipynb`](/feature_layers/enable_time.ipynb) - add time metadata that will be reflected in ArcGIS app UIs


--------------------------------------------------------------------------------
/feature_layers/create_views.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Create views\n",
  8 |     "\n",
  9 |     "Create new [view items](https://doc.arcgis.com/en/arcgis-online/manage-data/create-hosted-views.htm) from feature layer items. View items are akin to database views--they can have separate permissions and capabilities as well as limited access to a subset of the underlying data. This means you can maintain a single, authoritative layer while controlling how different groups of users can access and interact with that layer."
 10 |    ]
 11 |   },
 12 |   {
 13 |    "cell_type": "code",
 14 |    "execution_count": 1,
 15 |    "metadata": {},
 16 |    "outputs": [],
 17 |    "source": [
 18 |     "# common imports\n",
 19 |     "import os\n",
 20 |     "import pandas as pd\n",
 21 |     "from arcgis.gis import GIS\n",
 22 |     "from arcgis.features import FeatureLayerCollection, FeatureLayer"
 23 |    ]
 24 |   },
 25 |   {
 26 |    "cell_type": "markdown",
 27 |    "metadata": {},
 28 |    "source": [
 29 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`feature_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/feature_utils.py)"
 30 |    ]
 31 |   },
 32 |   {
 33 |    "cell_type": "code",
 34 |    "execution_count": 2,
 35 |    "metadata": {},
 36 |    "outputs": [],
 37 |    "source": [
 38 |     "from partnerutils.feature_utils import sdf_from_xyz"
 39 |    ]
 40 |   },
 41 |   {
 42 |    "cell_type": "markdown",
 43 |    "metadata": {},
 44 |    "source": [
 45 |     "**GIS**: Your GIS instance, parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/). Not specifying a password creates a password prompt"
 46 |    ]
 47 |   },
 48 |   {
 49 |    "cell_type": "code",
 50 |    "execution_count": 3,
 51 |    "metadata": {},
 52 |    "outputs": [
 53 |     {
 54 |      "name": "stdin",
 55 |      "output_type": "stream",
 56 |      "text": [
 57 |       "Enter password:  ········\n"
 58 |      ]
 59 |     }
 60 |    ],
 61 |    "source": [
 62 |     "gis = GIS(username=\"mpayson_startups\")"
 63 |    ]
 64 |   },
 65 |   {
 66 |    "cell_type": "markdown",
 67 |    "metadata": {},
 68 |    "source": [
 69 |     "### Create demo layer"
 70 |    ]
 71 |   },
 72 |   {
 73 |    "cell_type": "code",
 74 |    "execution_count": 11,
 75 |    "metadata": {},
 76 |    "outputs": [
 77 |     {
 78 |      "data": {
 79 |       "text/html": [
 80 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
 81 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
 82 |        "                       <a href='https://Startups.maps.arcgis.com/home/item.html?id=95b19b84cf6e461d8d0bba3dff357f1b' target='_blank'>\n",
 83 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
 84 |        "                       </a>\n",
 85 |        "                    </div>\n",
 86 |        "\n",
 87 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
 88 |        "                        <a href='https://Startups.maps.arcgis.com/home/item.html?id=95b19b84cf6e461d8d0bba3dff357f1b' target='_blank'><b>Base demo layer</b>\n",
 89 |        "                        </a>\n",
 90 |        "                        <br/><img src='https://Startups.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/featureshosted16.png' style=\"vertical-align:middle;\">Feature Layer Collection by mpayson_startups\n",
 91 |        "                        <br/>Last Modified: November 06, 2019\n",
 92 |        "                        <br/>0 comments, 0 views\n",
 93 |        "                    </div>\n",
 94 |        "                </div>\n",
 95 |        "                "
 96 |       ],
 97 |       "text/plain": [
 98 |        "<Item title:\"Base demo layer\" type:Feature Layer Collection owner:mpayson_startups>"
 99 |       ]
100 |      },
101 |      "execution_count": 11,
102 |      "metadata": {},
103 |      "output_type": "execute_result"
104 |     }
105 |    ],
106 |    "source": [
107 |     "df = pd.read_csv('../sample_data/NYC_Restaurant_Inspections.csv', encoding='utf-8')\n",
108 |     "sdf = sdf_from_xyz(df, 'Longitude', 'Latitude')\n",
109 |     "lyr_item = sdf.spatial.to_featurelayer(\n",
110 |     "    'Base demo layer',\n",
111 |     "    tags=\"esri_partner_tools_sample\"\n",
112 |     ")\n",
113 |     "lyr_item"
114 |    ]
115 |   },
116 |   {
117 |    "cell_type": "markdown",
118 |    "metadata": {},
119 |    "source": [
120 |     "## Execution"
121 |    ]
122 |   },
123 |   {
124 |    "cell_type": "markdown",
125 |    "metadata": {},
126 |    "source": [
127 |     "### Create view item - [doc](https://developers.arcgis.com/python/api-reference/arcgis.features.managers.html?highlight=create_view#arcgis.features.managers.FeatureLayerCollectionManager.create_view)"
128 |    ]
129 |   },
130 |   {
131 |    "cell_type": "code",
132 |    "execution_count": 12,
133 |    "metadata": {},
134 |    "outputs": [
135 |     {
136 |      "data": {
137 |       "text/html": [
138 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
139 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
140 |        "                       <a href='https://Startups.maps.arcgis.com/home/item.html?id=5ccdefe187544ba0a99586ea10eff39d' target='_blank'>\n",
141 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
142 |        "                       </a>\n",
143 |        "                    </div>\n",
144 |        "\n",
145 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
146 |        "                        <a href='https://Startups.maps.arcgis.com/home/item.html?id=5ccdefe187544ba0a99586ea10eff39d' target='_blank'><b>Base demo view</b>\n",
147 |        "                        </a>\n",
148 |        "                        <br/><img src='https://Startups.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/featureshosted16.png' style=\"vertical-align:middle;\">Feature Layer Collection by mpayson_startups\n",
149 |        "                        <br/>Last Modified: November 06, 2019\n",
150 |        "                        <br/>0 comments, 0 views\n",
151 |        "                    </div>\n",
152 |        "                </div>\n",
153 |        "                "
154 |       ],
155 |       "text/plain": [
156 |        "<Item title:\"Base demo view\" type:Feature Layer Collection owner:mpayson_startups>"
157 |       ]
158 |      },
159 |      "execution_count": 12,
160 |      "metadata": {},
161 |      "output_type": "execute_result"
162 |     }
163 |    ],
164 |    "source": [
165 |     "# A feature service can have many layers, so a FeatureLayerCollection represents\n",
166 |     "# the underlying service. Often, like through the Python API, newly created layers\n",
167 |     "# create new services as well. So the desired layer is the first layer in the service.\n",
168 |     "flc = FeatureLayerCollection.fromitem(lyr_item)\n",
169 |     "view_item = flc.manager.create_view('Base demo view')\n",
170 |     "view_item.update(item_properties={'tags': 'esri_partner_tools_sample'})\n",
171 |     "view_item"
172 |    ]
173 |   },
174 |   {
175 |    "cell_type": "code",
176 |    "execution_count": 6,
177 |    "metadata": {},
178 |    "outputs": [
179 |     {
180 |      "name": "stdout",
181 |      "output_type": "stream",
182 |      "text": [
183 |       "# features: 5000, # fields: 27\n"
184 |      ]
185 |     }
186 |    ],
187 |    "source": [
188 |     "view_lyr = view_item.layers[0]\n",
189 |     "\n",
190 |     "# create a reference sdf so we can compare what data is available in the view\n",
191 |     "def print_reference(ref_view_lyr):\n",
192 |     "    ref_sdf = ref_view_lyr.query().sdf\n",
193 |     "    print(\"# features: {}, # fields: {}\".format(len(ref_sdf), len(ref_sdf.columns)))\n",
194 |     "\n",
195 |     "print_reference(view_lyr)"
196 |    ]
197 |   },
198 |   {
199 |    "cell_type": "markdown",
200 |    "metadata": {},
201 |    "source": [
202 |     "### Update visible data in view"
203 |    ]
204 |   },
205 |   {
206 |    "cell_type": "markdown",
207 |    "metadata": {},
208 |    "source": [
209 |     "#### Fields\n",
210 |     "Update visible fields--note, objectIdField must be visible"
211 |    ]
212 |   },
213 |   {
214 |    "cell_type": "code",
215 |    "execution_count": 7,
216 |    "metadata": {},
217 |    "outputs": [
218 |     {
219 |      "name": "stdout",
220 |      "output_type": "stream",
221 |      "text": [
222 |       "# features: 5000, # fields: 5\n"
223 |      ]
224 |     }
225 |    ],
226 |    "source": [
227 |     "keep_field_names = {'GRADE', 'VIOLATION_', 'SCORE'}\n",
228 |     "keep_field_names.add(view_lyr.properties.objectIdField)\n",
229 |     "fields = list(map(\n",
230 |     "    lambda f: {\n",
231 |     "        'name': f.name,\n",
232 |     "        'visible': True if f.name in keep_field_names else False\n",
233 |     "    },\n",
234 |     "    view_lyr.properties.fields\n",
235 |     "))\n",
236 |     "view_lyr.manager.update_definition({\"fields\": fields})\n",
237 |     "\n",
238 |     "print_reference(view_lyr)"
239 |    ]
240 |   },
241 |   {
242 |    "cell_type": "markdown",
243 |    "metadata": {},
244 |    "source": [
245 |     "#### Features by attribute\n",
246 |     "Update visible rows based on attribute [SQL where clause](https://pro.arcgis.com/en/pro-app/help/mapping/navigation/sql-reference-for-elements-used-in-query-expressions.htm)"
247 |    ]
248 |   },
249 |   {
250 |    "cell_type": "code",
251 |    "execution_count": 8,
252 |    "metadata": {},
253 |    "outputs": [
254 |     {
255 |      "name": "stdout",
256 |      "output_type": "stream",
257 |      "text": [
258 |       "# features: 3955, # fields: 5\n"
259 |      ]
260 |     }
261 |    ],
262 |    "source": [
263 |     "where = \"GRADE = 'A'\"\n",
264 |     "view_lyr.manager.update_definition({\"viewDefinitionQuery\": where})\n",
265 |     "\n",
266 |     "print_reference(view_lyr)"
267 |    ]
268 |   },
269 |   {
270 |    "cell_type": "markdown",
271 |    "metadata": {},
272 |    "source": [
273 |     "#### Features by geometry\n",
274 |     "Update visible rows based on a geography. A couple notes, can pass in a JSON representation of an [envelope](https://developers.arcgis.com/python/api-reference/arcgis.geometry.html#envelope) or [polygon](https://developers.arcgis.com/python/api-reference/arcgis.geometry.html#polygon). There's probably overhead to arbitray or complex polygons compared to envelopes. Also, the geometry coordinates should be specified in the same coordinate reference system as the map, this is often WebMercator (`wkid #102100`)."
275 |    ]
276 |   },
277 |   {
278 |    "cell_type": "code",
279 |    "execution_count": 13,
280 |    "metadata": {},
281 |    "outputs": [
282 |     {
283 |      "name": "stdout",
284 |      "output_type": "stream",
285 |      "text": [
286 |       "# features: 1917, # fields: 27\n"
287 |      ]
288 |     }
289 |    ],
290 |    "source": [
291 |     "# Get Manhattan geometry, this is on the complex side. Data pulled from Hub\n",
292 |     "# https://hub.arcgis.com/datasets/498c7ff03780407494301c23cb59b899_0\n",
293 |     "buro_lyr = FeatureLayer('https://services1.arcgis.com/oOUgp466Coyjcu6V/arcgis/rest/services/NYC_Boroughs/FeatureServer/0')\n",
294 |     "buro_fs = buro_lyr.query(out_sr=102100)\n",
295 |     "manhattan_feature = list(filter(\n",
296 |     "    lambda f: f.attributes['boro_name'] == 'Manhattan',\n",
297 |     "    buro_fs.features\n",
298 |     "))[0]\n",
299 |     "manhattan_geom = manhattan_feature.geometry\n",
300 |     "manhattan_geom['spatialReference'] = buro_fs.spatial_reference\n",
301 |     "\n",
302 |     "geo_definition = {\n",
303 |     "    \"filter\": {\n",
304 |     "        \"operator\": \"esriSpatialRelIntersects\",\n",
305 |     "        \"value\": {\n",
306 |     "            \"geometryType\": buro_fs.geometry_type,\n",
307 |     "            \"geometry\": manhattan_geom\n",
308 |     "        }\n",
309 |     "    }\n",
310 |     "}\n",
311 |     "view_lyr.manager.update_definition({\"viewLayerDefinition\": geo_definition})\n",
312 |     "\n",
313 |     "print_reference(view_lyr)"
314 |    ]
315 |   },
316 |   {
317 |    "cell_type": "markdown",
318 |    "metadata": {},
319 |    "source": [
320 |     "## Clean up"
321 |    ]
322 |   },
323 |   {
324 |    "cell_type": "code",
325 |    "execution_count": 10,
326 |    "metadata": {},
327 |    "outputs": [
328 |     {
329 |      "data": {
330 |       "text/plain": [
331 |        "True"
332 |       ]
333 |      },
334 |      "execution_count": 10,
335 |      "metadata": {},
336 |      "output_type": "execute_result"
337 |     }
338 |    ],
339 |    "source": [
340 |     "delete_items = gis.content.search(\"tags:esri_partner_tools_sample\")\n",
341 |     "gis.content.delete_items(delete_items)"
342 |    ]
343 |   }
344 |  ],
345 |  "metadata": {
346 |   "kernelspec": {
347 |    "display_name": "Python 3",
348 |    "language": "python",
349 |    "name": "python3"
350 |   },
351 |   "language_info": {
352 |    "codemirror_mode": {
353 |     "name": "ipython",
354 |     "version": 3
355 |    },
356 |    "file_extension": ".py",
357 |    "mimetype": "text/x-python",
358 |    "name": "python",
359 |    "nbconvert_exporter": "python",
360 |    "pygments_lexer": "ipython3",
361 |    "version": "3.7.4"
362 |   }
363 |  },
364 |  "nbformat": 4,
365 |  "nbformat_minor": 4
366 | }
367 | 


--------------------------------------------------------------------------------
/feature_layers/csv_upload.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Bulk CSV Upload\n",
  8 |     "A notebook to read csvs and upload their data as [hosted feature layers](https://doc.arcgis.com/en/arcgis-online/share-maps/hosted-web-layers.htm) in ArcGIS"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": 1,
 14 |    "metadata": {},
 15 |    "outputs": [],
 16 |    "source": [
 17 |     "# common imports\n",
 18 |     "import os\n",
 19 |     "import pandas as pd\n",
 20 |     "from arcgis.gis import GIS"
 21 |    ]
 22 |   },
 23 |   {
 24 |    "cell_type": "markdown",
 25 |    "metadata": {},
 26 |    "source": [
 27 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`feature_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/feature_utils.py)"
 28 |    ]
 29 |   },
 30 |   {
 31 |    "cell_type": "code",
 32 |    "execution_count": 2,
 33 |    "metadata": {},
 34 |    "outputs": [],
 35 |    "source": [
 36 |     "from partnerutils.feature_utils import sdf_from_xyz"
 37 |    ]
 38 |   },
 39 |   {
 40 |    "cell_type": "markdown",
 41 |    "metadata": {},
 42 |    "source": [
 43 |     "## User Input\n",
 44 |     "\n",
 45 |     "* **gis**: your GIS instance, parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/)\n",
 46 |     "* **dir_path**: path to directory with the CSVs\n",
 47 |     "* **coord_fields**: map Point fields to CSV columns"
 48 |    ]
 49 |   },
 50 |   {
 51 |    "cell_type": "code",
 52 |    "execution_count": 4,
 53 |    "metadata": {},
 54 |    "outputs": [
 55 |     {
 56 |      "name": "stdin",
 57 |      "output_type": "stream",
 58 |      "text": [
 59 |       "Enter password:  ········\n"
 60 |      ]
 61 |     }
 62 |    ],
 63 |    "source": [
 64 |     "# this will prompt for a password\n",
 65 |     "# can also do GIS(\"https://www.arcgis.com\", \"<USERNAME>\", \"<PASSWORD>\")\n",
 66 |     "gis = GIS(username=\"mpayson_startups\")"
 67 |    ]
 68 |   },
 69 |   {
 70 |    "cell_type": "code",
 71 |    "execution_count": 5,
 72 |    "metadata": {},
 73 |    "outputs": [],
 74 |    "source": [
 75 |     "dir_path = \"../sample_data\"\n",
 76 |     "coord_fields = {\n",
 77 |     "    \"x\": \"Longitude\",\n",
 78 |     "    \"y\": \"Latitude\",\n",
 79 |     "    #\"z\": \"<Z COLUMN (optional)>\"\n",
 80 |     "}"
 81 |    ]
 82 |   },
 83 |   {
 84 |    "cell_type": "markdown",
 85 |    "metadata": {},
 86 |    "source": [
 87 |     "## Execution"
 88 |    ]
 89 |   },
 90 |   {
 91 |    "cell_type": "code",
 92 |    "execution_count": 6,
 93 |    "metadata": {},
 94 |    "outputs": [],
 95 |    "source": [
 96 |     "# create a new folder in the GIS to store the layers\n",
 97 |     "folder = os.path.basename(dir_path)\n",
 98 |     "gis_folder = gis.content.create_folder(folder)\n",
 99 |     "\n",
100 |     "# handle folder already exists\n",
101 |     "gis_folder = folder if gis_folder is None else gis_folder"
102 |    ]
103 |   },
104 |   {
105 |    "cell_type": "code",
106 |    "execution_count": 7,
107 |    "metadata": {},
108 |    "outputs": [
109 |     {
110 |      "name": "stdout",
111 |      "output_type": "stream",
112 |      "text": [
113 |       "Pushing 1 csvs\n"
114 |      ]
115 |     }
116 |    ],
117 |    "source": [
118 |     "# get an array of all the csvs in the directory\n",
119 |     "csvs = [file for file in os.listdir(dir_path) if file.endswith('.csv')]\n",
120 |     "csv_paths = [os.path.join(dir_path, csv) for csv in csvs]\n",
121 |     "n_paths = len(csv_paths)\n",
122 |     "print(\"Pushing {0} csvs\".format(n_paths))"
123 |    ]
124 |   },
125 |   {
126 |    "cell_type": "code",
127 |    "execution_count": 8,
128 |    "metadata": {},
129 |    "outputs": [
130 |     {
131 |      "name": "stdout",
132 |      "output_type": "stream",
133 |      "text": [
134 |       "1/1\n"
135 |      ]
136 |     }
137 |    ],
138 |    "source": [
139 |     "# loop through csvs, build spatial dataframe, upload layers to GIS, move to new folder\n",
140 |     "z_field = coord_fields['z'] if 'z' in coord_fields else None\n",
141 |     "items = []\n",
142 |     "for i, csv_path in enumerate(csv_paths):\n",
143 |     "    df = pd.read_csv(csv_path)\n",
144 |     "    sdf = sdf_from_xyz(df, coord_fields['x'], coord_fields['y'], z_field)\n",
145 |     "    \n",
146 |     "    title = os.path.splitext(os.path.basename(csv_path))[0]\n",
147 |     "    lyr_item = gis.content.import_data(sdf, title=title, tags=\"esri_partner_tools_sample\")\n",
148 |     "    lyr_item.move(gis_folder)\n",
149 |     "    \n",
150 |     "    items.append(lyr_item)\n",
151 |     "    print(\"{0}/{1}\".format(i + 1, n_paths))"
152 |    ]
153 |   },
154 |   {
155 |    "cell_type": "markdown",
156 |    "metadata": {},
157 |    "source": [
158 |     "## Clean Up"
159 |    ]
160 |   },
161 |   {
162 |    "cell_type": "code",
163 |    "execution_count": 15,
164 |    "metadata": {},
165 |    "outputs": [
166 |     {
167 |      "data": {
168 |       "text/plain": [
169 |        "True"
170 |       ]
171 |      },
172 |      "execution_count": 15,
173 |      "metadata": {},
174 |      "output_type": "execute_result"
175 |     }
176 |    ],
177 |    "source": [
178 |     "delete_items = gis.content.search(\"tags:esri_partner_tools_sample\")\n",
179 |     "gis.content.delete_items(delete_items)\n",
180 |     "gis.content.delete_folder(gis_folder['title'])"
181 |    ]
182 |   }
183 |  ],
184 |  "metadata": {
185 |   "kernelspec": {
186 |    "display_name": "Python 3",
187 |    "language": "python",
188 |    "name": "python3"
189 |   },
190 |   "language_info": {
191 |    "codemirror_mode": {
192 |     "name": "ipython",
193 |     "version": 3
194 |    },
195 |    "file_extension": ".py",
196 |    "mimetype": "text/x-python",
197 |    "name": "python",
198 |    "nbconvert_exporter": "python",
199 |    "pygments_lexer": "ipython3",
200 |    "version": "3.7.3"
201 |   }
202 |  },
203 |  "nbformat": 4,
204 |  "nbformat_minor": 4
205 | }
206 | 


--------------------------------------------------------------------------------
/feature_layers/enable_time.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Enable time\n",
  8 |     "ArcGIS allows you to [enable time on feature layers](https://doc.arcgis.com/en/arcgis-online/create-maps/configure-time.htm). This does a couple of things -- to the user, it will make time sliders and other UI components automatically show up in ArcGIS clients to respect the time settings of the layer. To the service, it will add time metadata (start / end) as well as an index to speed up time-based queries.\n",
  9 |     "\n",
 10 |     "This is a simple Python script to show doing this automatically. To update the metadata (eg when the underlying data changes), rerun the same process on the existing layer."
 11 |    ]
 12 |   },
 13 |   {
 14 |    "cell_type": "code",
 15 |    "execution_count": 1,
 16 |    "metadata": {},
 17 |    "outputs": [],
 18 |    "source": [
 19 |     "from arcgis.gis import GIS\n",
 20 |     "from arcgis.features import FeatureLayer"
 21 |    ]
 22 |   },
 23 |   {
 24 |    "cell_type": "markdown",
 25 |    "metadata": {},
 26 |    "source": [
 27 |     "## Variables\n",
 28 |     "* **gis**: your GIS instance, parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/)\n",
 29 |     "* **file_path**: the path to the GeoJSON file used to create a demo layer\n",
 30 |     "* **time_field**: the field representing time for a given feature / record"
 31 |    ]
 32 |   },
 33 |   {
 34 |    "cell_type": "code",
 35 |    "execution_count": 2,
 36 |    "metadata": {},
 37 |    "outputs": [
 38 |     {
 39 |      "name": "stdin",
 40 |      "output_type": "stream",
 41 |      "text": [
 42 |       "Enter password:  ········\n"
 43 |      ]
 44 |     }
 45 |    ],
 46 |    "source": [
 47 |     "gis = GIS(username=\"mpayson_geodev\")"
 48 |    ]
 49 |   },
 50 |   {
 51 |    "cell_type": "code",
 52 |    "execution_count": 3,
 53 |    "metadata": {},
 54 |    "outputs": [],
 55 |    "source": [
 56 |     "file_path = \"../sample_data/NYC_Restaurant_Inspections.geojson\"\n",
 57 |     "time_field = \"RECORD_DAT\""
 58 |    ]
 59 |   },
 60 |   {
 61 |    "cell_type": "markdown",
 62 |    "metadata": {},
 63 |    "source": [
 64 |     "## Initialization"
 65 |    ]
 66 |   },
 67 |   {
 68 |    "cell_type": "code",
 69 |    "execution_count": 4,
 70 |    "metadata": {},
 71 |    "outputs": [
 72 |     {
 73 |      "data": {
 74 |       "text/plain": [
 75 |        "<FeatureLayer url:\"https://services9.arcgis.com/ZfotufAA0t3yWBiW/arcgis/rest/services/My_GeoJSON/FeatureServer/0\">"
 76 |       ]
 77 |      },
 78 |      "execution_count": 4,
 79 |      "metadata": {},
 80 |      "output_type": "execute_result"
 81 |     }
 82 |    ],
 83 |    "source": [
 84 |     "# publish a new layer item for demo purposes\n",
 85 |     "item = gis.content.add({\n",
 86 |     "    \"type\": \"GeoJson\",\n",
 87 |     "    \"title\": \"My GeoJSON\",\n",
 88 |     "    \"tags\": \"esri_partner_tools_sample\"\n",
 89 |     "}, data='../sample_data/NYC_Restaurant_Inspections.geojson')\n",
 90 |     "lyr_item = item.publish()\n",
 91 |     "\n",
 92 |     "# get a reference to the feature layer\n",
 93 |     "lyr = FeatureLayer.fromitem(lyr_item)\n",
 94 |     "lyr"
 95 |    ]
 96 |   },
 97 |   {
 98 |    "cell_type": "markdown",
 99 |    "metadata": {},
100 |    "source": [
101 |     "### Enable time! This is the important part"
102 |    ]
103 |   },
104 |   {
105 |    "cell_type": "code",
106 |    "execution_count": 5,
107 |    "metadata": {},
108 |    "outputs": [
109 |     {
110 |      "data": {
111 |       "text/plain": [
112 |        "{'success': True}"
113 |       ]
114 |      },
115 |      "execution_count": 5,
116 |      "metadata": {},
117 |      "output_type": "execute_result"
118 |     }
119 |    ],
120 |    "source": [
121 |     "update_dict = {\n",
122 |     "    \"timeInfo\": {\n",
123 |     "        \"startTimeField\": time_field,\n",
124 |     "        # use to represent a time range, not single event\n",
125 |     "        # \"endTimeField\": end_field\n",
126 |     "    }\n",
127 |     "}\n",
128 |     "lyr.manager.add_to_definition(update_dict)"
129 |    ]
130 |   },
131 |   {
132 |    "cell_type": "markdown",
133 |    "metadata": {},
134 |    "source": [
135 |     "## Clean Up"
136 |    ]
137 |   },
138 |   {
139 |    "cell_type": "code",
140 |    "execution_count": 6,
141 |    "metadata": {},
142 |    "outputs": [
143 |     {
144 |      "data": {
145 |       "text/plain": [
146 |        "True"
147 |       ]
148 |      },
149 |      "execution_count": 6,
150 |      "metadata": {},
151 |      "output_type": "execute_result"
152 |     }
153 |    ],
154 |    "source": [
155 |     "delete_items = gis.content.search(\"tags:esri_partner_tools_sample\")\n",
156 |     "gis.content.delete_items(delete_items)"
157 |    ]
158 |   },
159 |   {
160 |    "cell_type": "code",
161 |    "execution_count": null,
162 |    "metadata": {},
163 |    "outputs": [],
164 |    "source": []
165 |   }
166 |  ],
167 |  "metadata": {
168 |   "kernelspec": {
169 |    "display_name": "Python 3",
170 |    "language": "python",
171 |    "name": "python3"
172 |   },
173 |   "language_info": {
174 |    "codemirror_mode": {
175 |     "name": "ipython",
176 |     "version": 3
177 |    },
178 |    "file_extension": ".py",
179 |    "mimetype": "text/x-python",
180 |    "name": "python",
181 |    "nbconvert_exporter": "python",
182 |    "pygments_lexer": "ipython3",
183 |    "version": "3.8.5"
184 |   }
185 |  },
186 |  "nbformat": 4,
187 |  "nbformat_minor": 4
188 | }
189 | 


--------------------------------------------------------------------------------
/feature_layers/geojson_upload.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# GeoJSON Upload\n",
  8 |     "A notebook to read GeoJSON and upload the data as a [hosted feature layer](https://doc.arcgis.com/en/arcgis-online/share-maps/hosted-web-layers.htm) in ArcGIS"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": 1,
 14 |    "metadata": {},
 15 |    "outputs": [],
 16 |    "source": [
 17 |     "from arcgis.gis import GIS"
 18 |    ]
 19 |   },
 20 |   {
 21 |    "cell_type": "markdown",
 22 |    "metadata": {},
 23 |    "source": [
 24 |     "## User Input"
 25 |    ]
 26 |   },
 27 |   {
 28 |    "cell_type": "markdown",
 29 |    "metadata": {},
 30 |    "source": [
 31 |     "**gis**: your GIS instance, parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/)"
 32 |    ]
 33 |   },
 34 |   {
 35 |    "cell_type": "code",
 36 |    "execution_count": 2,
 37 |    "metadata": {},
 38 |    "outputs": [
 39 |     {
 40 |      "name": "stdin",
 41 |      "output_type": "stream",
 42 |      "text": [
 43 |       "Enter password:  ········\n"
 44 |      ]
 45 |     }
 46 |    ],
 47 |    "source": [
 48 |     "gis = GIS(username=\"mpayson_geodev\")"
 49 |    ]
 50 |   },
 51 |   {
 52 |    "cell_type": "markdown",
 53 |    "metadata": {},
 54 |    "source": [
 55 |     "**file_path**: path to GeoJSON file, could also fetch from a remote API and write a temporary file"
 56 |    ]
 57 |   },
 58 |   {
 59 |    "cell_type": "code",
 60 |    "execution_count": 3,
 61 |    "metadata": {},
 62 |    "outputs": [],
 63 |    "source": [
 64 |     "file_path = \"../sample_data/NYC_Restaurant_Inspections.geojson\""
 65 |    ]
 66 |   },
 67 |   {
 68 |    "cell_type": "markdown",
 69 |    "metadata": {},
 70 |    "source": [
 71 |     "## Execution"
 72 |    ]
 73 |   },
 74 |   {
 75 |    "cell_type": "code",
 76 |    "execution_count": 5,
 77 |    "metadata": {},
 78 |    "outputs": [
 79 |     {
 80 |      "data": {
 81 |       "text/html": [
 82 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
 83 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
 84 |        "                       <a href='https://mpayson-geodev.maps.arcgis.com/home/item.html?id=0c16a40df33d415db2b05aca19e02b6d' target='_blank'>\n",
 85 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
 86 |        "                       </a>\n",
 87 |        "                    </div>\n",
 88 |        "\n",
 89 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
 90 |        "                        <a href='https://mpayson-geodev.maps.arcgis.com/home/item.html?id=0c16a40df33d415db2b05aca19e02b6d' target='_blank'><b>My GeoJSON</b>\n",
 91 |        "                        </a>\n",
 92 |        "                        <br/><img src='https://mpayson-geodev.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/layers16.png' style=\"vertical-align:middle;\">GeoJson by mpayson_geodev\n",
 93 |        "                        <br/>Last Modified: July 06, 2020\n",
 94 |        "                        <br/>0 comments, 0 views\n",
 95 |        "                    </div>\n",
 96 |        "                </div>\n",
 97 |        "                "
 98 |       ],
 99 |       "text/plain": [
100 |        "<Item title:\"My GeoJSON\" type:GeoJson owner:mpayson_geodev>"
101 |       ]
102 |      },
103 |      "execution_count": 5,
104 |      "metadata": {},
105 |      "output_type": "execute_result"
106 |     }
107 |    ],
108 |    "source": [
109 |     "# create the item, this will just add the file to ArcGIS Online\n",
110 |     "item = gis.content.add({\n",
111 |     "    \"type\": \"GeoJson\",\n",
112 |     "    \"title\": \"My GeoJSON\",\n",
113 |     "    \"tags\": \"esri_partner_tools_sample\"\n",
114 |     "}, data='../sample_data/NYC_Restaurant_Inspections.geojson')\n",
115 |     "item"
116 |    ]
117 |   },
118 |   {
119 |    "cell_type": "code",
120 |    "execution_count": 6,
121 |    "metadata": {},
122 |    "outputs": [
123 |     {
124 |      "data": {
125 |       "text/html": [
126 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
127 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
128 |        "                       <a href='https://mpayson-geodev.maps.arcgis.com/home/item.html?id=40c587089bd4459cbe99f820f29c8312' target='_blank'>\n",
129 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
130 |        "                       </a>\n",
131 |        "                    </div>\n",
132 |        "\n",
133 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
134 |        "                        <a href='https://mpayson-geodev.maps.arcgis.com/home/item.html?id=40c587089bd4459cbe99f820f29c8312' target='_blank'><b>My GeoJSON</b>\n",
135 |        "                        </a>\n",
136 |        "                        <br/><img src='https://mpayson-geodev.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/featureshosted16.png' style=\"vertical-align:middle;\">Feature Layer Collection by mpayson_geodev\n",
137 |        "                        <br/>Last Modified: July 06, 2020\n",
138 |        "                        <br/>0 comments, 0 views\n",
139 |        "                    </div>\n",
140 |        "                </div>\n",
141 |        "                "
142 |       ],
143 |       "text/plain": [
144 |        "<Item title:\"My GeoJSON\" type:Feature Layer Collection owner:mpayson_geodev>"
145 |       ]
146 |      },
147 |      "execution_count": 6,
148 |      "metadata": {},
149 |      "output_type": "execute_result"
150 |     }
151 |    ],
152 |    "source": [
153 |     "# publish the item, this will make the item available as a hosted service\n",
154 |     "lyr_item = item.publish()\n",
155 |     "lyr_item"
156 |    ]
157 |   },
158 |   {
159 |    "cell_type": "markdown",
160 |    "metadata": {},
161 |    "source": [
162 |     "## Clean Up"
163 |    ]
164 |   },
165 |   {
166 |    "cell_type": "code",
167 |    "execution_count": 7,
168 |    "metadata": {},
169 |    "outputs": [
170 |     {
171 |      "data": {
172 |       "text/plain": [
173 |        "True"
174 |       ]
175 |      },
176 |      "execution_count": 7,
177 |      "metadata": {},
178 |      "output_type": "execute_result"
179 |     }
180 |    ],
181 |    "source": [
182 |     "delete_items = gis.content.search(\"tags:esri_partner_tools_sample\")\n",
183 |     "gis.content.delete_items(delete_items)"
184 |    ]
185 |   },
186 |   {
187 |    "cell_type": "code",
188 |    "execution_count": null,
189 |    "metadata": {},
190 |    "outputs": [],
191 |    "source": []
192 |   }
193 |  ],
194 |  "metadata": {
195 |   "kernelspec": {
196 |    "display_name": "Python 3",
197 |    "language": "python",
198 |    "name": "python3"
199 |   },
200 |   "language_info": {
201 |    "codemirror_mode": {
202 |     "name": "ipython",
203 |     "version": 3
204 |    },
205 |    "file_extension": ".py",
206 |    "mimetype": "text/x-python",
207 |    "name": "python",
208 |    "nbconvert_exporter": "python",
209 |    "pygments_lexer": "ipython3",
210 |    "version": "3.8.5"
211 |   }
212 |  },
213 |  "nbformat": 4,
214 |  "nbformat_minor": 4
215 | }
216 | 


--------------------------------------------------------------------------------
/feature_layers/manage_fields.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Manage Fields\n",
  8 |     "[Feature Layer](http://esri.github.io/arcgis-python-api/apidoc/html/arcgis.features.toc.html#featurelayer) || [the Manager](http://esri.github.io/arcgis-python-api/apidoc/html/arcgis.features.managers.html?highlight=manager#featurelayermanager) || [About field types](http://pro.arcgis.com/en/pro-app/tool-reference/data-management/add-field.htm) || [Rest endpoint](http://resources.arcgis.com/en/help/arcgis-rest-api/#/Add_to_Definition_Feature_Layer/02r300000228000000/)"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": null,
 14 |    "metadata": {},
 15 |    "outputs": [],
 16 |    "source": [
 17 |     "from arcgis.gis import GIS\n",
 18 |     "from arcgis.features import FeatureLayer"
 19 |    ]
 20 |   },
 21 |   {
 22 |    "cell_type": "code",
 23 |    "execution_count": null,
 24 |    "metadata": {},
 25 |    "outputs": [],
 26 |    "source": [
 27 |     "gis = GIS(username=\"mpayson_startups\")"
 28 |    ]
 29 |   },
 30 |   {
 31 |    "cell_type": "markdown",
 32 |    "metadata": {},
 33 |    "source": [
 34 |     "### Initialization"
 35 |    ]
 36 |   },
 37 |   {
 38 |    "cell_type": "code",
 39 |    "execution_count": null,
 40 |    "metadata": {},
 41 |    "outputs": [],
 42 |    "source": [
 43 |     "# create the feature layer in ArcGIS Online from a geojson file\n",
 44 |     "item = gis.content.add({\n",
 45 |     "    \"type\": \"GeoJson\",\n",
 46 |     "    \"title\": \"My GeoJSON\",\n",
 47 |     "    \"tags\": \"esri_partner_tools_sample\"\n",
 48 |     "}, data='../sample_data/NYC_Restaurant_Inspections.geojson')\n",
 49 |     "lyr_item = item.publish()\n",
 50 |     "\n",
 51 |     "# define the feature layer\n",
 52 |     "lyr = FeatureLayer.fromitem(lyr_item)\n",
 53 |     "lyr"
 54 |    ]
 55 |   },
 56 |   {
 57 |    "cell_type": "markdown",
 58 |    "metadata": {},
 59 |    "source": [
 60 |     "## Existing fields"
 61 |    ]
 62 |   },
 63 |   {
 64 |    "cell_type": "code",
 65 |    "execution_count": null,
 66 |    "metadata": {},
 67 |    "outputs": [],
 68 |    "source": [
 69 |     "lyr.properties.fields"
 70 |    ]
 71 |   },
 72 |   {
 73 |    "cell_type": "markdown",
 74 |    "metadata": {},
 75 |    "source": [
 76 |     "## Change field display name"
 77 |    ]
 78 |   },
 79 |   {
 80 |    "cell_type": "code",
 81 |    "execution_count": null,
 82 |    "metadata": {},
 83 |    "outputs": [],
 84 |    "source": [
 85 |     "update_dict = {\"fields\": dict(lyr.properties)['fields']} "
 86 |    ]
 87 |   },
 88 |   {
 89 |    "cell_type": "code",
 90 |    "execution_count": null,
 91 |    "metadata": {},
 92 |    "outputs": [],
 93 |    "source": [
 94 |     "names_to_change = {\"PHONE\": \"Phone Number\"}"
 95 |    ]
 96 |   },
 97 |   {
 98 |    "cell_type": "code",
 99 |    "execution_count": null,
100 |    "metadata": {},
101 |    "outputs": [],
102 |    "source": [
103 |     "for val in update_dict['fields']:\n",
104 |     "    if val['name'] in names_to_change:\n",
105 |     "        val['alias'] = names_to_change[val['name']]"
106 |    ]
107 |   },
108 |   {
109 |    "cell_type": "code",
110 |    "execution_count": null,
111 |    "metadata": {},
112 |    "outputs": [],
113 |    "source": [
114 |     "lyr.manager.update_definition(update_dict)"
115 |    ]
116 |   },
117 |   {
118 |    "cell_type": "markdown",
119 |    "metadata": {},
120 |    "source": [
121 |     "## Change field description"
122 |    ]
123 |   },
124 |   {
125 |    "cell_type": "code",
126 |    "execution_count": null,
127 |    "metadata": {},
128 |    "outputs": [],
129 |    "source": [
130 |     "update_dict = {\"fields\": dict(lyr.properties)['fields']} "
131 |    ]
132 |   },
133 |   {
134 |    "cell_type": "code",
135 |    "execution_count": null,
136 |    "metadata": {},
137 |    "outputs": [],
138 |    "source": [
139 |     "desc_to_change = {\"PHONE\": \"This field represents phone numbers\"}\n",
140 |     "for val in update_dict['fields']:\n",
141 |     "    if val['name'] in desc_to_change:\n",
142 |     "        val['']"
143 |    ]
144 |   },
145 |   {
146 |    "cell_type": "markdown",
147 |    "metadata": {},
148 |    "source": [
149 |     "## Add field"
150 |    ]
151 |   },
152 |   {
153 |    "cell_type": "code",
154 |    "execution_count": null,
155 |    "metadata": {},
156 |    "outputs": [],
157 |    "source": [
158 |     "new_field = {\n",
159 |     "    \"name\": \"TEST_STR_FIELD\",\n",
160 |     "    \"type\": \"esriFieldTypeString\",\n",
161 |     "    \"alias\": \"TEST_STR_FIELD\",\n",
162 |     "    \"length\": 256,\n",
163 |     "    \"nullable\": True,\n",
164 |     "    \"editable\": True,\n",
165 |     "    \"visible\": True,\n",
166 |     "    \"domain\": None\n",
167 |     "}\n",
168 |     "update_dict = {\"fields\": [new_field]}"
169 |    ]
170 |   },
171 |   {
172 |    "cell_type": "code",
173 |    "execution_count": null,
174 |    "metadata": {},
175 |    "outputs": [],
176 |    "source": [
177 |     "lyr.manager.add_to_definition(update_dict)"
178 |    ]
179 |   },
180 |   {
181 |    "cell_type": "markdown",
182 |    "metadata": {},
183 |    "source": [
184 |     "## Clean Up"
185 |    ]
186 |   },
187 |   {
188 |    "cell_type": "code",
189 |    "execution_count": null,
190 |    "metadata": {},
191 |    "outputs": [],
192 |    "source": [
193 |     "delete_items = gis.content.search(\"tags:esri_partner_tools_sample\")\n",
194 |     "gis.content.delete_items(delete_items)"
195 |    ]
196 |   },
197 |   {
198 |    "cell_type": "code",
199 |    "execution_count": null,
200 |    "metadata": {},
201 |    "outputs": [],
202 |    "source": []
203 |   }
204 |  ],
205 |  "metadata": {
206 |   "kernelspec": {
207 |    "display_name": "Python 3",
208 |    "language": "python",
209 |    "name": "python3"
210 |   },
211 |   "language_info": {
212 |    "codemirror_mode": {
213 |     "name": "ipython",
214 |     "version": 3
215 |    },
216 |    "file_extension": ".py",
217 |    "mimetype": "text/x-python",
218 |    "name": "python",
219 |    "nbconvert_exporter": "python",
220 |    "pygments_lexer": "ipython3",
221 |    "version": "3.8.5"
222 |   }
223 |  },
224 |  "nbformat": 4,
225 |  "nbformat_minor": 4
226 | }
227 | 


--------------------------------------------------------------------------------
/feature_layers/manage_indexes.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Manage Indexes\n",
  8 |     "[Feature Layer](http://esri.github.io/arcgis-python-api/apidoc/html/arcgis.features.toc.html#featurelayer) || [the Manager](http://esri.github.io/arcgis-python-api/apidoc/html/arcgis.features.managers.html?highlight=manager#featurelayermanager) || [About indexes](https://en.wikipedia.org/wiki/Database_index)"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": null,
 14 |    "metadata": {
 15 |     "collapsed": true,
 16 |     "jupyter": {
 17 |      "outputs_hidden": true
 18 |     }
 19 |    },
 20 |    "outputs": [],
 21 |    "source": [
 22 |     "from arcgis.gis import GIS\n",
 23 |     "from arcgis.features import FeatureLayer"
 24 |    ]
 25 |   },
 26 |   {
 27 |    "cell_type": "code",
 28 |    "execution_count": null,
 29 |    "metadata": {
 30 |     "collapsed": true,
 31 |     "jupyter": {
 32 |      "outputs_hidden": true
 33 |     }
 34 |    },
 35 |    "outputs": [],
 36 |    "source": [
 37 |     "gis = GIS(username=\"mpayson_startups\")"
 38 |    ]
 39 |   },
 40 |   {
 41 |    "cell_type": "code",
 42 |    "execution_count": null,
 43 |    "metadata": {
 44 |     "collapsed": true,
 45 |     "jupyter": {
 46 |      "outputs_hidden": true
 47 |     }
 48 |    },
 49 |    "outputs": [],
 50 |    "source": [
 51 |     "lyr = FeatureLayer(\"<MY LAYER URL>\", gis=gis)"
 52 |    ]
 53 |   },
 54 |   {
 55 |    "cell_type": "markdown",
 56 |    "metadata": {},
 57 |    "source": [
 58 |     "### Existing Indexes"
 59 |    ]
 60 |   },
 61 |   {
 62 |    "cell_type": "code",
 63 |    "execution_count": null,
 64 |    "metadata": {
 65 |     "collapsed": true,
 66 |     "jupyter": {
 67 |      "outputs_hidden": true
 68 |     }
 69 |    },
 70 |    "outputs": [],
 71 |    "source": [
 72 |     "lyr.properties.indexes"
 73 |    ]
 74 |   },
 75 |   {
 76 |    "cell_type": "markdown",
 77 |    "metadata": {},
 78 |    "source": [
 79 |     "### Rebuild Indexes\n",
 80 |     "[Update endpoint](https://developers.arcgis.com/rest/services-reference/update-definition-feature-layer-.htm)"
 81 |    ]
 82 |   },
 83 |   {
 84 |    "cell_type": "code",
 85 |    "execution_count": null,
 86 |    "metadata": {
 87 |     "collapsed": true,
 88 |     "jupyter": {
 89 |      "outputs_hidden": true
 90 |     }
 91 |    },
 92 |    "outputs": [],
 93 |    "source": [
 94 |     "# build serializable dictionary instead of PropertyMap\n",
 95 |     "index_list = [dict(i) for i in lyr.properties.indexes]\n",
 96 |     "update_dict = {\"indexes\": index_list}"
 97 |    ]
 98 |   },
 99 |   {
100 |    "cell_type": "code",
101 |    "execution_count": null,
102 |    "metadata": {
103 |     "collapsed": true,
104 |     "jupyter": {
105 |      "outputs_hidden": true
106 |     }
107 |    },
108 |    "outputs": [],
109 |    "source": [
110 |     "# \"updating\" existing indexes will rebuild them\n",
111 |     "lyr.manager.update_definition(update_dict)"
112 |    ]
113 |   },
114 |   {
115 |    "cell_type": "markdown",
116 |    "metadata": {},
117 |    "source": [
118 |     "### Add Index\n",
119 |     "[Add to definition endpoint](http://resources.arcgis.com/en/help/arcgis-rest-api/#/Add_to_Definition_Feature_Layer/02r300000228000000/).\n",
120 |     "\n",
121 |     "You can use this endpoint to add new indexes. These indexes can be for one or multiple fields. More on [multiple indexes vs multi-column indexes](https://stackoverflow.com/questions/179085/multiple-indexes-vs-multi-column-indexes/179109#179109)."
122 |    ]
123 |   },
124 |   {
125 |    "cell_type": "code",
126 |    "execution_count": null,
127 |    "metadata": {
128 |     "collapsed": true,
129 |     "jupyter": {
130 |      "outputs_hidden": true
131 |     }
132 |    },
133 |    "outputs": [],
134 |    "source": [
135 |     "# see available fields\n",
136 |     "lyr.properties.fields"
137 |    ]
138 |   },
139 |   {
140 |    "cell_type": "code",
141 |    "execution_count": null,
142 |    "metadata": {
143 |     "collapsed": true,
144 |     "jupyter": {
145 |      "outputs_hidden": true
146 |     }
147 |    },
148 |    "outputs": [],
149 |    "source": [
150 |     "new_index = {\n",
151 |     "    \"name\" : \"<MY INDEX NAME>\", \n",
152 |     "    \"fields\" : \"<FIELD.name(s) TO INDEX>\"\n",
153 |     "#     \"isUnique\" : False,\n",
154 |     "#     \"isAscending\" : False,\n",
155 |     "#     \"description\" : \"MY INDEX\" \n",
156 |     "}\n",
157 |     "add_dict = {\"indexes\" : [new_index]}"
158 |    ]
159 |   },
160 |   {
161 |    "cell_type": "code",
162 |    "execution_count": null,
163 |    "metadata": {
164 |     "collapsed": true,
165 |     "jupyter": {
166 |      "outputs_hidden": true
167 |     }
168 |    },
169 |    "outputs": [],
170 |    "source": [
171 |     "lyr.manager.add_to_definition(add_dict)"
172 |    ]
173 |   }
174 |  ],
175 |  "metadata": {
176 |   "kernelspec": {
177 |    "display_name": "Python 3",
178 |    "language": "python",
179 |    "name": "python3"
180 |   },
181 |   "language_info": {
182 |    "codemirror_mode": {
183 |     "name": "ipython",
184 |     "version": 3
185 |    },
186 |    "file_extension": ".py",
187 |    "mimetype": "text/x-python",
188 |    "name": "python",
189 |    "nbconvert_exporter": "python",
190 |    "pygments_lexer": "ipython3",
191 |    "version": "3.8.5"
192 |   }
193 |  },
194 |  "nbformat": 4,
195 |  "nbformat_minor": 4
196 | }
197 | 


--------------------------------------------------------------------------------
/feature_layers/shapefile_upload.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Bulk Shapefile Upload\n",
  8 |     "A notebook to read shapefiles and upload their data as [hosted feature layers](https://doc.arcgis.com/en/arcgis-online/share-maps/hosted-web-layers.htm) in ArcGIS"
  9 |    ]
 10 |   },
 11 |   {
 12 |    "cell_type": "code",
 13 |    "execution_count": null,
 14 |    "metadata": {
 15 |     "collapsed": true,
 16 |     "jupyter": {
 17 |      "outputs_hidden": true
 18 |     }
 19 |    },
 20 |    "outputs": [],
 21 |    "source": [
 22 |     "# common imports\n",
 23 |     "import os\n",
 24 |     "from arcgis.gis import *\n",
 25 |     "import shutil"
 26 |    ]
 27 |   },
 28 |   {
 29 |    "cell_type": "markdown",
 30 |    "metadata": {},
 31 |    "source": [
 32 |     "## User Input\n",
 33 |     "\n",
 34 |     "* **gis**: your GIS instance, parameter information [here](https://developers.arcgis.com/python/guide/using-the-gis/)\n",
 35 |     "* **dir_path**: path to directory with the Shapefiles"
 36 |    ]
 37 |   },
 38 |   {
 39 |    "cell_type": "code",
 40 |    "execution_count": null,
 41 |    "metadata": {
 42 |     "collapsed": true,
 43 |     "jupyter": {
 44 |      "outputs_hidden": true
 45 |     }
 46 |    },
 47 |    "outputs": [],
 48 |    "source": [
 49 |     "gis = GIS(\"https://www.arcgis.com\", \"<USERNAME>\", \"<PASSWORD>\")\n",
 50 |     "\n",
 51 |     "dir_path = \"<DIRECTORY PATH>\""
 52 |    ]
 53 |   },
 54 |   {
 55 |    "cell_type": "markdown",
 56 |    "metadata": {},
 57 |    "source": [
 58 |     "## Execution"
 59 |    ]
 60 |   },
 61 |   {
 62 |    "cell_type": "code",
 63 |    "execution_count": null,
 64 |    "metadata": {
 65 |     "collapsed": true,
 66 |     "jupyter": {
 67 |      "outputs_hidden": true
 68 |     }
 69 |    },
 70 |    "outputs": [],
 71 |    "source": [
 72 |     "# get an array of all the shapefiles in the directory\n",
 73 |     "shapefiles = [file for file in os.listdir(dir_path) if file.endswith('.shp')]\n",
 74 |     "shp_paths = [os.path.join(dir_path, file) for file in shapefiles]\n",
 75 |     "print(\"Pushing {0} shapefile(s)\".format(len(shp_paths)))"
 76 |    ]
 77 |   },
 78 |   {
 79 |    "cell_type": "code",
 80 |    "execution_count": null,
 81 |    "metadata": {
 82 |     "collapsed": true,
 83 |     "jupyter": {
 84 |      "outputs_hidden": true
 85 |     }
 86 |    },
 87 |    "outputs": [],
 88 |    "source": [
 89 |     "# create a new folder in the GIS to store the layers (if it doesn't already exist)\n",
 90 |     "folder = os.path.basename(dir_path)\n",
 91 |     "gis_folder = gis.content.create_folder(folder)\n",
 92 |     "\n",
 93 |     "# handle folder already exists\n",
 94 |     "gis_folder = folder if gis_folder is None else gis_folder"
 95 |    ]
 96 |   },
 97 |   {
 98 |    "cell_type": "code",
 99 |    "execution_count": null,
100 |    "metadata": {
101 |     "collapsed": true,
102 |     "jupyter": {
103 |      "outputs_hidden": true
104 |     }
105 |    },
106 |    "outputs": [],
107 |    "source": [
108 |     "# loop through shapefiles, zip them for upload, upload layers to GIS, move to new folder\n",
109 |     "for i, shp_path in enumerate(shp_paths):\n",
110 |     "    # create a temp dir to work in\n",
111 |     "    with tempfile.TemporaryDirectory() as temp_dir:\n",
112 |     "        # copy all shapefile files into temp dir and zip the dir.\n",
113 |     "        temp_shp_dir = os.path.join(temp_dir, os.path.splitext(os.path.basename(shp_path))[0])\n",
114 |     "        os.makedirs(temp_shp_dir)\n",
115 |     "        for ext in ['.shp', '.dbf', '.cpg', '.prj', '.sbn', '.sbx', '.shp.xml', '.shx']:\n",
116 |     "            if os.path.exists(os.path.splitext(shp_path)[0] + ext):\n",
117 |     "                shutil.copy(os.path.splitext(shp_path)[0]+ext, temp_shp_dir)\n",
118 |     "                \n",
119 |     "        shp_zip = shutil.make_archive(temp_shp_dir, 'zip', root_dir=temp_shp_dir)\n",
120 |     "        \n",
121 |     "        # publish the shapefile zip\n",
122 |     "        title = os.path.splitext(os.path.basename(shp_path))[0]\n",
123 |     "        item = gis.content.add(data=shp_zip, item_properties={\n",
124 |     "            \"title\": title,\n",
125 |     "            'type': 'Shapefile',\n",
126 |     "            \"tags\": title})\n",
127 |     "        # see also: https://developers.arcgis.com/rest/services-reference/feature-service.htm\n",
128 |     "        features_service = item.publish({\n",
129 |     "            \"name\": os.path.splitext(item['name'])[0],\n",
130 |     "            \"hasStaticData\": True,\n",
131 |     "            \"layerInfo\": {\"capabilities\": \"Query\"}\n",
132 |     "        })\n",
133 |     "        \n",
134 |     "        # move the newly uploaded item to the folder created earlier\n",
135 |     "        item.move(folder)\n",
136 |     "        features_service.move(folder)\n",
137 |     "    \n",
138 |     "    print(\"{0}/{1}\".format(i + 1, len(shp_paths)))\n"
139 |    ]
140 |   }
141 |  ],
142 |  "metadata": {
143 |   "kernelspec": {
144 |    "display_name": "Python 3",
145 |    "language": "python",
146 |    "name": "python3"
147 |   },
148 |   "language_info": {
149 |    "codemirror_mode": {
150 |     "name": "ipython",
151 |     "version": 3
152 |    },
153 |    "file_extension": ".py",
154 |    "mimetype": "text/x-python",
155 |    "name": "python",
156 |    "nbconvert_exporter": "python",
157 |    "pygments_lexer": "ipython3",
158 |    "version": "3.7.4"
159 |   }
160 |  },
161 |  "nbformat": 4,
162 |  "nbformat_minor": 4
163 | }
164 | 


--------------------------------------------------------------------------------
/feature_layers/update_data.ipynb:
--------------------------------------------------------------------------------
  1 | {
  2 |  "cells": [
  3 |   {
  4 |    "cell_type": "markdown",
  5 |    "metadata": {},
  6 |    "source": [
  7 |     "# Update Data\n",
  8 |     "A couple different workflows for updating data:\n",
  9 |     "* Apply edits -- good for small, transactional edits\n",
 10 |     "* Overwrite -- good for ETL when extracting the entire dataset to replace all the existing data\n",
 11 |     "* Append -- good for ETL, batch updating existing layers and other"
 12 |    ]
 13 |   },
 14 |   {
 15 |    "cell_type": "code",
 16 |    "execution_count": 1,
 17 |    "metadata": {},
 18 |    "outputs": [],
 19 |    "source": [
 20 |     "import json\n",
 21 |     "import tempfile\n",
 22 |     "import os\n",
 23 |     "import shutil\n",
 24 |     "import pandas as pd\n",
 25 |     "from arcgis.gis import GIS\n",
 26 |     "from arcgis.features import FeatureLayerCollection"
 27 |    ]
 28 |   },
 29 |   {
 30 |    "cell_type": "markdown",
 31 |    "metadata": {},
 32 |    "source": [
 33 |     "***Note**, if you are unable to import local `partnerutils`, **copy the following functions** from [`cool_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/cool_utils.py) and [`feature_utils`](https://github.com/mpayson/esri-partner-tools/blob/master/partnerutils/feature_utils.py)"
 34 |    ]
 35 |   },
 36 |   {
 37 |    "cell_type": "code",
 38 |    "execution_count": 2,
 39 |    "metadata": {},
 40 |    "outputs": [],
 41 |    "source": [
 42 |     "from partnerutils.cool_utils import chunk_df\n",
 43 |     "from partnerutils.feature_utils import sdf_from_xyz"
 44 |    ]
 45 |   },
 46 |   {
 47 |    "cell_type": "code",
 48 |    "execution_count": 3,
 49 |    "metadata": {},
 50 |    "outputs": [
 51 |     {
 52 |      "name": "stdin",
 53 |      "output_type": "stream",
 54 |      "text": [
 55 |       "Enter password:  ········\n"
 56 |      ]
 57 |     }
 58 |    ],
 59 |    "source": [
 60 |     "# this will prompt for a password\n",
 61 |     "# can also do GIS(\"https://www.arcgis.com\", \"<USERNAME>\", \"<PASSWORD>\")\n",
 62 |     "gis = GIS(username=\"mpayson_startups\")"
 63 |    ]
 64 |   },
 65 |   {
 66 |    "cell_type": "markdown",
 67 |    "metadata": {},
 68 |    "source": [
 69 |     "## Apply Edits\n",
 70 |     "This uses the **[`edit_features`](https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.features.toc.html#arcgis.features.FeatureLayer.edit_features)** function to append data when working with a [Spatially Enabled DataFrame](https://developers.arcgis.com/python/guide/introduction-to-the-spatially-enabled-dataframe/). This method is best for small updates as it sends individual features as JSON and applies row-by-row edits. You can also update an existing feature using the `updates` parameter in `edit_features` by specifying a common Object ID.\n",
 71 |     "\n",
 72 |     "Note, after a few updates, I'd [rebuild the indexes](https://github.com/mpayson/esri-partner-tools/blob/master/feature_layers/manage_indexes.ipynb) as they can become unbalanced with many transactional edits."
 73 |    ]
 74 |   },
 75 |   {
 76 |    "cell_type": "code",
 77 |    "execution_count": 4,
 78 |    "metadata": {},
 79 |    "outputs": [],
 80 |    "source": [
 81 |     "# path to data\n",
 82 |     "csv_path = \"../sample_data/NYC_Restaurant_Inspections.csv\"\n",
 83 |     "x_col = \"Longitude\"\n",
 84 |     "y_col = \"Latitude\""
 85 |    ]
 86 |   },
 87 |   {
 88 |    "cell_type": "code",
 89 |    "execution_count": 5,
 90 |    "metadata": {},
 91 |    "outputs": [
 92 |     {
 93 |      "data": {
 94 |       "text/plain": [
 95 |        "5000"
 96 |       ]
 97 |      },
 98 |      "execution_count": 5,
 99 |      "metadata": {},
100 |      "output_type": "execute_result"
101 |     }
102 |    ],
103 |    "source": [
104 |     "# read csv and construct spatial dataframe\n",
105 |     "df = pd.read_csv(csv_path)\n",
106 |     "sdf = sdf_from_xyz(df, x_col, y_col)\n",
107 |     "len(sdf)"
108 |    ]
109 |   },
110 |   {
111 |    "cell_type": "code",
112 |    "execution_count": 6,
113 |    "metadata": {},
114 |    "outputs": [
115 |     {
116 |      "data": {
117 |       "text/html": [
118 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
119 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
120 |        "                       <a href='https://Startups.maps.arcgis.com/home/item.html?id=4fa5d18ff8e14ed99a06cd1725d92450' target='_blank'>\n",
121 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
122 |        "                       </a>\n",
123 |        "                    </div>\n",
124 |        "\n",
125 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
126 |        "                        <a href='https://Startups.maps.arcgis.com/home/item.html?id=4fa5d18ff8e14ed99a06cd1725d92450' target='_blank'><b>MyFeatureService</b>\n",
127 |        "                        </a>\n",
128 |        "                        <br/><img src='https://Startups.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/featureshosted16.png' style=\"vertical-align:middle;\">Feature Layer Collection by mpayson_startups\n",
129 |        "                        <br/>Last Modified: December 10, 2019\n",
130 |        "                        <br/>0 comments, 0 views\n",
131 |        "                    </div>\n",
132 |        "                </div>\n",
133 |        "                "
134 |       ],
135 |       "text/plain": [
136 |        "<Item title:\"MyFeatureService\" type:Feature Layer Collection owner:mpayson_startups>"
137 |       ]
138 |      },
139 |      "execution_count": 6,
140 |      "metadata": {},
141 |      "output_type": "execute_result"
142 |     }
143 |    ],
144 |    "source": [
145 |     "# iterate through chunks to create and append data\n",
146 |     "lyr = None\n",
147 |     "for c_df in chunk_df(sdf):\n",
148 |     "    if not lyr:\n",
149 |     "        item = c_df.spatial.to_featurelayer(\"MyFeatureService\", tags=\"esri_partner_tools_sample\")\n",
150 |     "        lyr = item.layers[0]\n",
151 |     "    else:\n",
152 |     "        # THIS IS THE APPEND DATA PART\n",
153 |     "        fs = c_df.spatial.to_featureset()\n",
154 |     "        success = lyr.edit_features(adds=fs)\n",
155 |     "item"
156 |    ]
157 |   },
158 |   {
159 |    "cell_type": "markdown",
160 |    "metadata": {},
161 |    "source": [
162 |     "## Overwrite\n",
163 |     "This uses the **[`ovewrite`](https://developers.arcgis.com/python/api-reference/arcgis.features.managers.html?highlight=overwrite#arcgis.features.managers.FeatureLayerCollectionManager.overwrite)** method. It deletes all data in an existing service and replaces it with updated data from the specified file. This is the most efficient method if you are completely updating a service.\n",
164 |     "\n",
165 |     "Note, the overwriting file type **must be the same** as the type used to create the initial service (more info in doc). If you publish from a data frame (like above) the Python API zips to a FGDB or SHP before publishing, so updating with geojson or CSV won't work."
166 |    ]
167 |   },
168 |   {
169 |    "cell_type": "code",
170 |    "execution_count": 7,
171 |    "metadata": {},
172 |    "outputs": [],
173 |    "source": [
174 |     "# get two geojson subsets to showcase the workflow\n",
175 |     "file_path = \"../sample_data/NYC_Restaurant_Inspections.geojson\"\n",
176 |     "with open(file_path) as file:\n",
177 |     "    geojson = json.load(file)\n",
178 |     "\n",
179 |     "features = geojson.pop('features')\n",
180 |     "init_geo = {**geojson, **{'features': features[0:3000]}}\n",
181 |     "next_geo = {**geojson, **{'features': features[3000:5000]}}"
182 |    ]
183 |   },
184 |   {
185 |    "cell_type": "code",
186 |    "execution_count": 8,
187 |    "metadata": {},
188 |    "outputs": [
189 |     {
190 |      "data": {
191 |       "text/html": [
192 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
193 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
194 |        "                       <a href='https://Startups.maps.arcgis.com/home/item.html?id=6de4b01ab0d64562a3d1f2638e874e10' target='_blank'>\n",
195 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
196 |        "                       </a>\n",
197 |        "                    </div>\n",
198 |        "\n",
199 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
200 |        "                        <a href='https://Startups.maps.arcgis.com/home/item.html?id=6de4b01ab0d64562a3d1f2638e874e10' target='_blank'><b>Inspections</b>\n",
201 |        "                        </a>\n",
202 |        "                        <br/><img src='https://Startups.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/featureshosted16.png' style=\"vertical-align:middle;\">Feature Layer Collection by mpayson_startups\n",
203 |        "                        <br/>Last Modified: December 10, 2019\n",
204 |        "                        <br/>0 comments, 0 views\n",
205 |        "                    </div>\n",
206 |        "                </div>\n",
207 |        "                "
208 |       ],
209 |       "text/plain": [
210 |        "<Item title:\"Inspections\" type:Feature Layer Collection owner:mpayson_startups>"
211 |       ]
212 |      },
213 |      "execution_count": 8,
214 |      "metadata": {},
215 |      "output_type": "execute_result"
216 |     }
217 |    ],
218 |    "source": [
219 |     "# publish the initial layer\n",
220 |     "temp_dir_path = tempfile.mkdtemp()\n",
221 |     "temp_file_path = os.path.join(temp_dir_path, 'Inspections.geojson')\n",
222 |     "with open(temp_file_path, 'w') as temp_file:\n",
223 |     "    json.dump(init_geo, temp_file)\n",
224 |     "\n",
225 |     "item = gis.content.add({\n",
226 |     "    \"type\": \"GeoJson\",\n",
227 |     "    \"title\": \"Inspections\",\n",
228 |     "    \"tags\": \"esri_partner_tools_sample\",\n",
229 |     "    #... additional properties like descriptions\n",
230 |     "}, data=temp_file_path)\n",
231 |     "shutil.rmtree(temp_dir_path)\n",
232 |     "\n",
233 |     "lyr_item = item.publish()\n",
234 |     "lyr_item"
235 |    ]
236 |   },
237 |   {
238 |    "cell_type": "code",
239 |    "execution_count": 9,
240 |    "metadata": {},
241 |    "outputs": [
242 |     {
243 |      "data": {
244 |       "text/html": [
245 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
246 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
247 |        "                       <a href='https://Startups.maps.arcgis.com/home/item.html?id=6de4b01ab0d64562a3d1f2638e874e10' target='_blank'>\n",
248 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
249 |        "                       </a>\n",
250 |        "                    </div>\n",
251 |        "\n",
252 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
253 |        "                        <a href='https://Startups.maps.arcgis.com/home/item.html?id=6de4b01ab0d64562a3d1f2638e874e10' target='_blank'><b>Inspections</b>\n",
254 |        "                        </a>\n",
255 |        "                        <br/><img src='https://Startups.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/featureshosted16.png' style=\"vertical-align:middle;\">Feature Layer Collection by mpayson_startups\n",
256 |        "                        <br/>Last Modified: December 10, 2019\n",
257 |        "                        <br/>0 comments, 0 views\n",
258 |        "                    </div>\n",
259 |        "                </div>\n",
260 |        "                "
261 |       ],
262 |       "text/plain": [
263 |        "<Item title:\"Inspections\" type:Feature Layer Collection owner:mpayson_startups>"
264 |       ]
265 |      },
266 |      "execution_count": 9,
267 |      "metadata": {},
268 |      "output_type": "execute_result"
269 |     }
270 |    ],
271 |    "source": [
272 |     "# overwrite the layer with second geojson \n",
273 |     "temp_dir_path = tempfile.mkdtemp()\n",
274 |     "temp_file_path = os.path.join(temp_dir_path, 'Inspections.geojson')\n",
275 |     "with open(temp_file_path, 'w') as temp_file:\n",
276 |     "    json.dump(next_geo, temp_file)\n",
277 |     "\n",
278 |     "# THIS IS THE IMPORTANT PART\n",
279 |     "flc = FeatureLayerCollection.fromitem(lyr_item)\n",
280 |     "flc.manager.overwrite(temp_file_path)\n",
281 |     "\n",
282 |     "shutil.rmtree(temp_dir_path)\n",
283 |     "\n",
284 |     "lyr_item"
285 |    ]
286 |   },
287 |   {
288 |    "cell_type": "markdown",
289 |    "metadata": {},
290 |    "source": [
291 |     "## Append\n",
292 |     "This uses the **[`append`](https://developers.arcgis.com/python/api-reference/arcgis.features.toc.html#arcgis.features.FeatureLayer.append)** method (exclusive to ArcGIS Online). It upserts data from a previously existing file item (of any supported type) and is more efficient for larger updates. It can also update existing features. By default, this uses the Object ID attribute to determine which features to update, but you can also specify your own field, this field just [has to be indexed](https://github.com/mpayson/esri-partner-tools/blob/master/feature_layers/manage_indexes.ipynb) in ArcGIS Online."
293 |    ]
294 |   },
295 |   {
296 |    "cell_type": "code",
297 |    "execution_count": 4,
298 |    "metadata": {},
299 |    "outputs": [],
300 |    "source": [
301 |     "# get two geojson subsets to showcase the workflow\n",
302 |     "file_path = \"../sample_data/NYC_Restaurant_Inspections.geojson\"\n",
303 |     "with open(file_path) as file:\n",
304 |     "    geojson = json.load(file)\n",
305 |     "\n",
306 |     "features = geojson.pop('features')\n",
307 |     "init_geo = {**geojson, **{'features': features[0:3000]}}\n",
308 |     "next_geo = {**geojson, **{'features': features[3000:5000]}}"
309 |    ]
310 |   },
311 |   {
312 |    "cell_type": "code",
313 |    "execution_count": 6,
314 |    "metadata": {},
315 |    "outputs": [
316 |     {
317 |      "data": {
318 |       "text/html": [
319 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
320 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
321 |        "                       <a href='https://Startups.maps.arcgis.com/home/item.html?id=21871e0fe19041d2af3792ab9e1c54e9' target='_blank'>\n",
322 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
323 |        "                       </a>\n",
324 |        "                    </div>\n",
325 |        "\n",
326 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
327 |        "                        <a href='https://Startups.maps.arcgis.com/home/item.html?id=21871e0fe19041d2af3792ab9e1c54e9' target='_blank'><b>Inspections</b>\n",
328 |        "                        </a>\n",
329 |        "                        <br/><img src='https://Startups.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/featureshosted16.png' style=\"vertical-align:middle;\">Feature Layer Collection by mpayson_startups\n",
330 |        "                        <br/>Last Modified: January 29, 2020\n",
331 |        "                        <br/>0 comments, 0 views\n",
332 |        "                    </div>\n",
333 |        "                </div>\n",
334 |        "                "
335 |       ],
336 |       "text/plain": [
337 |        "<Item title:\"Inspections\" type:Feature Layer Collection owner:mpayson_startups>"
338 |       ]
339 |      },
340 |      "execution_count": 6,
341 |      "metadata": {},
342 |      "output_type": "execute_result"
343 |     }
344 |    ],
345 |    "source": [
346 |     "# publish the initial layer\n",
347 |     "temp_dir_path = tempfile.mkdtemp()\n",
348 |     "temp_file_path = os.path.join(temp_dir_path, 'Inspections.geojson')\n",
349 |     "with open(temp_file_path, 'w') as temp_file:\n",
350 |     "    json.dump(init_geo, temp_file)\n",
351 |     "\n",
352 |     "item = gis.content.add({\n",
353 |     "    \"type\": \"GeoJson\",\n",
354 |     "    \"title\": \"Inspections\",\n",
355 |     "    \"tags\": \"esri_partner_tools_sample\",\n",
356 |     "    # ... additional properties like descriptions\n",
357 |     "}, data=temp_file_path)\n",
358 |     "shutil.rmtree(temp_dir_path)\n",
359 |     "\n",
360 |     "lyr_item = item.publish()\n",
361 |     "lyr_item"
362 |    ]
363 |   },
364 |   {
365 |    "cell_type": "code",
366 |    "execution_count": 10,
367 |    "metadata": {},
368 |    "outputs": [
369 |     {
370 |      "data": {
371 |       "text/html": [
372 |        "<div class=\"item_container\" style=\"height: auto; overflow: hidden; border: 1px solid #cfcfcf; border-radius: 2px; background: #f6fafa; line-height: 1.21429em; padding: 10px;\">\n",
373 |        "                    <div class=\"item_left\" style=\"width: 210px; float: left;\">\n",
374 |        "                       <a href='https://Startups.maps.arcgis.com/home/item.html?id=b5cbd5325cd74cb9badee93fd8a7d283' target='_blank'>\n",
375 |        "                        <img src='http://static.arcgis.com/images/desktopapp.png' class=\"itemThumbnail\">\n",
376 |        "                       </a>\n",
377 |        "                    </div>\n",
378 |        "\n",
379 |        "                    <div class=\"item_right\"     style=\"float: none; width: auto; overflow: hidden;\">\n",
380 |        "                        <a href='https://Startups.maps.arcgis.com/home/item.html?id=b5cbd5325cd74cb9badee93fd8a7d283' target='_blank'><b>Append Inspections</b>\n",
381 |        "                        </a>\n",
382 |        "                        <br/><img src='https://Startups.maps.arcgis.com/home/js/jsapi/esri/css/images/item_type_icons/layers16.png' style=\"vertical-align:middle;\">GeoJson by mpayson_startups\n",
383 |        "                        <br/>Last Modified: January 29, 2020\n",
384 |        "                        <br/>0 comments, 0 views\n",
385 |        "                    </div>\n",
386 |        "                </div>\n",
387 |        "                "
388 |       ],
389 |       "text/plain": [
390 |        "<Item title:\"Append Inspections\" type:GeoJson owner:mpayson_startups>"
391 |       ]
392 |      },
393 |      "execution_count": 10,
394 |      "metadata": {},
395 |      "output_type": "execute_result"
396 |     }
397 |    ],
398 |    "source": [
399 |     "# overwrite the layer with second geojson \n",
400 |     "temp_dir_path = tempfile.mkdtemp()\n",
401 |     "temp_file_path = os.path.join(temp_dir_path, 'AppendInspections.geojson')\n",
402 |     "with open(temp_file_path, 'w') as temp_file:\n",
403 |     "    json.dump(next_geo, temp_file)\n",
404 |     "    \n",
405 |     "# add geojson as an item\n",
406 |     "append_item = gis.content.add({\n",
407 |     "    \"type\": \"GeoJson\",\n",
408 |     "    \"title\": \"Append Inspections\",\n",
409 |     "    \"tags\": \"esri_partner_tools_sample\"\n",
410 |     "}, data=temp_file_path)\n",
411 |     "shutil.rmtree(temp_dir_path)\n",
412 |     "\n",
413 |     "lyr = lyr_item.layers[0]\n",
414 |     "lyr.append(\n",
415 |     "    item_id=append_item.id,\n",
416 |     "    upload_format='geojson',\n",
417 |     "    # optional field to identify existing data to update from new data\n",
418 |     "    # field needs to be uniquely indexed (see manage indexes notebook)\n",
419 |     "    # by default, this is the ObjectID\n",
420 |     "#     upsert_matching_field=\"field_name\"\n",
421 |     ")\n",
422 |     "\n",
423 |     "lyr_item"
424 |    ]
425 |   },
426 |   {
427 |    "cell_type": "markdown",
428 |    "metadata": {},
429 |    "source": [
430 |     "### Clean up"
431 |    ]
432 |   },
433 |   {
434 |    "cell_type": "code",
435 |    "execution_count": 11,
436 |    "metadata": {},
437 |    "outputs": [
438 |     {
439 |      "data": {
440 |       "text/plain": [
441 |        "True"
442 |       ]
443 |      },
444 |      "execution_count": 11,
445 |      "metadata": {},
446 |      "output_type": "execute_result"
447 |     }
448 |    ],
449 |    "source": [
450 |     "delete_items = gis.content.search(\"tags:esri_partner_tools_sample\")\n",
451 |     "gis.content.delete_items(delete_items)"
452 |    ]
453 |   }
454 |  ],
455 |  "metadata": {
456 |   "kernelspec": {
457 |    "display_name": "Python 3",
458 |    "language": "python",
459 |    "name": "python3"
460 |   },
461 |   "language_info": {
462 |    "codemirror_mode": {
463 |     "name": "ipython",
464 |     "version": 3
465 |    },
466 |    "file_extension": ".py",
467 |    "mimetype": "text/x-python",
468 |    "name": "python",
469 |    "nbconvert_exporter": "python",
470 |    "pygments_lexer": "ipython3",
471 |    "version": "3.8.3"
472 |   }
473 |  },
474 |  "nbformat": 4,
475 |  "nbformat_minor": 4
476 | }
477 | 


--------------------------------------------------------------------------------
/partnerutils/README.md:
--------------------------------------------------------------------------------
1 | # Partner Utils
2 | 
3 | > Functions that I've found helpful
4 | 
5 | * [`cool_utils.py`](/partnerutils/cool_utils.py) - functions I want to remember and hopefully you will too!
6 | * [`etl_utils.py`](/partnerutils/etl_utils.py) - assist with common ETL logic
7 | * [`user_utils.py`](/partnerutils/user_utils.py) - assist with adding users
8 | * [`clone_utils.py`](/partnerutils/clone_utils.py) - assist with cloning groups & items
9 | * [`feature_utils.py`](partnerutils/feature_utils.py) - assist with features and feature data types


--------------------------------------------------------------------------------
/partnerutils/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/mpayson/esri-partner-tools/e7beb5c43a47cee38f231b2ca3463877e3ac4697/partnerutils/__init__.py


--------------------------------------------------------------------------------
/partnerutils/clone_utils.py:
--------------------------------------------------------------------------------
 1 | """utility functions to assist with cloning groups & items"""
 2 | 
 3 | def search_item_title(target, title):
 4 |     """search org for an existing item with title
 5 | 
 6 |     args:
 7 |     target -- target GIS to search
 8 |     item -- item with title to search
 9 |     """
10 |     s_items = target.content.search(query='title:{}'.format(title))
11 |     for s_item in s_items:
12 |         if s_item.title == title:
13 |             return s_item
14 |     return None
15 | 
16 | def search_group_title(target, title, **kwargs):
17 |     """search org for an existing group with title
18 | 
19 |     args:
20 |     target -- target GIS to search
21 |     group -- group with title to search
22 |     **kwargs -- all additional arguments described here
23 |     https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html#arcgis.gis.GroupManager.search
24 |     """
25 |     s_items = target.groups.search(title, **kwargs)
26 |     for s_item in s_items:
27 |         if s_item.title == title:
28 |             return s_item
29 |     return None
30 | 
31 | def clone_items_modify(items, target,
32 |                        modify_item_callback=None, modify_group_callback=None, **kwargs):
33 |     """Clone groups and items to a target GIS
34 |     * Abstraction over arcgis.gis.ContentManager.clone_items to:
35 |     - Provide callbacks to update properties, sometimes shouldn't have 1:1 copy
36 | 
37 |     args:
38 |     items -- items/groups to be cloned. specifying groups will clone groups & their items
39 |     target -- target gis where items or groups will be cloned
40 |     modify_item_callback -- callback to update Item properties, expects:
41 |         args: (item_clone, target_gis)
42 |         returns: flattened dict of args, eg {'title':'<>'; 'data':'<>'}, args here:
43 |     https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html?highlight=clone_items#arcgis.gis.Item.update
44 | 
45 |     modify_group_callback -- callback to update Group properties, expects:
46 |         args: (group_clone, expected_title, target_gis)
47 |         returns: dict of args here:
48 |     https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html?highlight=clone_items#arcgis.gis.Group.update
49 | 
50 |     **kwargs:
51 |     all additional args described here:
52 |     https://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html?highlight=clone_items#arcgis.gis.ContentManager.clone_items
53 |     """
54 | 
55 |     from arcgis.gis import Group
56 |     from arcgis.gis import Item
57 | 
58 |     # clone the items
59 |     results = target.content.clone_items(items, **kwargs)
60 | 
61 |     # update the cloned properties
62 | 
63 |     # list of all the groups
64 |     source_groups = [item for item in items if isinstance(item, Group)]
65 | 
66 |     # update each result
67 |     # clone_items automatically changes group name if name already exists in target
68 |     # this requires additional logic to pass back the expected name
69 |     for result in results:
70 |         if isinstance(result, Item) and modify_item_callback:
71 |             props = modify_item_callback(result, target)
72 |             args = {}
73 |             args['data'] = props.pop('data', None)
74 |             args['thumbnail'] = props.pop('thumbnail', None)
75 |             args['metadata'] = props.pop('metadata', None)
76 |             args['item_properties'] = props
77 |             result.update(**args)
78 |         elif isinstance(result, Group) and modify_group_callback:
79 |             source_tag = next(tag for tag in result.tags if 'source-' in tag)
80 |             source_id = source_tag[7:]
81 |             source_group = next(group for group in source_groups if group.id == source_id)
82 |             props = modify_group_callback(result, source_group.title, target)
83 |             result.update(**props)
84 | 
85 |     return results
86 | 


--------------------------------------------------------------------------------
/partnerutils/cool_utils.py:
--------------------------------------------------------------------------------
  1 | """Functions that I want to remember and hopefully you will too!"""
  2 | 
  3 | import glob
  4 | import os
  5 | import json
  6 | import pandas as pd
  7 | 
  8 | def chunk(row, n=1000):
  9 |     """chunk generator function for breaking up requests
 10 |     such as for Esri's geocoder
 11 |     
 12 |     args:
 13 |     row - the object to be chunked
 14 |     n - chunk size
 15 |     """
 16 |     for i in range(0, len(row), n):
 17 |         yield row[i:i + n]
 18 | 
 19 | def chunk_df(df, n=1000):
 20 |     """chunk generator function for breaking up requests with dataframes
 21 | 
 22 |     args:
 23 |     df - the dataframe to be chunked
 24 |     n - chunk size
 25 |     """
 26 |     
 27 |     for i in range(0, len(df), n):
 28 |         yield df.iloc[i:i + n].copy()
 29 | 
 30 | def csvs_to_df(dir_path):
 31 |     """concats all csvs in a directory to one dataframe
 32 |     
 33 |     args:
 34 |     dir_path - path to dir containing csvs
 35 |     """
 36 | 
 37 |     all_csvs = glob.glob(os.path.join(dir_path, '*.csv'))
 38 |     return pd.concat((pd.read_csv(f) for f in all_csvs if os.stat(f).st_size > 0))
 39 | 
 40 | def extract(obj, keys, **kwargs):
 41 |     """returns a nested object value for the specified keys
 42 |     
 43 |     args:
 44 |     obj -- the nested object containing the desired value
 45 |     keys -- list of keys to drill through object
 46 |     """
 47 |     required = kwargs.pop('required', False)
 48 |     default = kwargs.pop('default', None)
 49 |     warn = kwargs.pop('warn', False)
 50 |     
 51 |     o = obj
 52 |     for i in range(0, len(keys)):
 53 |         try:
 54 |             o = o[keys[i]]
 55 |         except (KeyError, IndexError):
 56 |             if warn:
 57 |                 print('Warning key does not exist. Key: {0} in Keys: {1}'.format(keys[i], keys))
 58 |             if required and default == None:
 59 |                 raise KeyError('Required key does not exist in object and no default')
 60 |             return default
 61 |     return o
 62 | 
 63 | def d_extract(obj, keys_delimited, **kwargs):
 64 |     """returns a nested object value for '.' delimited keys
 65 |     
 66 |     args: 
 67 |     obj -- the nested object containing the desired value
 68 |     keys -- a '.' delimited string of keys to drill through"""
 69 |     keys = keys_delimited.split('.')
 70 |     return extract(obj, keys, **kwargs)
 71 | 
 72 | def read_json(path):
 73 |     """Read in a JSON file as a dictionary
 74 |     
 75 |     args:
 76 |     path - path to the JSON file"""
 77 |     if os.path.exists(path):
 78 |         with open(path, 'r') as f:
 79 |             return json.load(f)
 80 |     return {}
 81 | 
 82 | def write_json(path, obj):
 83 |     """Write a dictionary to a file
 84 | 
 85 |     args:
 86 |     path -- path to the output JSON file
 87 |     obj -- dictionary to write"""
 88 |     with open(path, 'w') as f:
 89 |         json.dump(obj, f)
 90 | 
 91 | def memoize(f):
 92 |     """Decorator to memoize function calls that receive a list
 93 |     as their first argument, useful to avoid expensive operations
 94 |     
 95 |     args:
 96 |     f -- the function to memoize"""
 97 | 
 98 |     cache = {}
 99 | 
100 |     def execute(input_list, *args, **kwargs):
101 |         cache_path = kwargs.pop('cache_path', None)
102 |         get_key = kwargs.pop('get_key', lambda i: str(i))
103 |         
104 |         if cache_path:
105 |             cache.update(read_json(cache_path))
106 | 
107 |         keys = set()
108 |         process = []
109 |         for i in input_list:
110 |             key = get_key(i)
111 |             if key not in cache and key not in keys:
112 |                 process.append(i)
113 |                 keys.add(key)
114 | 
115 |         if len(process) > 0:
116 |             results = f(process, *args, **kwargs)
117 |             for i, p in enumerate(process):
118 |                 cache[get_key(p)] = results[i]
119 | 
120 |         if cache_path:
121 |             write_json(cache_path, cache)
122 | 
123 |         return [cache[get_key(i)] for i in input_list]
124 | 
125 |     return execute


--------------------------------------------------------------------------------
/partnerutils/etl_utils.py:
--------------------------------------------------------------------------------
  1 | """********************************************
  2 | * A couple ETL utility functions for working with ArcGIS
  3 | ********************************************"""
  4 | import tempfile
  5 | import json
  6 | import datetime
  7 | 
  8 | DEFAULT_TITLE = 'GeoJSON Utils POC'
  9 | DEFAULT_TAG = 'geojson-utils-poc'
 10 | 
 11 | def date_to_ags(date):
 12 |     """Returns an ArcGIS-formatted date from a Python date object
 13 |     
 14 |     args:
 15 |     date - Python date object"""
 16 |     tz = datetime.timezone.utc
 17 |     return date.astimezone(tz).strftime('%m/%d/%Y %H:%M:%S')
 18 | 
 19 | def timestamp_to_ags(timestamp):
 20 |     """Returns an ArcGIS-formatted date from a timestamp
 21 |     
 22 |     args:
 23 |     timestamp -- timestamp in milliseconds since epoch"""
 24 |     seconds = timestamp / 1000
 25 |     date = datetime.datetime.fromtimestamp(seconds)
 26 |     return date_to_ags(date)
 27 | 
 28 | def _add_unique_index(layer, field):
 29 |     """Adds a unique index for upsert operations to update, or avoid duplicating, existing rows
 30 | 
 31 |     args:
 32 |     layer -- where to add the index
 33 |     field -- the field to index
 34 |     """
 35 |     new_index = {
 36 |         "name": "External UID",
 37 |         "fields": field,
 38 |         "isUnique": True,
 39 |         "description": "External UID for upsert operations"
 40 |     }
 41 |     add_dict = {"indexes" : [new_index]}
 42 |     return layer.manager.add_to_definition(add_dict)
 43 | 
 44 | def add_geojson(gis, geojson, **item_options):
 45 |     """Uploads geojson and returns the file item
 46 |     
 47 |     args:
 48 |     gis -- gis object where item is added
 49 |     geojson -- geojson object to upload as file
 50 |     item_options -- additional item properties, see here:
 51 |     https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager.add"""
 52 | 
 53 |     # get default args
 54 |     title = item_options.pop('title', DEFAULT_TITLE)
 55 |     tags = item_options.pop('tags', DEFAULT_TAG)
 56 |         
 57 |     # save geojson to tempfile and add as item
 58 |     with tempfile.NamedTemporaryFile(mode="w", suffix='.json') as fp:
 59 |         fp.write(json.dumps(geojson))
 60 |         item = gis.content.add({
 61 |             **item_options,
 62 |             'type': 'GeoJson',
 63 |             'title': title,
 64 |             'tags': tags,
 65 |         }, data=fp.name)
 66 |     
 67 |     return item
 68 | 
 69 | def append_to_layer(gis, layer, geojson, uid_field=None):
 70 |     """Appends geojson to an existing service and returns the results
 71 | 
 72 |     Note, this is the best approach for bulk updates in ArcGIS Online.
 73 |     There are other options here, such as transactional edits
 74 |     > https://github.com/mpayson/esri-partner-tools/blob/master/feature_layers/update_data.ipynb
 75 |     
 76 |     args:
 77 |     gis -- gis object where the layers live
 78 |     layer -- FeatureLayer to be updated
 79 |     geojson -- geojson object to add to the layer
 80 |     uid_field -- identifies existing features to update with new features (must be uniquely indexed)
 81 |     """
 82 | 
 83 |     item = add_geojson(gis, geojson, title="Data update")
 84 |     result = None
 85 | 
 86 |     try:
 87 |         # if there's a uid_field make sure it's indexed before append
 88 |         indexes = layer.properties.indexes
 89 |         if uid_field and not any(i['fields'] == uid_field for i in indexes):
 90 |             _add_unique_index(layer, uid_field)
 91 | 
 92 |         result = layer.append(
 93 |             item_id=item.id,
 94 |             upload_format="geojson",
 95 |             upsert=(uid_field != None),
 96 |             upsert_matching_field=uid_field # update existing features with matching uid_fields
 97 |         )
 98 |     finally:
 99 |         item.delete() # if not deleted next run will eror and pollute ArcGIS
100 | 
101 |     return result
102 | 
103 | def create_layer(gis, geojson, template_item):
104 |     """Publishes geojson as a hosted service based on an existing template item
105 |     and returns the resulting layer item
106 |     
107 |     args:
108 |     gis -- gis where the layer should live
109 |     geojson -- initial geojson to populate the layer
110 |     template_item -- existing Item that has been pre-configured with desired properties"""
111 | 
112 |     results = gis.content.clone_items([template_item], copy_data=False, search_existing_items=False)
113 |     item = results[0]
114 |     lyr = item.layers[0]
115 | 
116 |     append_to_layer(gis, lyr, geojson)
117 | 
118 |     return item
119 | 
120 | def create_scratch_layer(gis, geojson, uid_field=None, **item_options):
121 |     """Publishes geojson as a hosted service and returns the layer item
122 | 
123 |     Note, use this to quickly add geojson with system default properties. In production,
124 |     it's easier to set desired properties on a template layer then use create_layer.
125 |     
126 |     args:
127 |     gis -- gis where the layer should live
128 |     geojson -- initial geojson to populate the layer
129 |     uid_field -- global uid field that can be used to determine existing features on updates
130 |     item_options -- additional item properties, see here:
131 |     https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager.add"""
132 | 
133 |     item = add_geojson(gis, geojson, **item_options)
134 |     try:
135 |         lyr_item = item.publish()
136 |     finally:
137 |         item.delete()
138 |     
139 |     # add a unique index for upsert operations so don't duplicate rows
140 |     if uid_field:
141 |         lyr = lyr_item.layers[0]
142 |         _add_unique_index(lyr, uid_field)
143 |   
144 |     return lyr_item
145 | 
146 | def get_existing_item(gis, tags=None):
147 |     """Searches for an existing layer item and returns it
148 |     
149 |     Note, for now this just assumes there's just one layer item for the tags
150 |     
151 |     args:
152 |     gis -- gis to search
153 |     tags -- tags to search for layers within the gis"""
154 |     t = tags if tags else DEFAULT_TAG
155 |     search_items = gis.content.search('tags:"{0}" AND type:"Feature Service"'.format(t))
156 |     
157 |     return search_items[0] if len(search_items) > 0 else None
158 | 
159 | def delete_before(lyr, date, field):
160 |     """Deletes all features in a layer before a given date
161 | 
162 |     args:
163 |     lyr -- the feature layer with features to delete
164 |     date -- the date before which to delete features
165 |     field -- the date field"""
166 |     where = "{0} < '{1}'".format(field, date_to_ags(date))
167 |     return lyr.delete_features(where=where)
168 | 
169 | def delete_before_days(lyr, number_days, field):
170 |     """Deletes all features with dates before the specified
171 |     number of days back from today
172 | 
173 |     args:
174 |     lyr -- the feature layer with features to delete
175 |     number_days -- the number of days back before which to delete features
176 |     field -- the date field
177 |     """
178 |     dt = datetime.datetime.today() - datetime.timedelta(number_days)
179 |     return delete_before(lyr, dt, field)
180 | 


--------------------------------------------------------------------------------
/partnerutils/feature_utils.py:
--------------------------------------------------------------------------------
 1 | """utility functions to assist with features and feature data types"""
 2 | 
 3 | from arcgis.geometry import SpatialReference, Point
 4 | import pandas as pd
 5 | 
 6 | def sdf_from_xyz(df, x_col, y_col, z_col=None, sr=None):
 7 |     """builds a SpatialDataFrame from DataFrame with
 8 |     x, y, and z columns
 9 |     
10 |     args:
11 |     df - the dataframe
12 |     x_col - the dataframe column corresponding to x coordinate
13 |     y_col - the dataframe column corresponding to y coordinate
14 |     z_col - optional, the dataframe column corresponding to z coordinate
15 |     sr - the spatial reference for the spatial data frame
16 |     """
17 | 
18 |     if not z_col:
19 |         return pd.DataFrame.spatial.from_xy(df, x_col, y_col, sr)
20 |     
21 |     def point_for_row(x, y, z, sr):
22 |         return Point({'x' : x, 'y' : y, 'z': z, "spatialReference" : sr})
23 |     
24 |     if sr is None:
25 |         sr = SpatialReference({'wkid' : 4326})
26 | 
27 |     df_geom = df.apply(lambda row: point_for_row(row[x_col],
28 |                                                 row[y_col],
29 |                                                 row[z_col],
30 |                                                 sr), axis=1)
31 |     sdf = df.spatial.set_geometry(df_geom, sr=sr)
32 |     return sdf
33 | 
34 | 
35 | def row_to_geojson(row, lon_field, lat_field):
36 |     """returns a geojson feature for a flat dictionary
37 |     
38 |     args:
39 |     row -- dictionary with values
40 |     lon_field -- longitude dictionary key
41 |     lat_field -- latitude dictionary key"""
42 |     return {
43 |         'type': 'Feature',
44 |         'geometry': {
45 |             'type': 'Point',
46 |             'coordinates': [row[lon_field], row[lat_field]]
47 |         },
48 |         'properties': {**row}
49 |     }
50 | 
51 | def rows_to_geojson(rows, lon_field, lat_field):
52 |     """returns a geojson feature collection for a list of flat dictionary rows
53 |     
54 |     args:
55 |     rows -- list of dictionaries with values
56 |     lon_field -- longitude dictionary key
57 |     lat_field -- latitude dictionary key"""
58 |     features = [row_to_geojson(r, lon_field, lat_field) for r in rows]
59 |     return {
60 |         'type': 'FeatureCollection',
61 |         'features': features
62 |     }


--------------------------------------------------------------------------------
/partnerutils/processing_utils.py:
--------------------------------------------------------------------------------
 1 | """********************************************
 2 | * A couple utility functions to help with processing data
 3 | ********************************************"""
 4 | from arcgis.geocoding import batch_geocode
 5 | from partnerutils.cool_utils import memoize, chunk
 6 | 
 7 | @memoize
 8 | def batch_geocode_memo(addresses, **kwargs):
 9 |     """Batch geocodes a list of addresses and memoizes the results
10 |     to avoid repeated calls and credit consumption.
11 | 
12 |     args: 
13 |     addresses - the addresses to geocode
14 |     
15 |     **kwargs:
16 |     cache_path - persist the results to a file
17 |     get_key - function to uniquely identify each address
18 |     all others from here:
19 |     https://developers.arcgis.com/python/api-reference/arcgis.geocoding.html?highlight=batch_geocode#arcgis.geocoding.batch_geocode"""
20 | 
21 |     output = []
22 |     for c in chunk(addresses): # split into chunks for large volumes
23 |         results = batch_geocode(addresses=c, **kwargs)
24 |         output += results
25 | 
26 |     return output


--------------------------------------------------------------------------------
/partnerutils/user_utils.py:
--------------------------------------------------------------------------------
 1 | """utility functions to assist with adding users"""
 2 | import csv
 3 | 
 4 | USER_FIELDS = ["username", "password", "firstname", "lastname", "email", "role", "groups",
 5 |                "groups", "description", "role", "provider", "idp_username", "level"]
 6 | 
 7 | def add_user(user, gis, groups=None, field_map=None):
 8 |     """Add user to the gis
 9 |     * Abstraction for creating from dict such as with csv
10 |     * Handles moving to groups
11 | 
12 |     args:
13 |     user -- a dictionary containing user fields, see fields:
14 |     http://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html#arcgis.gis.UserManager.create
15 |     gis -- gis object where users are added
16 |     groups -- (optional) destination groups, compliments those in dict (default [])
17 |     field_map -- (optional) change keys from defaults in USER_FIELDS to those in dict
18 |     """
19 | 
20 |     # set defaults
21 |     groups = groups if groups else []
22 |     field_map = field_map if field_map else {}
23 | 
24 |     try:
25 | 
26 |         # Define new user fields
27 |         new_user = {}
28 |         for field in USER_FIELDS:
29 |             new_user[field] = (user.get(field_map[field], None)
30 |                                if field in field_map
31 |                                else user.get(field, None))
32 | 
33 |         print("INFO: Creating user {}".format(new_user["username"]))
34 | 
35 |         # Create/augment array of destination groups for user
36 |         # Pop group from user because separate logic
37 |         group_field = field_map["groups"] if "groups" in field_map else "groups"
38 |         group_str = new_user.pop(group_field, None)
39 |         if group_str:
40 |             group_list = group_str.split(",")
41 |             for g in group_list:
42 |                 group_search = gis.groups.search(g)
43 |                 if group_search:
44 |                     groups.append(group_search[0])
45 | 
46 |         # Create new user
47 |         result = gis.users.create(**new_user)
48 | 
49 |         # Sometimes there's an error that doesn't throw
50 |         if not result:
51 |             return
52 | 
53 |         # Add user to groups
54 |         for g in groups:
55 |             try:
56 |                 g.add_users([new_user['username']])
57 |             except Exception as e:
58 |                 print("ERR: Could not add user to group {}".format(g))
59 |                 print(e)
60 | 
61 |         return result
62 | 
63 |     except Exception as e:
64 |         print("ERR: Could not create user {}".format(user['username']))
65 |         print(e)
66 | 
67 | def add_users_csv(csv_file, gis, groups=None, field_map=None):
68 |     """Add users from csv to gis
69 |     * Convenient abstraction for csvs
70 | 
71 |     args:
72 |     csv_file -- path to csv with users to create
73 |     gis -- gis object where users are added
74 |     groups -- (optional) destination groups, compliments those in csv (default [])
75 |     field_map -- (optional) change keys from defaults in USER_FIELDS to those in csv, see fields:
76 |     http://esri.github.io/arcgis-python-api/apidoc/html/arcgis.gis.toc.html#arcgis.gis.UserManager.create
77 |     """
78 |     results = []
79 |     with open(csv_file, 'r') as users_csv:
80 |         users = csv.DictReader(users_csv)
81 |         for user in users:
82 |             result = add_user(user, gis, groups=groups, field_map=field_map)
83 |             results.append(result)
84 |     
85 |     return results


--------------------------------------------------------------------------------
/sample_data/sample_census_tract_geoid.csv:
--------------------------------------------------------------------------------
1 | census_tract_geoid
2 | 36047032100
3 | 36081065702


--------------------------------------------------------------------------------
/setup.py:
--------------------------------------------------------------------------------
  1 | """
  2 | **NOTE, THIS IS NOT MEANT TO BE PUBLISHED
  3 | 
  4 | ADAPTED FROM: A setuptools based setup module.
  5 | See:
  6 | https://packaging.python.org/en/latest/distributing.html
  7 | https://github.com/pypa/sampleproject
  8 | """
  9 | 
 10 | # Always prefer setuptools over distutils
 11 | from setuptools import setup
 12 | # To use a consistent encoding
 13 | from codecs import open
 14 | from os import path
 15 | 
 16 | here = path.abspath(path.dirname(__file__))
 17 | 
 18 | # Get the long description from the README file
 19 | with open(path.join(here, 'README.md'), encoding='utf-8') as f:
 20 |     long_description = f.read()
 21 | 
 22 | # Arguments marked as "Required" below must be included for upload to PyPI.
 23 | # Fields marked as "Optional" may be commented out.
 24 | 
 25 | setup(
 26 |     # This is the name of your project. The first time you publish this
 27 |     # package, this name will be registered for you. It will determine how
 28 |     # users can install this project, e.g.:
 29 |     #
 30 |     # $ pip install sampleproject
 31 |     #
 32 |     # And where it will live on PyPI: https://pypi.org/project/sampleproject/
 33 |     #
 34 |     # There are some restrictions on what makes a valid project name
 35 |     # specification here:
 36 |     # https://packaging.python.org/specifications/core-metadata/#name
 37 |     name='partnerutils',  # Required
 38 | 
 39 |     # Versions should comply with PEP 440:
 40 |     # https://www.python.org/dev/peps/pep-0440/
 41 |     #
 42 |     # For a discussion on single-sourcing the version across setup.py and the
 43 |     # project code, see
 44 |     # https://packaging.python.org/en/latest/single_source_version.html
 45 |     version='0.0.1',  # Required
 46 | 
 47 |     # This is a one-line description or tagline of what your project does. This
 48 |     # corresponds to the "Summary" metadata field:
 49 |     # https://packaging.python.org/specifications/core-metadata/#summary
 50 |     description='Partner utils for ArcGIS',  # Required
 51 | 
 52 |     # This is an optional longer description of your project that represents
 53 |     # the body of text which users will see when they visit PyPI.
 54 |     #
 55 |     # Often, this is the same as your README, so you can just read it in from
 56 |     # that file directly (as we have already done above)
 57 |     #
 58 |     # This field corresponds to the "Description" metadata field:
 59 |     # https://packaging.python.org/specifications/core-metadata/#description-optional
 60 |     long_description=long_description,  # Optional
 61 | 
 62 |     # Denotes that our long_description is in Markdown; valid values are
 63 |     # text/plain, text/x-rst, and text/markdown
 64 |     #
 65 |     # Optional if long_description is written in reStructuredText (rst) but
 66 |     # required for plain-text or Markdown; if unspecified, "applications should
 67 |     # attempt to render [the long_description] as text/x-rst; charset=UTF-8 and
 68 |     # fall back to text/plain if it is not valid rst" (see link below)
 69 |     #
 70 |     # This field corresponds to the "Description-Content-Type" metadata field:
 71 |     # https://packaging.python.org/specifications/core-metadata/#description-content-type-optional
 72 |     long_description_content_type='text/markdown',  # Optional (see note above)
 73 | 
 74 |     # This should be a valid link to your project's main homepage.
 75 |     #
 76 |     # This field corresponds to the "Home-Page" metadata field:
 77 |     # https://packaging.python.org/specifications/core-metadata/#home-page-optional
 78 |     url='https://github.com/mpayson/partner-python-tools',  # Optional
 79 | 
 80 |     # This should be your name or the name of the organization which owns the
 81 |     # project.
 82 |     author='Max Payson',  # Optional
 83 | 
 84 |     # This should be a valid email address corresponding to the author listed
 85 |     # above.
 86 |     author_email='mpayson@esri.com',  # Optional
 87 | 
 88 |     # Classifiers help users find your project by categorizing it.
 89 |     #
 90 |     # For a list of valid classifiers, see https://pypi.org/classifiers/
 91 |     # classifiers=[  # Optional
 92 |     #     # How mature is this project? Common values are
 93 |     #     #   3 - Alpha
 94 |     #     #   4 - Beta
 95 |     #     #   5 - Production/Stable
 96 |     #     'Development Status :: 3 - Alpha',
 97 | 
 98 |     #     # Indicate who your project is intended for
 99 |     #     'Intended Audience :: Developers',
100 |     #     'Topic :: Software Development :: Build Tools',
101 | 
102 |     #     # Pick your license as you wish
103 |     #     'License :: OSI Approved :: MIT License',
104 | 
105 |     #     # Specify the Python versions you support here. In particular, ensure
106 |     #     # that you indicate whether you support Python 2, Python 3 or both.
107 |     #     'Programming Language :: Python :: 2',
108 |     #     'Programming Language :: Python :: 2.7',
109 |     #     'Programming Language :: Python :: 3',
110 |     #     'Programming Language :: Python :: 3.4',
111 |     #     'Programming Language :: Python :: 3.5',
112 |     #     'Programming Language :: Python :: 3.6',
113 |     # ],
114 | 
115 |     # This field adds keywords for your project which will appear on the
116 |     # project page. What does your project relate to?
117 |     #
118 |     # Note that this is a string of words separated by whitespace, not a list.
119 |     keywords='esri arcgis startups partners gis webgis development',  # Optional
120 | 
121 |     # You can just specify package directories manually here if your project is
122 |     # simple. Or you can use find_packages().
123 |     #
124 |     # Alternatively, if you just want to distribute a single Python file, use
125 |     # the `py_modules` argument instead as follows, which will expect a file
126 |     # called `my_module.py` to exist:
127 |     #
128 |     #   py_modules=["my_module"],
129 |     #
130 |     packages=['partnerutils'],  # Required
131 | 
132 |     # This field lists other packages that your project depends on to run.
133 |     # Any package you put here will be installed by pip when your project is
134 |     # installed, so they must be valid existing projects.
135 |     #
136 |     # For an analysis of "install_requires" vs pip's requirements files see:
137 |     # https://packaging.python.org/en/latest/requirements.html
138 |     install_requires=['arcgis', 'pandas'],  # Optional
139 | 
140 |     # List additional groups of dependencies here (e.g. development
141 |     # dependencies). Users will be able to install these using the "extras"
142 |     # syntax, for example:
143 |     #
144 |     #   $ pip install sampleproject[dev]
145 |     #
146 |     # Similar to `install_requires` above, these must be valid existing
147 |     # projects.
148 |     # extras_require={  # Optional
149 |     #     'dev': ['check-manifest'],
150 |     #     'test': ['coverage'],
151 |     # },
152 | 
153 |     # If there are data files included in your packages that need to be
154 |     # installed, specify them here.
155 |     #
156 |     # If using Python 2.6 or earlier, then these have to be included in
157 |     # MANIFEST.in as well.
158 |     # package_data={  # Optional
159 |     #     'sample': ['package_data.dat'],
160 |     # },
161 | 
162 |     # Although 'package_data' is the preferred approach, in some case you may
163 |     # need to place data files outside of your packages. See:
164 |     # http://docs.python.org/3.4/distutils/setupscript.html#installing-additional-files
165 |     #
166 |     # In this case, 'data_file' will be installed into '<sys.prefix>/my_data'
167 |     # data_files=[('my_data', ['data/data_file'])],  # Optional
168 | 
169 |     # To provide executable scripts, use entry points in preference to the
170 |     # "scripts" keyword. Entry points provide cross-platform support and allow
171 |     # `pip` to create the appropriate form of executable for the target
172 |     # platform.
173 |     #
174 |     # For example, the following would provide a command called `sample` which
175 |     # executes the function `main` from this package when invoked:
176 |     # entry_points={  # Optional
177 |     #     'console_scripts': [
178 |     #         'sample=sample:main',
179 |     #     ],
180 |     # },
181 | 
182 |     # List additional URLs that are relevant to your project as a dict.
183 |     #
184 |     # This field corresponds to the "Project-URL" metadata fields:
185 |     # https://packaging.python.org/specifications/core-metadata/#project-url-multiple-use
186 |     #
187 |     # Examples listed include a pattern for specifying where the package tracks
188 |     # issues, where the source is hosted, where to say thanks to the package
189 |     # maintainers, and where to support the project financially. The key is
190 |     # what's used to render the link text on PyPI.
191 |     project_urls={  # Optional
192 |         'Bug Reports': 'https://github.com/mpayson/partner-python-tools',
193 |         'Say Thanks!': 'https://github.com/mpayson/partner-python-tools',
194 |         'Source': 'https://github.com/mpayson/partner-python-tools',
195 |     },
196 | )


--------------------------------------------------------------------------------