View results on a map

Plot your sample locations on a map and color each one by its screening outcome, then open a location to see its latest results. Use the Map when where a result occurs matters as much as the value — spotting an exceedance cluster, or confirming that a clean area stays clean.

Before you start

• Role required: access to view analysis data for the selected Projects or Sites. The Map shows only data within your authorized scope.
• Prerequisites: Lab Results for the Locations you want to map, and a primary spatial coordinate on each Location. To color markers by exceedance, you also need a Screening Criteria Set — see Screen results against criteria.
• The Map appears in Data Analysis only when an ArcGIS API key is configured on the deployment.
• Map features require your browser to have outbound HTTPS access to *.arcgis.com (the Erde server itself does not need internet access) — on air-gapped networks, maps are unavailable.

Steps

1. Go to Data Analysis → Map.

2. Select Open Filters to open the Analysis Filters panel.

3. Set your scope and data in the panel. The map needs a scope, at least one Location, and at least one Analyte before it can generate:

   Field	What to enter
   Scope by → Sites / Projects	Use the Scope by toggle to pick your primary axis (Sites by default), then choose one or more below. The other axis appears under Refine to narrow the scope (it lists only options that share data). Only sites/projects with committed lab results are listed.
   Locations	Select the Locations to map. Required.
   Analytes	Select the Analytes to show. Required.
   Matrices	Optional. Limit to a Matrix such as groundwater.
   Screening	Optional. Pick one or more Screening Criteria Sets to color markers by exceedance. Leave at None for neutral markers.
   Start Date / End Date	Optional. Limit to a sample-date range.

   Locations and Analytes are required (marked with a *) and start empty — pick at least one of each, or use Select all in scope in the Data section header to select them all at once. (The Map is the analysis/screening view, so it colors markers by analyte screening outcome and needs at least one analyte; to simply browse locations and boundaries, use the site map instead.)

4. Select Generate. The map loads, drops one marker per Location, and fits the view to show every marker.

5. Review the markers. Each Location is colored by its overall screening status (see Read the markers).

6. Select a marker to open its popup. The popup docks at the bottom-left and lists the Location's project, site, type, latest sample date, any per program and criteria-set exceedance counts, and a table of its most recent result per Analyte.

To map a different set, select Filters in the summary bar, adjust your selections, and select Generate again.

Read the markers

A marker shows one Location. When screening is active, its color is the Location's worst outcome across all selected criteria sets; with no screening selected, every marker is gray. A Screening legend in the corner lists the screening statuses.

Marker	Status	Meaning
Red	Exceedances Found	At least one result exceeds a screening level
Green	No Exceedances	All screened results are within limits
Orange	Partially Screened	At least one result has an applicable criterion that could not be compared (no screening level matched its matrix, unit, or fraction, or a non-detect had no recorded limit), and nothing exceeded.
Gray	Not Screened	No applicable screening result — shown only when such a Location exists

note

A detected result that reports only an EMPC contributes its EMPC to a marker's screening outcome instead of being dropped, so an EMPC-only exceedance can still color a marker; a non-detect's EMPC screens where the DMP is configured to use it.

The marker popup shows the latest result per Analyte at that Location within your date range, so its count can be smaller than the Location's full result history. When more than eight results are present, the popup table shows the first eight and notes how many more analytes exist. A qualifier shown beside a popup result is the result's validated qualifier only — an unvalidated result shows none — while its < limit or ND non-detect notation reads independently of any qualifier.

A separate Boundaries legend section adds a Show Boundaries toggle that draws each Site and site area boundary polygon on the map.

Result

The map displays one colored marker per mapped Location, fit to your selections. The corner legend explains the colors, and selecting any marker opens its result popup. Non-blocking notices above the map report anything left off — Locations with no usable coordinate, coordinate systems the server can't transform, or a result set truncated to the row cap.

The Map is a read-only spatial view. To see a result's full record, exceedance details, or to comment, use the Data Explorer or Crosstab, which open a result-detail panel on click.

Troubleshooting

Symptom	Cause	Resolution
Map is missing from the menu	No ArcGIS API key is configured	An administrator must configure an ArcGIS API key — enter it on the setup wizard's ArcGIS API Key step (the field is labeled API Key), or set the ArcGIS API Key field under Administration → System Settings → Integrations. Without a key, the Map tool is hidden.
Generate stays disabled	Scope, a Location, or an Analyte is not selected	Select a Project or Site, then at least one Location and one Analyte — the panel names the missing item next to the disabled button, or use Select all in scope.
A project or site you expected isn't in the Scope list	The scope dropdowns list only projects and sites that have committed lab results	Confirm results have been committed for it; scopes with nothing to map are hidden.
"No locations could be mapped for the selected criteria"	Results exist but no Location has a usable map coordinate	Add a primary spatial coordinate to the Locations, or check the coordinate-system notice above the map.
Fewer markers than expected	Some Locations lack a coordinate or use an unsupported coordinate system	Read the notices above the map; they count the affected Locations and name the ones missing a coordinate (site-qualified when they span sites) so you can add it.
All markers are gray	No Screening Criteria Set is selected	Pick a set in the Screening filter to color markers by exceedance.

Related

• Screen results against criteria
• Explore results in the Data Explorer
• Pivot results into a crosstab