Nutzer können den Zoom, die Neigung, die Position und die Drehung der Kamera über Touch-Gesten auf der Karte steuern. Sie können die Kamera auch programmatisch konfigurieren.
Kameraposition
Die Kartenansicht wird so modelliert, als wäre eine Kamera auf einen bestimmten Punkt in einem 3D-Raum gerichtet. Die Position und Ausrichtung der Kamera (und damit das Rendern der Karte) werden durch die folgenden Eigenschaften festgelegt: „center“ (Breiten-/Längengrad/Höhe des Ziels der Kamera), „heading“ (Azimut), „tilt“ (Neigung), „range“ (Reichweite) und „roll“ (Rolle).
Mitte (Breiten-/Längengrad/Höhe)
Der Mittelpunkt definiert den Punkt im 3D-Raum, den die Kamera beobachtet.
Dies wird mit der Klasse LatLngAltitude angegeben, die Werte für Breiten- und Längengrad sowie Höhe kombiniert. So lässt sich der Fokus der Kamera in drei Dimensionen präzise positionieren.
Der Breitengrad kann zwischen -90 und 90 Grad liegen. Der Längengrad kann zwischen -180 bis 180 Grad liegen. Die Höhe wird in Metern über dem Meeresspiegel angegeben.
Überschrift
Die Richtung der Kamera gibt an, in welche Richtung die Kamera zeigt. Sie wird in Grad im Uhrzeigersinn vom geografischen Norden aus gemessen. Nord entspricht 0 Grad, Ost 90 Grad, Süd 180 Grad und West 270 Grad. Damit wird die Ausrichtung der Kamera um die vertikale Achse des Mittelpunkts bestimmt.
Neigen
Die Neigung gibt den Winkel der Kamera in Bezug auf die vertikale Achse an, gemessen in Grad. Bei einer Neigung von 0 Grad zeigt die Kamera direkt nach unten auf die Erde (Nadir). Bei einer Neigung von 90 Grad zeigt die Kamera horizontal in die durch die Abweichung angegebene Richtung.
Bereich
Der Bereich definiert die Entfernung in Metern zwischen der Position der Kamera und dem Mittelpunkt, auf den sie gerichtet ist. Der Bereich kann von null Metern (Makro) bis zu 63 Millionen Metern variieren. So sind sowohl Nahaufnahmen als auch eine wirklich globale Perspektive möglich. Damit wird effektiv gesteuert, wie stark die Karte herangezoomt oder herausgezoomt wird.
Rotieren
Mit der Rollung wird der Winkel der Kamera in Bezug auf den Horizont festgelegt, gemessen in Grad. Mit diesem Parameter können Sie Effekte wie das Neigen während Flugsimulationen oder sogar eine komplette Rolle erzeugen, bei der die Kamera um ihre Sichtachse gedreht wird.
Kamera steuern
Das folgende Codebeispiel zeigt, wie die Kamera programmatisch durch Aufrufen der Methode setCamera gesteuert wird.
Wenn Sie dieses Codebeispiel verwenden möchten, folgen Sie der Anleitung unter Einrichtung und 3D‑Karte zur App hinzufügen, um Ihr Android Studio-Projekt mit einer einfachen 3D‑Karte einzurichten. Fügen Sie dann der Datei MainActivity.kt den folgenden Code hinzu:
// Add imports import com.google.android.gms.maps3d.model.latLngAltitude ... // Add to the onMap3DViewReady method, after the googleMap3D object has been initialized googleMap3D.setCamera( camera { center = latLngAltitude { latitude = 38.743502 longitude = -109.499374 altitude = 1467.0 } heading = 350.0 tilt = 58.1 range = 138.2 roll = 0.0 } )