ArcGIS Online is an ESRI cloud-based platform that allows users to synchronize and share GIS data while leveraging the full suite of ArcGIS mapping tools. EarthRanger can connect to an ArcGIS Online or ArcGIS Enterprise account, enabling the synchronization of map features without needing export/import workflows. EarthRanger imports point, line, and polygon vector data into features for map layer visualization, geo-fencing, fire alerts, deforestation alerts, and more.
Note: The following directions offer a basic workflow and may not cover all the capabilities of ArcGIS Online. For comprehensive information, please consult the ArcGIS Online documentation.
Before You Start
Complete all of the steps below including preparing and uploading your GIS layers before moving on to Configuring EarthRanger for ArcGIS Online Import. The integration setup depends on these being in place first; starting it early can result in a failed connection or an empty import.
Before configuring the ArcGIS Online integration in EarthRanger, make sure the following are in place, in this order:
- Your GIS files are prepared and uploaded as layers in ArcGIS Online. See Preparing GIS Files below for the format and attributes EarthRanger expects.
- Feature Types are set up in EarthRanger that correspond to the attributes in your GIS files. To review or add Feature Types, go to: Map Layers > Feature Types in the EarthRanger Admin panel.
- You have access to the EarthRanger Admin panel (https://your_organization.pamdas.org/admin).
Preparing GIS Files
Create geospatial files that represent the desired features of your protected area using your chosen GIS software. These files can describe vector features in the following formats:
- Polygons: Represent geographic areas such as park boundaries or operational regions.
- Lines: Represent linear features like roads or rivers.
- Points: Represent features such as outposts, gates, or watering holes.
Ensure that each geospatial file contains the following attributes:
- Name Attribute: A unique name for each feature.
- Feature Type Attribute: An attribute that corresponds to a Feature Type in EarthRanger (e.g., "Park Boundary," "Primary Roads," "Outposts").
Note: Use the same Name Attribute and Feature Type Attribute for all files being imported. Importing via ArcGIS Online does not require the projection to be EPSG:4326.
Once your files are ready and uploaded to ArcGIS Online, and your Feature Types are set up in EarthRanger, you're ready to configure the integration below
Configuring EarthRanger for ArcGIS Online Import
- In the EarthRanger Admin panel, navigate to: Map Layers > Feature Service Configurations.
- Click Add Feature Service Configuration in the top-right corner.
- Configure the following fields:
- Configuration Name: A friendly name for this import.
- Username: The ArcGIS Online account username.
- Password: The ArcGIS Online account password.
- Search Text: Typically leave blank. Contact EarthRanger support for usage guidance.
- Disable Import Feature Types: Leave unchecked to enable imports.
-
Optional Attributes:
- Service URL: Only needed for ArcGIS Enterprise configurations.
- Source: A friendly name for the source of these features.
- Type Field: The name of the Feature Type attribute.
- ID Field: The field for Global ID (rarely changed).
- Name Field: The name of the Name attribute.
- Click Save and Continue Editing.
- Click Test Connection to verify your credentials.
- In the Groups field, select the appropriate ArcGIS Online group.
- Click Save and Continue Editing.
- To manually import features, click Download Features.
- To view new features in EarthRanger, refresh the map and check the Map Layers.
Note: Features are automatically reloaded every night in addition to any manual downloads.
Data Synchronization
How often does this sync? EarthRanger automatically checks for updates from ArcGIS Online once every 24 hours. Changes made in your ArcGIS environment will appear in EarthRanger within that window without any action on your part.
If you need changes to appear sooner, you can trigger a manual import at any time: return to the Feature Service Configuration in the EarthRanger Admin panel and click Download Features. Once imported, refresh the map and check Map Layers to confirm the updated features are visible.
Feature Styling and Visualization
EarthRanger can also import the styling for features from ArcGIS Online, but note that ArcGIS does not export styles from the original GIS files. Instead, it uses the styles configured in the Visualization Layers.
Follow these steps to adjust the style:
- In ArcGIS Online, go to the Groups tab and select a content item.
- Click the Visualization tab.
- Click Change Style to modify the layer’s default style, filters, pop-ups, and labels.
- Click Options.
- Under Symbols:
- Fill Tab: Select the color and transparency.
- Outline Tab: Set the color, transparency, and line width (note: pattern support is unavailable).
- Click OK twice, then click Done.
- Click Save Layer in the top corner.
If necessary, return to the EarthRanger Admin page and click Download Features to update the visualization in EarthRanger.
