Esri Field Maps Integration

This guide explains how to configure ArcGIS Field Maps to launch Utility Scout for pole measurements and display the returned measurement data.

Overview

The integration works in two parts:

1. Launch Link - An Arcade expression that creates a clickable link in Field Maps to launch Utility Scout with the selected feature's location and identifiers

2. Measurement Display - An Arcade expression that parses and displays the measurement data returned from Utility Scout

---

Prerequisites

Before configuring Field Maps, ensure:

• Your feature layer has the following fields:

  • measurement_json (String, length 4000+) - Stores the measurement data JSON

  • utility_scout_link (String) - Stores the link to view measurements in the web portal

• You can name these fields whatever you want- but the name must be updated in the arcade expressions

• Utility Scout is installed on the device

• You have the Item ID of your ArcGIS Online/Portal hosted feature layer

---

Part 1: Creating the Launch Link

This Arcade expression creates a clickable link that launches Utility Scout with the necessary context to perform a measurement.

Step-by-Step Setup

1. Open your Web Map in ArcGIS Online or Portal

2. Navigate to the Pop-up configuration for your poles layer

3. Add a new Arcade Expression element

4. Paste the following expression:

  // ============================================
  // Utility Scout Launch Link - Arcade Expression
  // ============================================

  // Get layer and feature information
  var layerInfo = GetFeatureSetInfo($layer);
  var globalID = $feature.GlobalID;
  var featureSourceURL = layerInfo.serviceLayerUrl;

  // IMPORTANT: Replace with your actual Item ID
  var itemID = "YOUR_ITEM_ID_HERE";

  // Get feature geometry
  var geom = Geometry($feature);
  var lat = geom.y;
  var lon = geom.x;

  // Convert from Web Mercator (EPSG:3857) to WGS84 (EPSG:4326)
  // This conversion is required if your data is stored in Web Mercator
  var latWgs = (Atan(Exp(lat / 6378137)) * 360 / PI) - 90;
  var lonWgs = (lon / 6378137) * (180 / PI);

  // Dynamic button text based on existing measurement
  var text = "Measure In Utility Scout";
  if (!IsEmpty($feature.measurement_json)) {
      text = "Re-Measure In Utility Scout";
  }

  // Build the URL scheme link
  var link = "utilityscout://open?globalID=" + UrlEncode(globalID)
      + "&itemID=" + itemID
      + "&featureSourceURL=" + UrlEncode(featureSourceURL)
      + "&lat=" + latWgs
      + "&long=" + lonWgs
      + "&measureJsonFieldName=measurement_json"
      + "&urlFieldName=utility_scout_link"
      + "&mapName=comcast-5781";

  // Return clickable HTML link
  return {
      type: 'text',
      text: '<a href="' + link + '">' + text + '</a>'
  };

There is likely a way to get the itemID dynamically via arcade features & variables. You can also get this id from the url

Parameter	Description	Example
itemID	Your ArcGIS Online/Portal Item ID for the feature layer	"59d2d97d865b4e7cb11609fe7295273e"
globalID	Automatically retrieved from the selected feature	Auto-populated
featureSourceURL	The REST endpoint of your feature service layer	Auto-populated
lat / long	WGS84 coordinates of the feature	Auto-calculated
measureJsonFieldName	the name of the field to store the measurement json	measurement_json
urlFieldName	the name of the field to store measure url	utility_scout_link
mapName	the human readable name of the map	comcast-5781

---

Part 2: Displaying Measurement Data

This Arcade expression parses the measurement_json field and displays a formatted summary of the measurement results.

Step-by-Step Setup

1. In the same pop-up configuration, add another Arcade Expression

2. Paste the following expression:

