Pytania typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny) umożliwiają rejestrowanie polilinii lub poligonu na mapie. Można używać tej geometrii zamiast punktu dla wynikowego obiektu w warstwie obiektowej.
W przeciwieństwie do pytań typu geopoint (punkt geograficzny) lub zbierania informacji o lokalizacji bez pytań o lokalizację, w pytaniach typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny) do wypełnienia odpowiedzi nie jest używana lokalizacja urządzenia. Lokalizacja urządzenia jest używana tylko do wyśrodkowania mapy.
Jeśli pytanie typu geotrace (ślad geograficzny) lub geoshape (kształt geograficzny) pozostanie bez odpowiedzi, a jego geometria nie została utworzona na podstawie wartości domyślnej lub wyrażenia, rekord ankiety będzie przesyłany do warstwy obiektowej z geometrią zerową.
Notatka:
Do ankiety można dodać wiele pytań typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) lub geoshape (kształt geograficzny), jednak tylko jednego z nich można użyć jako geometrii rekordu ankiety. Można użyć wielu pytań typu map (mapa), jeśli wszystkie poza jednym mają parametr bind::esri:fieldType ustawiony na wartość null.
Każde powtórzenie w ankiecie również może mieć więcej niż jedno pytanie typu geopoint (punkt geograficzny), geotrace (ślad geograficzny) lub geoshape (kształt geograficzny), jednak tylko jednego z nich można użyć jako geometrii rekordu powtórzenia. Wiele pytań typu map (mapa) można użyć z tą samą metodą opisaną powyżej.
Podczas rejestrowania pytań typu geotrace (ślad geograficzny) lub geoshape (kształt geograficzny) z użyciem mapy nie wszystkie funkcje aplikacji terenowej Survey123 są obsługiwane w aplikacji internetowej. Następujące funkcje są obsługiwane w aplikacji terenowej Survey123, ale nie w aplikacji internetowej:
- Mapy bazowe w trybie offline
- Opcje stylu udostępnione na potrzeby pytań typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny)
- Obliczenia w pytaniach typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny) z uwzględnieniem funkcji sum().
- Progi dokładności lokalizacji i wyrażenia określające jakość lokalizacji
Metody rejestrowania
Ślady geograficzne i kształty geograficzne można rejestrować dwiema metodami: szkic i wierzchołek. Metoda szkicu jest używana domyślnie w przypadku ankiet tworzonych od podstaw, natomiast metoda wierzchołka jest używana domyślnie w przypadku ankiet tworzonych na podstawie istniejącej warstwy obiektowej. Inną metodę rejestrowania można skonfigurować w ankiecie, wprowadzając parametry method=sketch lub method=vertex w kolumnie body::esri:style pytania.
Szkic
Metoda szkicu służy do rejestrowania geometrii jednym płynnym ruchem — rejestrowanie kończy się, gdy użytkownik przestanie rysować tę pojedynczą linię.
Więcej informacji o sposobie używania tej metody zawiera temat Szkic.
Wierzchołek
Metoda wierzchołka umożliwia bardziej precyzyjne geometryczne rejestrowanie linii lub kształtu przez rozmieszczenie wierzchołków, które się ze sobą łączą.
Więcej informacji o sposobie używania tej metody zawiera temat Wierzchołek.
Istnieją następujące parametry sterujące zachowaniem przy rejestrowaniu wierzchołków:
- beep lub nobeep — jeśli skonfigurowano beep, każde zarejestrowanie wierzchołka będzie wiązało się z powiadomieniem dźwiękowym. Jeśli nie zostanie podany ten parametr, wartością domyślną jest nobeep.
- haptic lub nohaptic — jeśli skonfigurowano haptic, każde zarejestrowanie wierzchołka będzie wiązało się z powiadomieniem haptycznym. Jest to obsługiwane tylko w przypadku sprzętu z obsługą powiadomień haptycznych. Jeśli nie zostanie podany ten parametr, wartością domyślną jest nohaptic.
- edit lub noedit — jeśli skonfigurowano noedit, użytkownicy będą mogli rejestrować wierzchołki tylko w ich bieżącej lokalizacji, cofać umieszczenie każdego wierzchołka i zastępować całą linię lub poligon. Użytkownicy nie mogą edytować pojedynczego wierzchołka. Jeśli nie zostanie podany ten parametr, wartością domyślną jest edit.
- streaming lub nostreaming — wierzchołki linii lub poligonu mogą być strumieniowane podczas przemieszczania. Jeśli nie zostanie podany ten parametr, wartością domyślną jest nostreaming.
W poniższym przykładzie skonfigurowano metodę rejestrowania jako strumieniowanie wierzchołków z powiadomieniem dźwiękowym:
method=vertex,streaming,beep
Autor ankiety może skonfigurować odległość między przylegającymi, strumieniowanymi wierzchołkami. Domyślnie wierzchołki są rejestrowane co 10 metrów, ale można to zmodyfikować za pomocą parametru distanceThreshold. Ten parametr jest oddzielony spacją w kolumnie body::esri:style. Można podać również inne parametry, które definiują kolor linii lub kształtu.
W poniższym przykładzie wierzchołki są rejestrowane co 25 metrów i tworzona jest czerwona linia:
method=vertex,streaming,beep distanceThreshold=25 lineColor=red
Jeśli w przypadku rejestrowanych wierzchołków ważna jest dokładność pozycji, wprowadzenie wartości progowej dokładności w kolumnie body::accuracyThreshold pytania typu geotrace (ślad geograficzny) lub geoshape (kształt geograficzny) zapobiega rejestrowaniu wierzchołków niespełniających warunku progowego.
Wartości domyślne i wyrażenia
Istnieje możliwość skonfigurowania domyślnej geometrii na potrzeby pytań typu geotrace (ślad geograficzny) lub geoshape (kształt geograficzny) bądź użycia wyrażenia do utworzenia geometrii na podstawie wyników innych pytań. Poszczególne wierzchołki, które składają się na odpowiedź na pytanie typu geotrace (ślad geograficzny) lub geoshape (kształt geograficzny), są oddzielonymi od siebie przestrzennie zestawami wartości długości i szerokości geograficznej (w stopniach dziesiętnych) rozdzielonymi średnikami. Wypełniając odpowiedź na pytanie typu geotrace (ślad geograficzny) lub geoshape (kształt geograficzny), należy stosować się do tej struktury, dzięki czemu przygotowana odpowiedź będzie prawidłowa. Uzyskanie dokładnych lokalizacji może wymagać, aby te wartości były duże. Na przykład następujące wartości w kolumnie default (wartość domyślna) pytania typu geoshape (kształt geograficzny) powodują wyświetlenie kształtu wokół parku w Melbourne w Australii:
-37.842156723211474 144.95942945338243; -37.83554486071995 144.9726235713864; -37.85681405373047 144.98240735651922; -37.85954045531896 144.97715349053766
Wskazówka:
Przyjęcie domyślnej lokalizacji geograficznej na obszarze półkuli południowej spowoduje błąd w programie Microsoft Excel, ponieważ taka wartość jest odczytywana jako formuła, gdyż rozpoczyna się znakiem minus (-). W takim przypadku przed pierwszą wartością należy umieścić znak apostrofu, dzięki czemu program Excel odczyta ją prawidłowo. Dodanie znaku apostrofu nie powoduje zmian w działaniu aplikacji Survey123.
Ponieważ nie można wstawić tych wartości bezpośrednio podczas wypełniania na podstawie pytań typu select_one (wybierz jedną), zaleca się użycie funkcji substr() w kolumnie calculation (obliczenie) jako pomocy podczas tworzenia prawidłowej odpowiedzi. Na przykład nazwą odpowiedzi na pytanie typu select_one (wybierz jedną) może być:
+059.38330_+018.66300
W przypadku tej odpowiedzi jest używana stała liczba znaków zarówno dla szerokości, jak i długości geograficznej wraz z zerami, które zwykle są obcinane. Między tymi dwiema wartościami znajduje się znak podkreślenia, ponieważ w kolumnie name (nazwa) nie są dozwolone spacje. Wartość wynikowa może zostać przekształcona przy użyciu funkcji substr() w celu wypełnienia następującego przykładowego pytania typu geotrace (ślad geograficzny) z dwoma wierzchołkami:
substr(${previous_question1}, 0, 10) + " " + substr(${previous_question1}, -10) + "; " + substr(${previous_question2}, 0, 10) + " " + substr(${previous_question2}, -10)
W tym przykładzie jest pobierane pierwsze 10 znaków dwóch różnych wartości (szerokości geograficznych) oraz ostatnie 10 znaków (długości geograficznych). Następnie wartości te są prezentowane w postaci szerokości geograficznych i długości geograficznych rozdzielonych spacją. Prawidłowe lokalizacje tworzące wynikowy ślad geograficzny są rozdzielone średnikami.
Można również użyć funkcji agregującej sum(), aby zestawić kilka wartości punktów geograficznych w powtórzeniu w celu ich użycia jako wierzchołków wynikowego śladu geograficznego lub kształtu geograficznego. Pozwala to użytkownikom rejestrować metadane lokalizacji dla każdego wierzchołka geometrii. Więcej informacji na ten temat zawiera sekcja Funkcje agregujące.
Pytania typu geotrace (ślad geograficzny) lub geoshape (kształt geograficzny) nie rejestrują natychmiast lokalizacji, ale lokalizacja urządzenia jest używana do wyśrodkowywania mapy podczas wczytywania ankiety. Aby temu zapobiec, ustaw wartość domyślną jako null. Zamiast tego będą wyświetlane opcje włączenia gromadzenia lokalizacji, wczytania strony mapy w celu ręcznego skonfigurowania lokalizacji lub odświeżenia obliczeń, jeśli do pytania zastosowano obliczenie.
Geowyszukiwanie
Dla pytań typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny) jest obsługiwana funkcja geowyszukiwania. Umożliwia ona użytkownikom wyszukiwanie adresu lub punktu zainteresowania, powiększanie mapy do tej lokalizacji i ustawianie w niej wierzchołka.
Domyślnie funkcja geowyszukiwania zwraca wyniki z całego świata. Adresy są wyszukiwane przy użyciu narzędzia ArcGIS Geocoding service.
Notatka:
Geokodowanie przy użyciu aplikacji ArcGIS Geocoding service spowoduje zużycie kredytów. Więcej informacji można znaleźć w temacie Informacje o kredytach.Aby skonfigurować konkretny lokalizator, z którego mają być zwracane wyniki, należy podać identyfikator elementu lokalizatora w kolumnie bind::esri:parameters, na przykład geocode=36ff9e8c13e042a58cfce4ad87f55d19. Lokalizator używany w ankiecie ArcGIS Online musi być elementem w usłudze ArcGIS Online. Lokalizator używany w ankiecie ArcGIS Enterprise musi być elementem w tym samym portalu co ankieta.
Atrybuty geometryczne
Pytań typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny) można również używać w obliczeniach wykonywanych w celu wyświetlania i rejestrowania atrybutów geometrii, takich jak długość (w przypadku śladu geograficznego) i obwód oraz pole powierzchni (w przypadku kształtu geograficznego). Do tworzenia wyrażeń w pytaniach typu geotrace (ślad geograficzny) lub geoshape (kształt geograficzny) można używać funkcji distance() i area(). Funkcja distance() zwraca wynik w metrach, a funkcja area() zwraca wynik w metrach kwadratowych. Przykłady obliczeń, w których te wyniki są przekształcane na inne jednostki, można znaleźć w przykładzie użycia śladu geograficznego i kształtu geograficznego w aplikacji Survey123 Connect.
Symbolizacja geometrii
Istnieje możliwość dodania stylu na potrzeby pytań typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny) wyświetlanych w ankiecie. Ten styl można skonfigurować za pomocą następujących parametrów w kolumnie body::esri:style pytań typu geotrace (ślad geograficzny) i geoshape (kształt geograficzny):
- lineColor
- lineWidth
- fillColor
Kolory można określać przy użyciu standardowych nazw kolorów HTML lub szesnastkowych kodów kolorów. Przezroczystość można konfigurować przy użyciu 8-znakowych szesnastkowych kodów kolorów. Jeśli parametrów jest kilka, należy je rozdzielić znakami spacji (np. lineColor=Black fillColor=#800000FF lineWidth=3).
Notatka:
Parametry lineColor i lineWidth są obsługiwane zarówno w pytaniach typu geotrace (ślad geograficzny), jak i w pytaniach typu geoshape (kształt geograficzny). Parametr fillColor jest obsługiwany tylko w przypadku pytań typu geoshape (kształt geograficzny).
Te opcje stylu są wyświetlane tylko w aplikacji Survey123 Connect i aplikacji terenowej Survey123.
Lokalizacje punktów z pierwszego pytania typu geopoint (punkt geograficzny) w powtórzeniu mogą zostać wyświetlone na dowolnej mapie w ankiecie. Więcej informacji zawiera sekcja Nakładanie punktów na mapie.
Styl pytania
W przypadku pytań typu map (mapa) możesz skonfigurować mapę bazową, narzędzia mapy i wysokość pytania.
Dla poszczególnych pytań typu map (mapa) można skonfigurować domyślną mapę bazową za pomocą parametru map w kolumnie body::esri:style. Na przykład ustawienie map="World Topography" spowoduje, że w pytaniu typu map (mapa) zostanie użyta mapa bazowa Topografia świata. Parametr map można także skonfigurować z użyciem identyfikatora elementu mapy, na przykład map=de26a3cf4cc9451298ea173c4b324736. Ten parametr obsługuje mapy online i offline, w tym własne mapy internetowe użytkownika. Więcej informacji można znaleźć w temacie Dodawanie mapy do ankiety.
W kolumnie body::esri:style akceptowany jest parametr mapTools umożliwiający kontrolowanie narzędzi mapy dostępnych w przypadku pytań typu map (mapa). Jeśli nie ustawiono parametru narzędzia mapy, wyświetlone zostaną wszystkie narzędzia. Akceptowane są następujące wartości:
- mapTools=search
- mapTools=mapSwitcher
- mapTools=zoom
- mapTools=home
- mapTools=locate
Można ustawić wiele narzędzi, oddzielając każdą wartość przecinkiem, na przykład mapTools=search,locate.
W kolumnie body::esri:style akceptowany jest parametr height w przypadku pytań typu mapa.
Wysokość pytania można skonfigurować, podając parametr height z wartością liczbową oraz opcjonalnie z jednostką. Jednostką domyślną jest lines. Odwołuje się ona do wysokości bieżącej czcionki tekstu wejściowego. Na przykład parametr height=5 powoduje, że wszystkie te pytania są wyświetlane w pięciu wierszach.
Jednostkę można również skonfigurować jako wartość procentową wysokości ekranu lub za pomocą liczby pikseli, dodając je do wartości jako przyrostek bez spacji. Akceptowane są na przykład wszystkie następujące wartości:
- height=5
- height=5lines
- height=25%
- height=250pixels
Wysokość i narzędzia mapy można ustawić z odstępem między nimi, na przykład height=25% mapTools=search,zoom.