Vorbereiten der Datenerfassung durch den Entfernungsmesser

Mit Entfernungsmessern lassen sich Positions-, Versatz- und Höheninformationen zu einem Zielobjekt erfassen. Entfernungsmesser werden gewöhnlich in den folgenden Situationen verwendet:

  • Bei der Darstellung der Position eines unzugänglichen Objekts auf einer Karte, wobei das Objekt entweder schwer oder nicht sicher zu erreichen ist. Dies kann beispielsweise ein Baum auf einer Insel oder ein Kanalschacht in der Mitte einer vielbefahrenen Straße sein.
  • Bei der Darstellung der Position eines Objekts auf einer Karte, wobei an der Position kein GPS-Signal empfangen werden kann oder die GPS-Position nicht genau genug ist. Dies kann beispielsweise unter einem großen Baum oder in einer engen Straße oder Straßenschlucht der Fall sein.

Vorbereiten eines Survey für die Erfassung von Messwerten

Zunächst müssen Sie entscheiden, welche Messwerte erfasst werden sollen.

Sie müssen mindestens eine Textfrage mit dem Aussehen rangefinder erstellen, um die vom Entfernungsmesser zurückgegebenen Werte zu speichern. Bei dieser Frage kann es sich um eine Textfrage handeln, wenn Sie mehrere Messwerte des Entfernungsmessers erfassen (das gesamte JSON-Objekt wird gespeichert), oder um eine Frage des Typs "integer" oder "decimal", wenn Sie nur einen Messwert erfassen (ein einziger numerischer Wert wird gespeichert).

Der Messtyp wird in der Spalte bind::esri:parameters angegeben. Geben Sie dazu measurement= ein, gefolgt von einer Liste mit durch Kommas getrennten Parameterwerten, z. B. measurement=height,azimuth,horizontalDistance,slopeDistance,inclination.

Für vertikale Strukturen lässt sich auch eine Messroutine für mehrere Höhen ausführen. Dazu wird der Parameter multipleHeight verwendet, gefolgt von einer Liste mit durch Kommas getrennten Werten für die Höhenbeschriftungen. Schließen Sie die Parameterliste in Anführungszeichen ein, wenn eine der Höhenbeschriftungen Leerzeichen enthält, z. B. measurement="multipleHeight,Height 1,Height 2,Height 3". Messroutinen für mehrere Höhen können nicht mit anderen Messwerten kombiniert, sondern nur gesondert verwendet werden.

Über zusätzliche Textfragen im Survey können einzelne Messungen gespeichert werden. Mit der pulldata-Funktion können Sie Eigenschaften aus dem vom Entfernungsmesser zurückgegebenen JSON-Objekt extrahieren. Im folgenden Beispiel etwa wird nur der Richtungswert (azimuth) zurückgegeben: pulldata("@json",${tree},"azimuth").

Es folgt ein Beispiel für ein von einem Entfernungsmesser zurückgegebenes JSON-Objekt. Alle diese Eigenschaften können mit einem pulldata-Ausdruck in einer Frage abgerufen und gespeichert werden, wie oben dargestellt:

{
    "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]
}

Bei Starten eines Survey, der Fragen mit dem Aussehen "rangefinder" enthält, wird dem Benutzer ein Entfernungsmesser-Symbol neben der Frage angezeigt. Er tippt zum Erfassen eines Messwerts auf das Symbol, löst den Entfernungsmesser aus und kehrt dann zum Survey zurück, um die verbleibenden Fragen zu beantworten.

Vorbereiten eines Survey für die Verwendung in einem Workflow

Für einen Survey kann eine alternative Konfiguration vorgenommen werden, damit er über die Kachel Entfernungsmesser in der Survey123-Galerie ausgewählt werden kann.

Die Kachel "Entfernungsmesser" eignet sich für wiederholte Erfassungsprojekte, bei denen Messwerte aus dem Entfernungsmesser den Hauptbestandteil der Dateneingabe für den Survey ausmachen. Es ist möglich, die Übernahme von Messwerten aus dem Entfernungsmesser in mehreren Surveys zu konfigurieren und diese bei der Erfassung auszuwählen.

Wenn Sie einen Survey so konfigurieren möchten, dass er in der Survey-Liste der Kachel "Entfernungsmesser" angezeigt wird, fügen Sie der Spalte bind::esri:workflow einen der folgenden Werte hinzu:

  • rangefinderMode=height
  • rangefinderMode=offset
  • rangefinderMode=height,offset
  • rangefinderHeight

Mit diesem Parameter wird der App mitgeteilt, welchen Workflow für Entfernungsmesser-Messwerte sie ausführen, und das zurückgegebene JSON-Objekt in der zugehörigen Textfrage gespeichert. Diese Fragen können (mittels "hidden" als Aussehen) im Survey ausgeblendet werden, und einzelne Messwerte lassen sich in weiteren Fragen speichern.

Der Workflow zur Messung mehrerer Höhen kann auch durch das Hinzufügen von rangefinderMode=height in der Textfrage sowie weiteren Fragen des Typs "decimal" zum Speichern der einzelnen Höhenwerte konfiguriert werden. Weisen Sie jeder Frage des Typs "decimal" den Wert rangefinderHeight in der Spalte bind::esri:workflow von XLSForm zu.

Über zusätzliche Fragen im Survey können weitere Einzelmessungen gespeichert werden. Mit der pulldata-Funktion können Sie Eigenschaften aus dem vom Entfernungsmesser zurückgegebenen JSON-Objekt extrahieren, wie unter Vorbereiten eines Survey für die Erfassung von Messwerten beschrieben.