README.md

Esri Partner Tools

Useful tools for Esri Partners built with the ArcGIS API for Python

Contents

• About
• Prerequisites
• Contents
• Getting Started
• Sample Data
• Issues and Contributing

About

Partners working with Esri and ArcGIS implement many common workflows. The ArcGIS API for Python is an awesome automation library. This repo is meant to be a collection of POC scripts to automate some of these workflows.

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/ can also be installed as a local package:

$ pip install -q -U git+https://github.com/mpayson/esri-partner-tools

Prerequisites

• Install the ArcGIS API for Python (instructions)
• Access to Jupyter Notebooks

Contents

• partnerutils/ - Functions that I've found helpful
  • cool_utils.py - functions I want to remember and hopefully you will too!
  • etl_utils.py - assist with common ETL logic
  • user_utils.py - assist with adding users
  • clone_utils.py - assist with cloning groups & items
  • feature_utils.py - assist with features and feature data types
• common_workflows/ - Common workflows with the Python API
  • csv_geocode.ipynb - geocode rows in csvs and dataframes
  • vector_data_products.ipynb - end-to-end workflows for managing vector content and derivative information products
  • distribute_items.ipynb - common patterns for distributing items to another organization
  • standard_geography.ipynb - enrich standard geography ids, such as census blocks, with geometries
• feature_layers/ - Common operations with hosted feature layers
  • csv_upload.ipynb - upload a folder of csvs & dataframes
  • shapefile_upload.ipynb - upload a folder of Shapefiles
  • geojson_upload.ipynb - upload a geojson file
  • update_data.ipynb - a couple different workflows for updating uploaded / hosted data
  • create_views.ipynb - create database views with separate permissions against one authoritative layer
  • manage_fields.ipynb - view and edit fields
  • manage_indexes.ipynb - view, edit, and refresh indexes
  • enable_time.ipynb - add time metadata that will be reflected in ArcGIS app UIs
• build_org/ - Automate new ArcGIS Online deployments
  • clone_groups.ipynb - clone groups and their items
  • configure_org.ipynb - customize org UI, create groups, & add users
  • create_share_group.ipynb - create a group and invite members to share content with your users
  • register_application.ipynb automatically create and register an app

Getting Started

Many samples use partnerutils. To use this package, either copy & paste the functions as specified in each notebook OR:

$ pip install -q -U git+https://github.com/mpayson/esri-partner-tools

This will install the partnerutils as a local package in your active environment. The utilities can then be used as follows

from arcgis.gis import GIS
from partnerutils.processing_utils import batch_geocode_memo

gis = GIS(username="username", password="password")
addresses = ['El Burrito Redlands CA', '380 New York St Redlands CA']
results = batch_geocode_memo(addresses)

print(results)

Shout out to Ryan @ SafeGraph for showing me this is a thing. Otherwise, the notebooks should give enough detail to get started. If not, holler!

Sample Data

I included some sample data for testing and trialing:

• NYC_Restaurant_Inspections.csv - a slice of DOHMH New York City Restaurant Inspection Results. Source
• sample_census_tract_geoid.csv - a couple census tract geoids. Copied from here

Issues and Contributing

Want to request a new sample? Have a question? Would love to hear from you.

And PRs always welcome!