Dalmierze mogą być używane do rejestrowania informacji o lokalizacji, przesunięciu i wysokości obiektu docelowego. Dalmierze są zazwyczaj używane w następujących sytuacjach:
- Podczas tworzenia mapy z lokalizacją obiektu, który jest niedostępny, ponieważ trudno się do niego dostać lub dotarcie do niego nie jest bezpieczne. Może to być na przykład drzewo na wysepce lub właz na środku ruchliwej drogi.
- Podczas tworzenia mapy z lokalizacją obiektu, gdzie nie jest możliwe uzyskanie sygnału GPS lub pozycji GPS o wystarczającej dokładności. Może to być na przykład miejsce pod dużym drzewem, przy wąskiej ulicy lub w „miejskim kanionie”.
Przygotowanie ankiety do rejestrowania pomiarów
Najpierw należy zdecydować, które pomiary będą rejestrowane.
Jako minimum należy utworzyć pytanie typu text (tekst) z wyglądem rangefinder, aby przechowywać wartości zwracane z dalmierza. To pytanie może być pytaniem typu text (tekst), jeśli rejestrowanych jest wiele pomiarów dalmierzem (zapisany zostanie cały obiekt JSON), lub pytaniem typu integer (liczba całkowita) lub decimal (liczba dziesiętna), jeśli rejestrowany jest tylko jeden pomiar (zapisana zostanie pojedyncza wartość liczbowa).
Typy pomiarów są określane w kolumnie bind::esri:parameters za pomocą ciągu znakowego measurement=, po którym następuje oddzielona przecinkami lista parametrów, na przykład measurement=height,azimuth,horizontalDistance,slopeDistance,inclination.
Procedura wielokrotnego pomiaru wysokości może być również przeprowadzona na strukturze pionowej przy użyciu parametru multipleHeight, po którym następuje oddzielona przecinkami lista etykiet wysokości. Listę parametrów należy ująć w cudzysłów, jeśli którakolwiek z etykiet wysokości zawiera spacje, na przykład measurement="multipleHeight,Height 1,Height 2,Height 3". Procedury wielokrotnego pomiaru wysokości nie mogą być łączone z innymi wartościami pomiarowymi; mogą być używane tylko oddzielnie.
Dodatkowe pytania typu text (tekst) w ankiecie mogą przechowywać indywidualne pomiary. Należy użyć funkcji pulldata, aby wydzielić właściwości z obiektu JSON zwracanego przez dalmierz. Na przykład następująca funkcja zwróci tylko wartość kierunku (azymut): pulldata("@json",${tree},"azimuth").
Poniżej znajduje się przykład obiektu JSON zwróconego przez dalmierz. Każda z tych właściwości może być pobrana i zapisana w pytaniu za pomocą wyrażenia pulldata podobnego do podanego powyżej:
{
"referenceCoordinates": {
"latitude":-37.8479578,
"longitude":144.9792849
},
"targetCoordinates": {
"latitude":-37.847956857525,
"longitude":144.979303248161
},
"height":0.6,
"heightUnits":"m"
"horizontalDistance":2.1,
"horizontalDistanceUnits":"m",
"slopeDistance":2.1,
"slopeDistanceUnits":"m",
"azimuth":50.1,
"azimuthUnits":deg",
"inclination":-4.4,
"inclinationUnits":"deg",
"heightArray":[0.6,0.9,1.1,1.4,2]
}Po uruchomieniu ankiety zawierającej pytania z wyglądem rangefinder użytkownik zobaczy ikonę dalmierza obok pytania. Aby zarejestrować pomiar, należy dotknąć ikony, uruchomić dalmierz i powrócić do ankiety, aby wypełnić pozostałe pytania.
Przygotowanie ankiety do wykorzystania w procedurze wykonywania zadań
Ankietę można skonfigurować alternatywnie, aby umożliwić jej wybranie z kafla Dalmierz w galerii aplikacji Survey123.
Kafel dalmierza nadaje się do powtarzalnych projektów zbierania danych, w których pomiary dalmierzem stanowią zbiorcze dane wejściowe do ankiety. Wiele ankiet można skonfigurować tak, aby akceptowały pomiary dalmierzem i można je wybrać w momencie zbierania.
Aby skonfigurować ankietę tak, aby pojawiała się na liście ankiet kafla dalmierza, należy dodać jedną z poniższych wartości do kolumny bind::esri:workflow:
- rangefinderMode=height
- rangefinderMode=offset
- rangefinderMode=height,offset
- rangefinderHeight
Ten parametr poinformuje aplikację, która procedura wykonywania zadań z użyciem dalmierza jest uruchamiana, a następnie zapisze zwrócony obiekt JSON w powiązanym pytaniu typu text (tekst). Pytania te mogą być ukryte w ankiecie przy użyciu wyglądu hidden (ukryty), a poszczególne wartości pomiarów mogą być przechowywane w dodatkowych pytaniach.
Procedurę wykonywania zadań wielokrotnego pomiaru wysokości można również skonfigurować z ustawieniem rangefinderMode=height, dołączając pytanie typu text (tekst) wraz z dodatkowymi pytaniami typu decimal (liczba dziesiętna) w celu zapisania każdej wartości wysokości. Należy nadać każdemu pytaniu typu decimal (liczba dziesiętna) wartość rangefinderHeight w kolumnie bind::esri:workflow formularza XLSForm.
Dodatkowe pytania w ankiecie mogą przechowywać inne indywidualne wartości pomiarów. Należy użyć funkcji pulldata, aby wydzielić właściwości z obiektu JSON zwracanego przez dalmierz, jak to opisano w sekcji Przygotowanie ankiety do rejestrowania pomiarów.