Die Vorlage "Nearby" basiert auf der Vorlage für "In der Nähe"-Web-Apps in Instant Apps. Über diese Vorlage wird eine native App bereitgestellt, mit der Orte in der Nähe gesucht werden können. Darin sind zudem Filter enthalten, mit denen die Suche nach Entfernung oder Feature-Kategorie eingeschränkt werden kann.
Anforderungen
Die Anforderungen zum Verwenden der Vorlage "Nearby" lauten:
- Stellen Sie mindestens eine "In der Nähe"-Web-App bereit. Dies kann eine einzelne gültige Element-ID, die ID für eine Gruppe mit mehreren "In der Nähe"-Web-Apps oder eine Suchabfrage mit mehreren Element-IDs sein.
- "In der Nähe"-Web-Apps können öffentlich oder gesichert sein. Um auf eine gesicherte Web-App in Ihrer ArcGIS Online-Organisation oder im ArcGIS Enterprise-Portal mit OAuth2 zuzugreifen, registrieren Sie die App, und geben Sie eine Client-ID an. Weitere Informationen finden Sie unter Signieren Ihrer App. Standardmäßig werden nur öffentliche "In der Nähe"-Web-Apps in der Galerie "In der Nähe" angezeigt. Um auf gesicherte "In der Nähe"-Web-Apps zuzugreifen, klicken Sie auf Einstellungen > Lizenzierung > Galerie, und geben Sie eine Client-ID an.
- Wenn optional über den ArcGIS-Routing-Service Wegbeschreibungen in der Vorlagen-App "In der Nähe" abgerufen werden sollen, müssen Sie einen API-Schlüssel angeben. Klicken Sie dazu auf Einstellungen > Eigenschaften > Galerie. Aktivieren Sie alternativ unter Einstellungen die Eigenschaft Unterstützung von gesicherten Web-Apps, damit Endbenutzer zur Anmeldung bei der App "In der Nähe" aufgefordert werden.
Anpassen der App
Nachdem Sie Ihre App erstellt haben, können Sie sie anpassen, indem Sie die App-Einstellungen ändern.
Starten Sie AppStudio, und klicken Sie im Seitenbereich auf Einstellungen > Eigenschaften. In der folgenden Tabelle sind die Inhalte der Registerkarte Eigenschaften von "In der Nähe" nach Unterregisterkarte und mit dem jeweiligen Zweck aufgeführt. Die Einstellungen können Sie auch direkt in der Datei "appinfo.json" der App ändern. Wenn Sie eine dieser Eigenschaften ändern, klicken Sie auf Übernehmen, um sie zu speichern, bevor Sie die App später erneut starten.
Inhalt der Registerkarte "Startbildschirm"
| Eigenschaft | JSON-Name | Typ | Beschreibung |
|---|---|---|---|
| Hintergrundbild | startBackground | Zeichenfolge (Bild-URL) | Bild, das für den Hintergrund der Startseite verwendet werden soll. |
| Unternehmensfarbe | brandColor | Zeichenfolge (Farbwert) | Farbe, die als primäre Farbe verwendet werden soll. |
| Datei für Titelschriftart | mediumFontTTF | Zeichenfolge (URL der Schriftartendatei) | Legt die benutzerdefinierte Titelschriftart fest, die in der gesamten App verwendet werden soll. Diese Schriftart wird in Überschriften, Seitentiteln usw. verwendet. |
| Datei für Textschriftart | regularFontTTF | Zeichenfolge (URL der Schriftartendatei) | Legt die benutzerdefinierte Textschriftart fest, die in der gesamten App verwendet werden soll. Diese Schriftart wird in Beschreibungen von Fotos, Texten usw. verwendet. |
| E-Mail-Adresse für Feedback | feedbackEmail | Zeichenfolge (E-Mail-ID) | E-Mail-Adresse, an die Feedback von Benutzern gesendet wird. |
| Haftungsausschluss anzeigen | showDisclaimer | Boolesch (true|false) | Zeigt den Text des Haftungsausschlusses als Pop-up in der App an. Dieser Text ist der Inhalt des Abschnitts Zugriffs- und Nutzungsbeschränkungen der Registerkarte Details. |
Inhalt der Registerkarte "Galerie"
| Eigenschaft | JSON-Name | Typ | Beschreibung |
|---|---|---|---|
| "In der Nähe"-Web-Apps | galleryMapsQuery | Zeichenfolge | Geben Sie eine ArcGIS-Abfrage ein, um gültige "In der Nähe"-Web-Apps in der Galerie aufzulisten. Hierbei kann es sich um eine einzelne gültige Element-ID für eine Web-App wie "id:0b28ef391fe44fc5bc2b0bcd3f5bbbcb" handeln, eine gültige Gruppen-ID mit mehreren Web-Apps wie "group:47597bdf4b6d49fd85c0f4175a6e7b60" oder eine Suchabfrage mit mehreren Web-App-IDs wie "(id:0b28ef391fe44fc5bc2b0bcd3f5bbbcb OR id:6efd8324a57247c79a7ec9a66a9bf581)". |
| Maximale Anzahl der Ergebnisse in der Galerie | maxNumberOfQueryResults | Zahl | Geben Sie die maximale Anzahl an Web-Apps an, die bei Abfragen des Portals zurückgegeben werden sollen. |
| Portal-URL | portalUrl | Zeichenfolge | URL des Portals, in dem "In der Nähe"-Web-Apps abgefragt werden sollen. |
| Unterstützung von gesicherten Web-Apps | supportSecuredMaps | Boolesch (true|false) | Ermöglicht die Anmeldung bei einer Organisation für den Zugriff auf gesicherte Web-Apps, die den Abfrageparametern entsprechen. |
| Anmeldung überspringen | enableAnonymousAccess | Boolesch (true|false) | Wenn die Unterstützung für gesicherte Web-Apps auf "true" festgelegt wurde und diese Einstellung ebenfalls auf "true" festgelegt wird, ist es möglich, die Anmeldung zu überspringen und nur öffentlich verfügbare Web-Apps in der Galerie anzuzeigen. |
| API-Schlüssel | APIKey | Zeichenfolge | Geben Sie einen API-Schlüssel an, um Zugriff auf den Routing-Service zu gewähren und so die Anzeige von Wegbeschreibungen in der Vorlage "In der Nähe" zu ermöglichen. Wenn Sie sich für ein Esri Developer-Konto registriert haben, wurde in diesem Rahmen für Sie ein API-Schlüssel erstellt. Wenn Sie bereits ein ArcGIS-Konto haben, können Sie sich bei einem Esri Developer-Konto anmelden, um den API-Schlüssel einzusehen oder weitere API-Schlüssel zu erstellen. |
| Portal-Sortierfeld | portalSortField | Zeichenfolge | Wird zum Sortieren von Web-Apps, die in der Galerie angezeigt werden, verwendet. Mögliche Werte sind: title, created, type, owner, modified, avgRating, numRatings, numComments, numViews. |
| Portal-Sortierreihenfolge | portalSortOrder | Zeichenfolge | Wird zusammen mit dem Sortierfeld der Galerie zum Sortieren von Web-Apps in auf- oder absteigender Reihenfolge verwendet. Mögliche Werte sind "asc" oder "desc". |