Awesome Open Source
Awesome Open Source

AGStoShapefile by TannerGeo

A command line tool for backing up ArcGIS Server REST Services to file.

AGStoShapefile is a node.js script that will convert Esri map services (Geoservices REST API) to GeoJSON and optionally Shapefile formats. This script will export all features and is not limited to max feature limits. AGStoShapefile can be used to cache your map services, store data for offline viewing, or used to build applications using a more simple GeJSON format.


If you wish to download files as Shapefile, you will need to install the following:

  1. You will need to install node.js with NPM. This script only runs on node versions 6.x.
  2. Install and setup GDAL Windows - Mac/Linux


  • Create a services.txt to include the services you wish to query

You can install via NPM

    npm install agsout -g

Or, optionally, download and install from local

    npm install . -g

Run the script

    agsout --help
    agsout -s ./services.txt -o ./backupdir -S
    #-s location of services text file
    #-o directory to backup services
    #-S optional shapefile output (requires gdal)


This command line script accepts 3 Arguments:

  • -s -> Location to services.txt file (see below for example)
  • -o -> Location to output directory to put files
  • -S -> OPTIONAL Output shapefile, will output geojson as well by default

for services.txt - use format [service_endpoint]|[title]|[throttle in ms]. Take note of the PIPE (|) symbol and new line.

 //example services.txt file

The throttle is helpful for very large extracts where servers may reject too many requests. The throttle number is in milliseconds.


Please contact TannerGeo for questions or assistance.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (69,935
gis (169
geojson (82
arcgis (28
gdal (20
shapefile (18