Beispiel - Google Maps Integration

Dieses Kapitel demonstriert wie Kartenmaterial von Google Maps innerhalb des Maps Widgets angezeigt werden kann.

How-To

Folgende Schritte müssen durchgeführt werden um Google Maps innerhalb des Widgets zu integrieren:

Laden Sie eine entsprechende DGML Datei und alle dazugehörigen Daten herunter. Diese Dateien können Sie entweder selbst erstellen oder herunterladen, e.g. https://github.com/freayd/marble-maps.
Anmerkung:
Bitte beachten Sie, dass die Verwendung innerhalb Ihres Projektes zusätzliche rechtliche Schritte durch Sie erforderlich sind (Google Maps (Entwicklungs-)Lizenzvereinbarung, etc.).
Legen Sie die heruntergeladenen Dateien in ihrem Projekt unter data/maps/maps/<ThemeId> ab, z.B.: "data/maps/maps/earth/google-maps-satellite/". Sollte die Struktur data/maps/maps/ noch nicht vorhanden sein in Ihrem Projekt muss diese manuell angelegt werden. Ein Neustart des UIs ist nach Anlegen der Ordner/Dateien erforderlich.
Bitte beachten Sie, dass die ThemeId und der Name der .dgml Datei ident sein muss. Für "google-maps-satellite" sieht die entsprechende Struktur wie folgt aus:
```
data/maps/maps/earth/google-maps-satellite/
data/maps/maps/earth/google-maps-satellite/0/
data/maps/maps/earth/google-maps-satellite/0/0/
data/maps/maps/earth/google-maps-satellite/0/0/0.jpeg
data/maps/maps/earth/google-maps-satellite/google-maps-satellite.dgml
data/maps/maps/earth/google-maps-satellite/google-maps-satellite-preview.png
data/maps/maps/earth/google-maps-satellite/legend.html
```
Es stehen mehrere Themes für Google Maps zur Verfügung und jedes der Themes benötig einen eigenen ThemeId Ordner innerhalb des Verzeichnisses /data/maps/maps/earth/:
```
data/maps/maps/earth/google-maps/..
data/maps/maps/earth/google-maps-satellite/..
data/maps/maps/earth/google-maps-terrain/..
```
Legen Sie ein neues Panel mit einem Maps Widget innerhalb Ihres Projektes an oder öffnen Sie ein bereits existierendes Panel.
Laden Sie das Map Theme mittels der Widget Eigenschaft mapThemeId durch die Angabe des Pfades zu Ihrer .dgml Datei, z.B.: "earth/google-maps-satellite/google-maps-satellite.dgml"
Setzen Sie die workOffline Eigenschaft auf "false" um dem Widget Zugriff auf das Internet zu ermöglichen.
Öffnen Sie das Panel und das Widget beginnt mit dem Download der erforderlichen Tiles für die Anzeige der Karte der aktuellen Höhe und sichtbaren Fläche, siehe Beispielbild unterhalb.

Abbildung: Maps Widget - Google Maps