Connect with an ESRI Map Layer

The "Connect with an ESRI Map Layer" option allows you to import a map layer you host on your ESRI Server onto the Socrata platform. This way the map is maintained on your end and the changes are reflected on the Socrata instance.

In addition to ESRI Extension, Socrata has built out the Catalog Connector for ArcGIS Server. This new feature allows administrators to connect a public ArcGIS Server to your Socrata catalog and choose the layers to federate to your Socrata catalog as external datasets. 

Requirements to connect an ESRI Map Layer:

  • You must use a Socrata Open data portal which has ESRI Extensions configured. If you are a customer and are not sure if this included in your plan, contact your account manager. The actual configuration is set up by a Customer Success member. 
  • The map type in ArcGIS must be a Map Server Layer. Currently, the platform does not support Feature Server layers.
  • Your ArcGIS server needs to run on an https SSL cert. If not, most browsers will reject the non-authenticated content coming from the ESRI layer on our http ArcGIS RESTful service. For information on setting up a successful HTTPS SSL cert for your ArcGIS server, please follow this link
  • You must have ArcGIS 10.0+, and provide an REST and SOAP endpoint which we point at.
  • The map you host via Extensions can have points, lines and polygons in different layers.
  • The map is controlled and updated by the your server, which Socrata will call every time a user loads the page.
  • With the Esri ArcGIS Extensions it's necessary for you to set up your services to reproject on the fly into WGS84/Web Mercator, which is one of the features of ArcGIS 10.x.

Connecting an ESRI Map Layer:

1. From the internal navigation bar, click on the Create dropdown and select Esri Map Layer.


2. Next you add in the ESRI Map Layer URL, which acts as a reference pointing to the map hosted on your server:


This is the only mandatory field required. You can choose to upload an attachment, which can be a document with a legend explaining the different components and customization we may include in your map. Like with any other dataset, you can opt to make your map public right off the bat or private (this can be configured under 'Edit Metadata' later on and also the contact email which is who is contacted when someone sends in a message to the dataset owner, also done through the About panel).

Additional Information

  • ESRI Extensions allows maps to have customized point, line and boundary color which must be configured at the ArcGIS Server Endpoint. These maps cannot be customized through the data portal.
  • If your map contains multiple layers, our platform divides these layers into individual datasets/maps - you will need to add the layers to the maps to combine into one map.
  • Note: if the url for the map changes then the map will no longer work and will need to be reuploaded.

Things to Know When Updating my ESRI Server

When the customer updates its ESRI Server, their maps may stop working until we manually update the entries on our end.

When there are updates to column names, the map will also be impacted. You can replace the map however, this must be completed by the same user who initially creates the dataset. If it's not the same user who initially created the dataset, we will create a new identifier (4x4) rather than reusing the existing one. 


If your ESRI Connected Map is no longer displaying flyouts, it is possible that the schema of your ESRI dataset has changed by deleting a column. In order to refresh the schema on your existing ESRI Connected Map, all you need to do is "reconnect" the ESRI Connected map. You can do this by going to your profile, select create a dataset, then select the ESRI Connected Map option, then add the same ArcGIS endpoint, and instead of creating a new dataset it will refresh the schema of the existing one.



Was this article helpful?
2 out of 2 found this helpful
Have more questions? Submit a request



Article is closed for comments.