Einbinden von WebMaps

Eine WebMap ist ein Element in Portal for ArcGIS oder in ArcGIS Online, das eine 2D-Karte repräsentiert. Sie umfasst beispielsweise Informationen über die enthaltenen Grundkarten und Layer oder über die maximale Ausdehnung. Wie jedes andere Portalelement, kann über die Freigabe gesteuert werden, wer auf das Element (hier die WebMap) zugreifen darf. Wenn Sie bisher noch nicht mit dem Begriff der WebMap vertraut sind, empfehlen wir diesen Artikel von Esri hier .

Einstellen der Standard-WebMap

In der Kartenkonfiguration können Sie festlegen welche WebMap standardmäßig beim Start von Terratwin geladen wird:

"webMap": {
 "portalItem": {
  "id": "e759405w6z8f4215886c6de2e4bac4b7",
  "portal": {
   "url": "https://arcgis.com/"
  }
 }
},
[...]

Die in dieser WebMap hinterlegte Grundkarte bestimmt das verwendete Koordinatenreferenzsystem. Ist keine WebMap in der Kartenkonfiguration definiert, wird Terratwin mit einer Grundkarte von OpenStreetMap mit WebMercator-Projektion geladen.

Einbinden weiterer WebMaps

Benutzer können über die Benutzeroberfläche oder über den URL-Parameter webmap Terratwin mit einer anderen WebMap starten, als in der Standard-WebMap definiert ist.

Welche WebMaps über Karte öffnen zur Verfügung stehen, wird in der Menükonfiguration unter der Eigenschaft mapBrowser festgelegt.

[...]
	"mapMenu": {
		"sharing": {
			[...]
		},
		"mapBrowser": {
			"portalQuery": {
				"portalUrl": "https://yourdomain.de/portal",
				"queryParams": {
					"filter": "type: \"Web Map\" -owner: {esri_aa TO esri_zz} -group: 928cb1d4a0dd4235bec32b75bc18572f"
				}
			}
		}
	},

In diesem Beispiel werden sämtliche Portalelemente vom Typ WebMap referenziert, die nicht im Besitz von einem Benutzer sind, der mit “esri_” beginnt und nicht in der Gruppe mit der Id 928cb1d4a0dd4235bec32b75bc18572f enthalten sind. Weitere Informationen zum Aufbau und Funktionsweise dieser Abfrage finden Sie hier:

Referenzieren von Portalinhalten

Benutzer können grundsätzlich nur die WebMaps laden, für die eine Freigabe entsprechend eingerichtet ist. Versucht ein Benutzer mit unzureichender Berechtigung eine WebMap über URL-Parameter zu öffnen, erhält er eine Fehlermeldung.

Derzeit kann über Terratwin noch nicht die Freigabe von Portalinhalten (z.B. WebMaps) gesteuert werden. Benutzer müssen mindestens den Benutzertyp Creator aufweisen und sich im Portal bzw. ArcGIS Online anmelden, um dort die Freigabe zu erstellen.

Importieren und Exportieren von WebMaps

WebMaps können in Terratwin als JSON-Datei importiert und exportiert werden. Die JSON-Datei enthält alle Informationen über die Karte, einschließlich der Themen, deren Einstellungen (z.B. Sichtbarkeit, Reihenfolge, Filter) und ggf. erstellte Zeichnungen. Dabei handelt es sich um eine lokale Datei, die auf dem Gerät des Benutzers gespeichert wird. Sie ist nach der WebMap-Spezifikation  von Esri aufgebaut und kann auch in anderen Anwendungen verwendet werden, die dieses Format unterstützen.

WebMaps teilen

Ab der Version 2.3.1 können Benutzer WebMaps über die Funktion Karte teilen aus dem heraus Menü teilen. Dabei wird eine URL generiert, die dann mit anderen Benutzern geteilt werden kann. Wenn ein Benutzer die URL öffnet, wird die entsprechende Karte in Terratwin geladen.

Abgrenzung zur Freigabe in ArcGIS

Die URL ist nur temporär gültig und für eine einfache Weitergabe von Karten konzipiert und sollte nicht als Permalink verwendet werden z.B. auf Homepages. Für die dauerhafte Bereitstellung von Karten sollten Sie die WebMaps in Portal for ArcGIS oder ArcGIS Online erstellen und über die Freigabe steuern, wer Zugriff auf die Karten hat.

Sicherheit und Datenschutz

Insofern Ihre Terratwin-Instanz über das Internet erreichbar ist, ist die freigegebene URL für alle Benutzer zugänglich, die über die URL verfügen. Der Zugriff auf die Layer in der Karte bleibt davon unberührt, da ihre Verfügbarkeit unabhängig davon über die Freigabeeinstellungen in ArcGIS geregelt wird. Falls die Karte private Layer enthält, fordert Terratwin beim Öffnen der URL eine Authentifizierung an.

Da Zeichnungen direkt in der WebMap gespeichert werden, sollten Sie als GIS-Administrator Ihre Benutzer darauf hinweisen, dass sie keine sensiblen Informationen in Zeichnungen speichern sollten, wenn sie die Karte teilen möchten.