windows_pyesridump.md

Extract data from ESRI REST endpoint to GeoJSON (on Windows)

1. Find ESRI FeatureServer or MapServer

• example ESRI web map: Birmingham, AL
• open developer tools Ctrl+Shift+ i
• under "Network" tab, watch for objects with URLs that include arcgis/rest/services
• follow those URLS, and navigate back to the "Services Directory" (ex: https://gisweb.birminghamal.gov/arcgis/rest/services/)
• then navigate to the FeatureServer or MapServer layer (ex: https://gisweb.birminghamal.gov/arcgis/rest/services/CouncilDistrict/MapServer/0)
• this is the FeatureServer or MapServer endpoint we'll use. it should end in a number.

2. Install Python (with pip) for command line use

• should be version later than 2.7.9 or later than 3.4
• pip is the Python package manager
• installation guide: http://docs.python-guide.org/en/latest/starting/install/win/#install-windows

3. Setup a Virtual Environment

• > pip install virtualenv
• > virtualenv my_project_folder
• > cd my_project_folder
• > Scripts\activate
• setup guide: http://docs.python-guide.org/en/latest/dev/virtualenvs/

4. Install pyesridump command line utility

• > pip install esridump
• tool documentation: https://github.com/openaddresses/pyesridump

5. Get GeoJSON from ESRI endpoint

• > esri2geojson <FeatureServer or MapServer URL> <outfile>
• > esri2geojson https://gisweb.birminghamal.gov/arcgis/rest/services/CouncilDistrict/MapServer/0 birmingham_council_districts.geojson

Resources for making ArcGIS REST services private:

• http://server.arcgis.com/en/server/latest/administer/linux/securing-services-with-users-and-roles-specific-to-arcgis-server.htm