// ============================================
  // Measurement Data Display - Arcade Expression
  // ============================================

  // Check if measurement data exists
  if (IsEmpty($feature.measurement_json)) {
      return {
          type: 'text',
          text: 'No measurements available'
      };
  }

  // Parse the JSON data
  var data = FromJSON($feature.measurement_json);

  if (data == null) {
      return {
          type: 'text',
          text: 'Invalid measurement data'
      };
  }

  // ---- Extract Pole Information ----
  var poleInfo = data.pole_information;

  // Pole Height (convert meters to feet/inches if needed)
  var heightMeters = poleInfo.height;
  var heightFeet = Floor(heightMeters * 3.28084);
  var heightInches = Round((heightMeters * 3.28084 - heightFeet) * 12, 0);
  var poleHeight = heightFeet + " ft " + heightInches + " in";

  // Lean Angle
  var leanAngle = Round(poleInfo.lean_angle, 2);

  // Lean Direction (compass bearing)
  var leanDirection = Round(poleInfo.lean_direction, 0);

  // GPS Accuracy (if available)
  var gpsAccuracy = "";
  if (poleInfo.location != null &&
      poleInfo.location.additional_properties != null &&
      poleInfo.location.additional_properties.horizontal_accuracy != null) {
      gpsAccuracy = Round(poleInfo.location.additional_properties.horizontal_accuracy.value, 2) + "m";
  }

  // ---- Extract Attachments ----
  var attList = data.attachments;
  var attCount = Count(attList);

  // Build attachment summary
  var attachmentText = "";
  for (var i = 0; i < attCount; i++) {
      var att = attList[i];
      var height = Round(att.calculatedHeight, 2);
      var classification = att.classification;

      // Get inventory details if available
      var details = "";
      if (att.inventoryClass != null && Count(att.inventoryClass.subcategories) > 0) {
          details = " (" + att.inventoryClass.subcategories[0].value + ")";
      }

      attachmentText += "  • " + classification + details + " @ " + height + " ft\n";
  }

  // ---- Build Output ----
  var output = "━━━ POLE MEASUREMENTS ━━━\n\n";
  output += "📏 Height: " + poleHeight + "\n";
  output += "📐 Lean Angle: " + leanAngle + "°\n";
  output += "🧭 Lean Direction: " + leanDirection + "°\n";

  if (!IsEmpty(gpsAccuracy)) {
      output += "📍 GPS Accuracy: " + gpsAccuracy + "\n";
  }

  output += "\n━━━ ATTACHMENTS (" + attCount + ") ━━━\n";
  if (attCount > 0) {
      output += attachmentText;
  } else {
      output += "  No attachments recorded\n";
  }

  return {
      type: 'text',
      text: output
  };

---

Measurement JSON Structure

For reference, here's the structure of the measurement_json data returned by Utility Scout:

  {
    "pole_information": {
      "height": 6.91,
      "lean_angle": 2.5,
      "lean_direction": 145.0,
      "location": {
        "latitude": 39.123456,
        "longitude": -104.654321,
        "additional_properties": {
          "horizontal_accuracy": { "value": 2.5 },
          "vertical_accuracy": { "value": 3.0 }
        }
      }
    },
    "attachments": [
      {
        "classification": "Transformer",
        "calculatedHeight": 7.62,
        "inventoryClass": {
          "subcategories": [
            { "value": "Single Phase" }
          ]
        }
      },
      {
        "classification": "Communication",
        "calculatedHeight": 5.48,
        "inventoryClass": {
          "subcategories": [
            { "value": "Fiber Optic" }
          ]
        }
      }
    ]
  }

---

Troubleshooting

Link doesn't open Utility Scout

• Verify Utility Scout is installed on the device

• Check that the URL scheme utilityscout:// is correct

• Ensure all parameters are properly URL-encoded

Coordinates are incorrect

• Verify your data's spatial reference

• The Arcade expression assumes Web Mercator (EPSG:3857) - modify the conversion if using a different projection

Measurement data not displaying

• Check that the measurement_json field has sufficient length (4000+ characters recommended)

• Verify the field name matches exactly in the Arcade expression

• Use Console() statements to debug JSON parsing issues

"Invalid measurement data" error

• The JSON may be malformed or truncated

• Check field length limitations

• Verify Utility Scout completed the sync successfully

---