Starten von Indoors App Clip

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

Indoors App Clip ermöglicht einen schnellen Zugriff auf bestimmte Workflows der ArcGIS Indoors Mobile-App, ohne dass die App vollständig installiert oder die mobile Karte heruntergeladen werden muss. Durch das Scannen eines QR-Codes wird schnell eine App Clip-Instanz gestartet, die sofortigen Zugriff auf gezielt ausgewählte Indoor-Karten-Funktionen bietet. App Clip eignet sich daher besonders gut für den Einsatz in Szenarien mit Besuchern und Gästen, wie beispielsweise auf Universitätsgeländen, in Krankenhäusern, Behörden, Flughäfen, Kongresszentren und Unternehmensbüros.

Über Indoors App Clip können Besucher eine Indoor-Karte anzeigen, Orte in der Nähe erkunden und sich durch Scannen eines QR-Codes eine Wegbeschreibung zu einem Ziel anzeigen lassen. Die App Clip-Instanz bleibt für einen begrenzten Zeitraum auf dem Gerät verfügbar und wird nach einem bestimmten Zeitraum der Inaktivität automatisch vom Gerät entfernt. Benutzer können die Indoors Mobile-App jederzeit installieren, um zusätzliche Funktionen zu erhalten.

Die Indoors Mobile-App kann über die App Clip-Instanz installiert oder direkt im App Store heruntergeladen werden. Beim Installieren der Indoors Mobile-App über die App Clip-Instanz wird die zugehörige mobile Karte automatisch heruntergeladen, und der Benutzer kann an der Stelle weitermachen, an der er in der App Clip-Instanz aufgehört hat.

Hinweis:

Indoors App Clip ist nur für Apple-Geräte wie z. B. iPhone und iPad verfügbar. Wenn die Indoors Mobile-App auf dem Gerät installiert ist, wird durch das Scannen des QR-Codes die Indoors Mobile-App gestartet und nicht die App Clip-Instanz geöffnet.

Voraussetzungen

Führen Sie vor dem Konfigurieren einer App Clip-Instanz die folgenden Schritte aus:

1. Erstellen Sie eine Indoors Viewer-App mit auf Alle (öffentlich) festgelegter Freigabe.

   Die mit der Indoors Viewer-App verknüpfte Webkarte wird verwendet, um die App Clip-Oberfläche zusammen mit anderen freigegebenen Konfigurationen bereitzustellen.

2. Sie können auch ein mobiles Kartenpaket (.mmpk) mit der Freigabeoption Alle (öffentlich) freigeben und es mit der Indoors Viewer-App verknüpfen, um Benutzern, die die Indoors Mobile-App installieren, zusätzliche Funktionen zur Verfügung zu stellen.

   Hinweis:

   Wenn eine öffentliche mobile Karte verfügbar ist und mit der Indoors Viewer-App verknüpft ist, öffnet die App automatisch das mobile Kartenpaket (.mmpk), wenn der Benutzer von der App Clip-Instanz zur mobilen App wechselt. Wenn kein .mmpk verfügbar ist, wird die App trotzdem geöffnet, und der Benutzer wird aufgefordert, eine Karte aus einer Liste verfügbarer Karten auszuwählen.

Generieren von QR-Codes

Führen Sie die folgenden Schritte aus, um QR-Codes zum Starten von IndoorsApp Clip zu erstellen:

1. Vergewissern Sie sich, dass die Webkomponente "Indoors App-Clip" in Ihrer ArcGIS-Organisation bereitgestellt wurde und darauf zugegriffen werden kann:
   • ArcGIS Online: <organization>.maps.arcgis.com/apps/indoors/appclip.html
   • ArcGIS Enterprise: <portal.example.com>/portal/apps/indoors/appclip.html

   Hinweis:

   Für App Clip muss das Enterprise-Portal ein gültiges Zertifikat einer Zertifizierungsstelle zum Laden der Indoors Viewer-App verwenden.

2. Erstellen Sie die Start-URL entsprechend der gewünschten App Clip-Funktion.

   Wählen Sie die Start-URL für die App Clip-Instanz aus, die der Funktion entspricht, die Sie den Benutzern bereitstellen möchten. Dazu gehören beispielsweise das Öffnen der Indoor-Karte an einem bestimmten Feature, das Generieren einer Route und einer detaillierten Wegbeschreibung vom Ursprung zum Ziel oder das Starten einer Wegbeschreibung ab einer bestimmten Position.

3. Generieren Sie mithilfe Ihres bevorzugten QR-Code-Generators einen QR-Code aus der Start-URL.

Bereitstellen von QR-Codes

