This is a node application that uses tileify-ags to create a simple proxy for serving up regular old, uncached ArcGIS Server map services as map tiles that can be easily added to any slippy map (Leaflet, OpenLayers, Google Maps).
cd /path/to/tileify-ags-proxy
npm install
npm start
Click this button.
The Procfile
makes this application easy to deploy to heroku.
cd /path/to/tileify-ags-proxy
heroku create
git push heroku master
After running your application visit the application root (https://localhost:5000/
) for some documentation and an interactive demo.
The tiling proxy can be found at https://localhost:5000/tiles/{z}/{x}/{y}
. Those funny looking letters are placholders for the tiles located at specific zoom levels and coordinates. Your mapping library should automatically replace these with actual values at runtime.
There is one required URL parameter to add, url
. This is the ArcGIS Server map server endpoint and will look something like:
https://maps.ci.charlotte.nc.us/arcgis/rest/services/WEB/BaseMap/MapServer
This value you add to the URL should be URL encoded!
You can URL encode by doing:
var ags_url = 'https://maps.ci.charlotte.nc.us/arcgis/rest/services/WEB/BaseMap/MapServer';
var encoded = encodeURIComponent(ags_url);
console.log(encoded);
// http%3A%2F%2Fmaps.ci.charlotte.nc.us%2Farcgis%2Frest%2Fservices%2FWEB%2FBaseMap%2FMapServer
An example URL looks like:
https://localhost:5000/{z}/{x}/{y}?url=http%3A%2F%2Fmaps.ci.charlotte.nc.us%2Farcgis%2Frest%2Fservices%2FWEB%2FBaseMap%2FMapServer
ArcGIS Server ImageServer services are also supported. Instead of using the MapServer
services as seen above, just use ImageServer
:
https://gisdev.lakecountyfl.gov/lakegis/rest/services/Aerial2014/ImageServer
In addition to the required url
URL parameter, you can also pass a &redirect=true
parameter that will perform an HTTP redirect to the map server instead of serving it itself.
Also accepted are the URL parameters supported by ArcGIS Server. Some of these that you might find valuable are:
transparent
- Helpful for overlay layers where you want to see stuff that's underneath. Set totrue
for anything other than a base map.layers
- Which specific layers from the map service you want in your map tiles.format
- Switch between png and jpg formats.
I've deployed an instance of this application at Heroku. You're free to use it as you wish. In the examples above just use the tileify-ags.herokuapp.com
domain instead of localhost:5000
.