Direktes Aufrufen eines Features oder einer Route beim Starten

Verfügbar mit der Erweiterung "ArcGIS Indoors Maps".

Sie können Indoor Viewer so konfigurieren, dass beim Starten direkt ein Feature oder eine Route zwischen zwei Features aufgerufen wird (Smart-Start). Die Smart-Start-Funktionalität wird durch Parameter in der App-URL aktiviert.

Starten und Aufrufen eines Features

Sie können die Viewer-App so konfigurieren, dass beim Starten direkt ein bestimmtes Feature aufgerufen wird. Die URL zum Aufrufen eines Features beim Starten wird mit der Schaltfläche Freigeben folgendermaßen automatisch generiert:

1. Wählen Sie ein Feature in der Viewer-App aus.

   Das Informationsfenster mit Details zu dem Feature wird angezeigt.

2. Klicken Sie oben im Informationsfenster auf die Schaltfläche Freigeben und dann auf In die Zwischenablage kopieren.

   Die URL wird in die Zwischenablage kopiert.

3. Öffnen Sie ein Browser-Fenster, und fügen Sie die URL ein.

   Mit der generierten URL wird die Viewer-App gestartet und das angegebene Feature aufgerufen.

URL-Parameter

Mit der URL, die mit der Schaltfläche Freigeben generiert wird, wird die App gestartet und ein Feature aufgerufen. Dazu werden Parameter verwendet, mit denen die Position des Features identifiziert wird. Mithilfe dieser Parameter können Sie eine URL erstellen, mit der die Viewer-App gestartet und eine angegebene Route aufgerufen wird.

Parameter	Beschreibung
itemUniqueIdField	Das Attribut im Layer "SourceKey", das eine eindeutige Kennung für das Feature enthält. Hinweis: Dieser Parameter ist nur bei Features enthalten, die im Indoor-Dataset vorhanden sind. Andere Features, beispielsweise hinzugefügte Pins, enthalten keine eindeutige Kennung.
itemSourceKey	Der Name des Layers in der Webkarte, der das Feature enthält, beispielsweise "Räume".
itemUniqueId	Der Feldwert "itemUniqueIdField" für das Feature. Hinweis: Für Features, die im Indoor-Dataset nicht vorhanden sind (beispielsweise hinzugefügte Pins) wird dieser Wert nach dem Zufallsprinzip generiert.
x	Die X-Koordinate der Punktkennung.
y	Die Y-Koordinate der Punktkennung.
l	Die vertikale Reihenfolge der Punktkennung. Dies ist der Wert des auf 0 basierenden Ordnungssystems für Ebenen, der in den Feature-Classes des ArcGIS Indoors enthalten ist.
visibleLayers	Dieser Parameter enthält die Kennung "operationalLayer" für jeden Layer, der bei der Freigabe der Webkarte aktiviert wird.

Anhand dieser Parameter wird die Viewer-App über die URL geöffnet und ein Feature aufgerufen. Dabei wird die folgende Struktur verwendet:

https://<yourserver.yourdomain.com>/portal/apps/indoors?appid=<appid>&itemUniqueIdField=<uniqueidfield>&itemSourceKey=<itemsourcekey>&itemUniqueId=<itemuniqueid>

Hinweis:

URLs für Positionen, die im Indoor-Dataset nicht vorhanden sind (beispielsweise hinzugefügte Pins), enthalten den Parameter itemUniqueField nicht. Für den Wert itemSourceKey wird "standalone" festgelegt, und für itemUniqueId wird nach dem Zufallsprinzip ein Wert generiert.

Starten und Aufrufen einer Route

Sie können die Viewer-App so konfigurieren, dass beim Starten direkt eine Route aufgerufen wird, indem Sie den Start- und Endpunkt der Route in der URL der App definieren. Wenn sowohl der Start- als auch der Endpunkt angegeben sind, wird die Route von der App im Fenster "Wegbeschreibung" automatisch berechnet. Es werden zwei Routen-Stopps unterstützt: Start und Ende der Route.

Eine Route muss aus einem Routenstart und einem Routenende bestehen. Zum Konfigurieren dieser Features können Sie eine ähnliche Struktur wie bei der mit der Schaltfläche Freigeben generierten URL verwenden. Um in der URL zwischen Start und Ende der Route zu unterscheiden, erhalten die Parameternamen für den Routenstart jeweils das Präfix rs und die Parameternamen für das Routenende das Präfix re.