Sie können Personen, die Ihre Indoor-Karte erkunden möchten, QR-Codes für Indoors App Clip zur Verfügung stellen. Die QR-Codes können beispielsweise an Gebäudeeingängen, an Kiosken, auf Websites, auf Beschilderungen oder an anderen für Besucher gut sichtbaren Stellen angebracht werden.

URL-Parameter

In der folgenden Tabelle sind alle unterstützten URL-Parameter und ihre Beschreibungen aufgeführt:

Parameter	Beschreibung
portalURL (erforderlich)	Die URL einer ArcGIS-Organisation, die die Indoors Viewer-App enthält.
appid (erforderlich)	Die App-ID der ausgewählten Indoors Viewer-App. Für den Namen dieses Parameters muss die Groß- und Kleinschreibung beachtet werden. Hinweis: Wenn ein Benutzer eine URL scannt, die den Parameter itemid anstelle von appid enthält, wird die App Clip-Instanz mit einer Schaltfläche geöffnet, über die die Indoors Mobile-App im App Store gestartet werden kann. Der Benutzer muss die Indoors Mobile-App herunterladen und öffnen, um die Smart-Start-Aktion mit dem Parameter itemid ausführen zu können.
introImageURL	Gibt die URL eines Bildes an, das vor dem Laden der App angezeigt wird.
adminEmail	Gibt eine E-Mail-Adresse an, an die Probleme mit der URL der App Clip-Instanz gemeldet werden können.
action	Legt die Aktion fest, die die App beim Starten ausführen soll (verorten oder Route aufrufen)
x	Der Längengrad der aktuellen Position.
y	Der Breitengrad der aktuellen Position.
floor	Die vertikale Reihenfolge des Geschosses, in dem sich das Feature befindet.
layer	Der Name des Layers in der Karte mit dem Feature.
featureID	Eine eindeutige Kennung für das Feature, bei dem es sich um eine Objekt-ID, eine Global-ID oder ein eindeutiges Attribut aus dem ArcGIS Indoors-Informationsmodell, wie z. B. die Raum-ID, handeln kann.
featureIDField	Der Name des Feldes, das eine eindeutige Kennung für das Feature enthält
toX	Der Längengrad der Zielposition
toY	Der Breitengrad der Zielposition
toFloor	Die vertikale Reihenfolge der Geschossdecke, in der sich das Ziel-Feature befindet
toLayer	Der Name des Layers in der Karte mit dem Ziel-Feature
toFeatureID	Eine eindeutige Kennung für das Feature, zu dem das Routing erfolgen soll. Dabei kann es sich um eine Objekt-ID, eine Global-ID oder ein eindeutiges Attribut aus dem Indoors-Modell, wie z. B. die Raum-ID, handeln.
toFeatureIDField	Der Name des Feldes, das eine eindeutige Kennung für das Ziel-Feature enthält
fromX	Der Längengrad der Ursprungsposition
fromY	Der Breitengrad der Ursprungsposition
fromFloor	Die vertikale Reihenfolge der Geschossdecke, auf der sich das Ursprungs-Feature befindet
fromLayer	Der Name des Layers in der Karte mit dem Ursprungs-Feature
fromFeatureID	Eine eindeutige Kennung für das Feature, zu dem das Routing erfolgen soll. Dabei kann es sich um eine Objekt-ID, eine Global-ID oder ein eindeutiges Attribut aus dem Indoors-Modell, wie z. B. die Raum-ID, handeln.
fromFeatureIDField	Der Name des Feldes, das eine eindeutige Kennung für das Ursprungs-Feature enthält
travelMode	Der für die Navigation auf der angegebenen Route ausgewählte Reisemodus, wie beispielsweise "Gehen", "Rollstuhl", "Fahrrad" und andere in ArcGIS Pro konfigurierte Reisemodi.
category	Gibt die Kategorie an, die beim Öffnen der App Clip-Instanz ausgewählt werden soll.

Beispiel-URLs

In den folgenden Beispielen wird die Konfiguration von URLs zum Öffnen einer App, zum Aufrufen einer Karte mit einem Feature, zum Erstellen einer Wegbeschreibung und für weitere Zwecke erläutert.

Hinweis:

Die Start-URLs für Indoors App Clip-Instanzen müssen mit der Basis-URL https://indoors.arcgis.app beginnen und die Parameter portalURL und appid enthalten.

URL, über die eine angegebene Indoor-Karte geöffnet wird

Beispiel: Eine staatliche Organisation bringt am Informationsschalter eines Gebäudes einen QR-Code an, über den Besucher schnell Indoors App Clip öffnen und auf den Gebäudeplan zugreifen können.

