Get Compass Bearing in Field Maps

[JustinAnderson4]

Is it possible to get the compass bearing of the device when collecting a point so that it reads as text i.e., "northwest," "north," "south," etc.? If so, can someone please so me how to make this happen?

[JustinReynolds]

Hello,

Here is one way to do it.

This assumes that the feature layer schema includes gnss metadata fields and that the method of geometry capture used a gnss receiver (i.e. not user defined or snapped).  You can now force users to use a gnss receiver in the map settings. This would be a form calculation on a field of interest configured for Field Maps.

function directionDesc(direction /* text */) {
  return Decode(direction, 
                'N', 'north', 
                'NNE', 'North-northeast',
                'NE', 'northeast',
                'ENE', 'East-northeast',
                'E', 'east',
                'ESE', 'East-northeast',
                'SE', 'southeast',
                'SSE', 'South-southeast',
                'S', 'south', 
                'SSW', 'South-southeast',
                'SW', 'southwest',
                'WSE', 'West-southwest',
                'W', 'west', 
                'WNW', 'West-northwest',
                'NW', 'northwest',
                'NNW', 'North-northwest',
                'Unhandled')
};
  
function degToDirection(deg /* number */, numDivisions /* number (4, 8, 16) */) {
  if (IndexOf([4, 8, 16], numDivisions) != -1) {
    var divSize = 360 / numDivisions; 
    var val = Floor((deg / divSize) + 0.5) % numDivisions + 1;

    var arr;
    var arr4 = ['N', 'E', 'S', 'W'];
    var arr8 = ['N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW'];
    var arr16 = ['N', 'NNE', 'NE', 'ENE', 'E','ESE', 'SE', 'SSE', 
                'S', 'SSW', 'SW', 'WSW', 'W','WNW', 'NW', 'NNW'];

    if (numDivisions == 4) {arr = arr4};
    var eight = 8 // because my browser keeps converting "8)" to an emoji! on the line below
    if (numDivisions == eight) {arr = arr8};
    if (numDivisions == 16) {arr = arr16};

    var idx = IIf(val == 0, 1, val);
    var direction = arr[idx - 1];

    Console(Concatenate(Text(deg, '000'), ': ', direction));
    // Console(Concatenate(Text(deg, '000'), ': ', directionDesc(direction)));
    // Console(Concatenate(Text(deg, '000'), ': ', directionDesc(direction), ' (', direction, ')'));

    return directionDesc(direction);
  };
  return 'The value passed to numDivisions parameter is out of bounds!  Expecting 4, 8, or 16.'
};

/* 
  This assumes that the feature layer schema includes gnss metadata fields
  and that the method of geometry capture used a gnss reciever (i.e. not user defined or snapped).
  You can now force users to use a gnss reciever in the map settings.
*/ 
if (!IsEmpty($feature.esrisnsr_azimuth)) {return degToDirection($feature.esrisnsr_azimuth, 16)};

/////////////////////////////////////////////////

// Division breaks for each division size  
Console('______ 16 Divisions ________');
degToDirection(349, 16);
degToDirection(11, 16);
degToDirection(12, 16);
degToDirection(33, 16);
degToDirection(34, 16);
degToDirection(56, 16);
degToDirection(57, 16);
degToDirection(78, 16);
degToDirection(79, 16);
degToDirection(101, 16);
degToDirection(102, 16);
degToDirection(123, 16);
degToDirection(124, 16);
degToDirection(146, 16);
degToDirection(147, 16);
degToDirection(168, 16);
degToDirection(169, 16);
degToDirection(191, 16);
degToDirection(192, 16);
degToDirection(213, 16);
degToDirection(214, 16);
degToDirection(236, 16);
degToDirection(237, 16);
degToDirection(258, 16);
degToDirection(259, 16);
degToDirection(281, 16);
degToDirection(282, 16);
degToDirection(303, 16);
degToDirection(304, 16);
degToDirection(326, 16);
degToDirection(327, 16);
degToDirection(348, 16);
degToDirection(349, 16);
degToDirection(371, 16);
degToDirection(372, 16);

Console('______ 8 Divisions ________');
degToDirection(338, 8);
degToDirection(22, 8);
degToDirection(23, 8);
degToDirection(67, 8);
degToDirection(68, 8);
degToDirection(112, 8);
degToDirection(113, 8);
degToDirection(157, 8);
degToDirection(158, 8);
degToDirection(202, 8);
degToDirection(203, 8);
degToDirection(247, 8);
degToDirection(248, 8);
degToDirection(292, 8);
degToDirection(293, 8);
degToDirection(337, 8);
degToDirection(338, 8);
degToDirection(382, 8);
degToDirection(383, 8);

Console('______ 4 Divisions ________');
degToDirection(315, 4);
degToDirection(44, 4);
degToDirection(45, 4);
degToDirection(134, 4);
degToDirection(135, 4);
degToDirection(224, 4);
degToDirection(225, 4);
degToDirection(314, 4);
degToDirection(315, 4);
degToDirection(404, 4);
degToDirection(405, 4);

-- Output --
East-northeast

______ 16 Divisions ________
349: N
011: N
012: NNE
033: NNE
034: NE
056: NE
057: ENE
078: ENE
079: E
101: E
102: ESE
123: ESE
124: SE
146: SE
147: SSE
168: SSE
169: S
191: S
192: SSW
213: SSW
214: SW
236: SW
237: WSW
258: WSW
259: W
281: W
282: WNW
303: WNW
304: NW
326: NW
327: NNW
348: NNW
349: N
371: N
372: NNE
______ 8 Divisions ________
338: N
022: N
023: NE
067: NE
068: E
112: E
113: SE
157: SE
158: S
202: S
203: SW
247: SW
248: W
292: W
293: NW
337: NW
338: N
382: N
383: NE
______ 4 Divisions ________
315: N
044: N
045: E
134: E
135: S
224: S
225: W
314: W
315: N
404: N
405: E