Sie können die eindeutige Kennung, das Feld und die ID oder die X-, Y- und L-Werte zur Identifizierung des Features angeben.

Erstellen der URL für den Smart-Start mit einer Route

Mit der Schaltfläche Freigeben in Viewer können Sie die Parameter und Werte für die Routen-URL generieren.

1. Wählen Sie ein Feature in der Viewer-App aus.

   Das Informationsfenster mit Details zum ausgewählten Feature wird angezeigt.

2. Klicken Sie oben im Informationsfenster auf die Schaltfläche Freigeben und dann auf In die Zwischenablage kopieren, um eine URL in die Zwischenablage zu kopieren.
3. Fügen Sie die URL in einen Texteditor wie Notepad++ ein, und geben Sie die Schlüsselparameter an, mit denen die App gestartet und das Feature direkt aufgerufen werden kann.
4. Wiederholen Sie die Schritte 1 bis 3 für das andere Ende der Route.
5. Erstellen Sie folgendermaßen die URL, mit der die Viewer-App gestartet und automatisch eine Route aufgerufen wird:
   1. Stellen Sie den Parameternamen für das Routenstart-Feature die Buchstaben rs und den Parameternamen für das Routenend-Feature die Buchstaben re als Präfix voran.
   2. Schreiben Sie den Buchstaben, der direkt auf das neue Präfix folgt, groß. Beispielsweise wird der Parameter itemUniqueIdField für den Routenstart in rsItemUniqueIdField und für das Routenende in reItemUniqueIdField umbenannt.
   3. Erstellen Sie unter Verwendung der folgenden grundlegenden Struktur eine Smart-Start-URL:

      https://<yourserver.yourdomain.com>/portal/apps/indoors?appid=<appid>&rsItemUniqueIdField=<routestartitemuniqueidfield>&rsItemSourceKey=<routestartitemsourcekey>&rsItemUniqueId=<routestartitemuniqueid>&reItemUniqueIdField=<routeenditemuniqueidfield>&reItemSourceKey=<routeenditemsourcekey>&reItemUniqueId=<routeenditemuniqueid>

      Hinweis:

      Für Positionen, die im Indoor-Dataset nicht enthalten sind (beispielsweise hinzugefügte Pins), müssen Sie die X-, Y- und L-Werte für die Punktkennung angeben. Legen Sie für itemSourceKey in diesem Fall standalone fest, und verwenden Sie den itemUniqueId-Wert aus der in Schritt 2 generierten URL. Der Wert itemUniqueIdField ist nicht erforderlich.

Beispiel-URLs

Die folgenden Beispiele zeigen verschiedene URLs, die für einen Smart-Start verwendet werden können.

URL zum Starten und Aufrufen eines Features

• Freigegebener Bürostandort:
  https://myserver.mydomain.com/portal/apps/indoors?appid=ca4618a41f074de8964eb3a04821eb9e&itemUniqueIdField=unit_id&itemSourceKey=Units&itemUniqueId=ESRI.RED.MAIN.O3w220

• Freigegebene Position eines hinzugefügten Pins:
  https://myserver.mydomain.com/portal/apps/indoors?appid=1a348887cb6c44ddb748cd0c65fce9db&x=-117.19555207109245&y=34.05733200897579&l=0&itemSourceKey=standalone&itemUniqueId=9fc8e6855b22471f801af991935f8d40

URL zum Starten und Öffnen einer Route

• Von einem Raum zu einem hinzugefügten Pin:
  https://myserver.mydomain.com/portal/apps/indoors/?appid=ca4618a41f074de8964eb3a04821eb9e&rsItemUniqueIdField=UNIT_ID&rsItemSourceKey=Units&rsItemUniqueId=ESRI.RED.MAIN.M1mc365&reX=-117.19672775506533&reY=34.05792177746473&reL=0&reItemSourceKey=standalone&reItemUniqueId=d9a1d2eac66d47808b23a0695fb0c565#

• Von einem Raum zu einem Raum:
  https://myserver.mydomain.com/portal/apps/indoors/?appid=ca4618a41f074de8964eb3a04821eb9e&rsItemUniqueIdField=UNIT_ID&rsItemSourceKey=Units&rsItemUniqueId=ESRI.RED.MAIN.O3w220&reItemUniqueIdField=unit_id&reItemSourceKey=Units&reItemUniqueId=ESRI.RED.MAIN.L2e505#