https://indoors.arcgis.app?portalURL=https://myorgName.maps.arcgis.com&appid=3309861e27c44162847e952e26a391da

URL, über die ein Einführungsbild und die E-Mail-Adresse des Administrators für die Meldung von Problemen aufgerufen werden

Beispiel: Eine Organisation möchte beim Öffnen der App Clip-Instanz einen Ladebildschirm mit ihrem Branding anzeigen und eine E-Mail-Adresse bereitstellen, über die Benutzer Probleme mit Links melden können.

https://indoors.arcgis.app?portalURL=https://myorgName.maps.arcgis.com&appid=3309861e27c44162847e952e26a391da&introImageURL=https://hostedimage.com/b1u2&adminEmail=[e-mail]

URL, über die eine ausgewählte Kategorie geöffnet wird

Beispiel: Ein Gericht bringt im Versammlungsraum der Geschworenen einen QR-Code an, über den eine Karte geöffnet wird, auf der die Kategorie "Gerichtssäle" bereits ausgewählt ist, sodass die Geschworenen die Gerichtssäle schnell finden können.

https://indoors.arcgis.app?portalURL=https://myorgName.maps.arcgis.com&appid=3309861e27c44162847e952e26a391da&category=Courtrooms

URL, über die ein bestimmtes Feature auf der Karte verortet wird

Beispiel: Eine Organisation stellt bei einer Veranstaltung einen QR-Code bereit, den die Teilnehmer scannen können, um eine App Clip-Instanz zu öffnen und den Raum zu finden, in dem die Veranstaltung stattfindet.

https://indoors.arcgis.app?portalURL=https://myorgName.maps.arcgis.com&appid=3309861e27c44162847e952e26a391da&action=locate&layer=Units&featureIDField=Name&featureID=M3ne350

URL zum Generieren einer Wegbeschreibung von einer Ursprungsposition zu einer Zielposition

Beispiel: Eine Organisation stellt einen QR-Code bereit, über den eine App Clip-Instanz geöffnet wird und eine Wegbeschreibung von einem Parkplatz zu einem bestimmten Ziel im Gebäude generiert wird.

https://indoors.arcgis.app?portalURL=https://myorgName.maps.arcgis.com&appid=3309861e27c44162847e952e26a391da&action=route&fromlayer=ParkingLot&fromfeatureidfield=Name&fromfeatureid=Parking%20Lot%20M&tolayer=Units&tofeatureidfield=Name&tofeatureid=Courtroom%20200

URL, über die eine vom Benutzer ausgewählte Wegbeschreibung gestartet wird

Beispiel: Eine Organisation stellt einen QR-Code bereit, über den die App Clip-Instanz mit einer festgelegten Startposition geöffnet wird und die Besucher ihr eigenes Ziel im Gebäude auswählen können.

https://indoors.arcgis.app?portalURL=https://myorgName.maps.arcgis.com&appid=3309861e27c44162847e952e26a391da&action=route&fromlayer=ParkingLot&fromfeatureidfield=Name&fromfeatureid=Parking%20Lot%20M

URL-Codierung

Alle App Clip-URLs müssen Parameterwerte enthalten, die so codiert sind, dass Leerzeichen und Sonderzeichen berücksichtigt werden. Leerzeichen und Sonderzeichen werden mit dem Zeichen % und einem aus zwei Zeichen bestehenden Hexadezimalwert codiert. Ein Gleichheitszeichen, das eine Unterbrechung zwischen einem Schlüssel und dessen Wert angibt, sollte nicht codiert werden.

Im Folgenden finden Sie ein Beispiel für eine App Clip-URL, über die eine Kaffeemaschine in einem Bürogebäude verortet werden kann; die Parameter sind hier nicht codiert:

https://indoors.arcgis.app/?portalURL=https://myorgName.maps.arcgis.com&action=locate&appid=3683b12f5c0c4998bfba9b9f24b10895&layer=CoffeeMachines&featureIDField=Name&featureID=Kuerig K duo - O2 #2 (O2e205)

Dieselbe URL mit codierten Parametern lautet wie folgt:

https://indoors.arcgis.app/?portalURL=https://myorgName.maps.arcgis.com&action=locate&appid=3683b12f5c0c4998bfba9b9f24b10895&layer=CoffeeMachines&featureIDField=Name&featureID=Kuerig%20K%20duo%20%2D%20O2%20%232%20%28O2e205%29

Tipp:

Sie können Ihren bevorzugten Codierungsdienst verwenden, um mehrere Schlüsselwertpaare zu definieren, die die einzelnen Parameter darstellen, und eine URL mit der entsprechenden Encodierung zu erstellen.