Kamera und Ansicht

Plattform auswählen: Android iOS JavaScript

Mit dem Maps SDK for iOS können Sie die Nutzeransicht der Karte ändern, indem Sie die Kamera der Karte ändern.

Mit dem Maps SDK for iOS können Nutzer Ihre Karten neigen und drehen, um sie an eine für ihren Kontext sinnvolle Ausrichtung anzupassen. Nutzer können bei jeder Zoomstufe die Karte schwenken oder die Perspektive mit sehr geringer Latenz ändern.

Markierungen, Polylinien oder andere Grafiken, die Sie hinzugefügt haben, werden durch Änderungen an der Kamera nicht geändert. Sie können diese Ergänzungen jedoch ändern, damit sie besser in die neue Ansicht passen.

Kartenansicht

Im Maps SDK for iOS wird die Mercator-Projektion verwendet, um die Weltoberfläche (eine Kugel) auf dem Bildschirm Ihres Geräts als ebene Ebene darzustellen.

Hinweis: Eine Mercator-Projektion hat eine begrenzte Höhe nach Längengraden (Nord/Süd), aber eine unendliche Breite nach Osten (Osten/Westen). Das bedeutet, dass sich die Kartenansicht unendlich nach Osten und Westen wiederholt. In Nord- und Südrichtung werden die Bilder der Basiskarte mithilfe der Mercator-Projektion bei etwa +/- 85 Grad geschnitten, damit die resultierende Kartenform quadratisch ist. Dies ermöglicht eine einfachere Logik für die Kachelauswahl.

Kameraposition

Die Kartenansicht ist so modelliert, als sei eine Kamera auf eine ebene Fläche ausgerichtet. Die Position der Kamera (und damit das Rendern der Karte) wird durch folgende Eigenschaften festgelegt: Ziel (Breiten- und Längengrad), Lage (Ausrichtung), Neigung (Blickwinkel) und Zoom.

Ziel (Standort)

Das Kameraziel ist der Standort in der Kartenmitte, angegeben in Breiten- und Längengradkoordinaten.

Der Breitengrad kann zwischen -85 und 85 Grad liegen. Werte ober- oder unterhalb dieses Bereichs werden auf den nächstgelegenen Wert innerhalb des Bereichs gesetzt. Wird z. B. 100 als Breitengrad angeben, wird der Wert auf 85 gesetzt. Der Längengrad kann zwischen -180 bis 180 Grad liegen. Werte ober- oder unterhalb dieses Bereichs werden so umgerechnet, dass sie in diesen Längengrad-Bereich fallen. Beispielsweise wird bei 480, bei 840 und bei 1.200 Grad der Wert auf 120 Grad gesetzt.

Lage (Ausrichtung)

Die Lage der Kamera gibt die Kompassrichtung an. Sie wird in Grad vom geografischen Norden gemessen, der dem oberen Rand der Karte entspricht. Wenn Sie eine vertikale Linie von der Kartenmitte zum oberen Rand der Karte ziehen, entspricht die Lage der Ausrichtung der Kamera (gemessen in Grad) relativ zum geografischen Norden.

Eine Lage von 0 bedeutet, dass der obere Rand der Karte dem geografischen Norden entspricht. Bei 90 zeigt er nach Osten (90 Grad auf einem Kompass). Ein Wert von 180 bedeutet, dass der obere Rand der Karte nach Süden zeigt.

Mit der Google Maps API lässt sich die Lage einer Karte ändern. Beispielsweise drehen Autofahrer eine Straßenkarte häufig so, dass sie ihrer Fahrtrichtung entspricht, während Wanderer Karte und Kompass zumeist so halten, dass die vertikale Linie nach Norden zeigt.

Neigung (Blickwinkel)

Die Neigung definiert die Kameraposition auf einem Bogen, der direkt über dem Kartenmittelpunkt verläuft. Sie wird in Grad Abstand vom Nadir (Richtung von der Kamera direkt nach unten) gemessen. Ein Wert von 0 entspricht einer Kamera, die gerade nach unten gerichtet ist. Bei Werten über 0 ist die Kamera um die angegebene Gradzahl auf den Horizont ausgerichtet. Wenn Sie den Blickwinkel ändern, wird die Karte perspektivisch dargestellt. Weit entfernte Objekte erscheinen dann kleiner und nahe Objekte größer. Das wird in den folgenden Abbildungen verdeutlicht.

In den unten stehenden Bildern beträgt der Blickwinkel 0 Grad. Das ist im ersten Bild schematisch dargestellt: Position 1 ist die Kameraposition und Position 2 die aktuelle Kartenposition. Die daraus resultierende Karte ist nachfolgend dargestellt.

Karte aus dem Standardblickwinkel der Kamera

Standard-Blickwinkel der Kamera

In den Bildern unten beträgt der Blickwinkel 45 Grad. Die Kamera bewegt sich auf halber Strecke entlang eines Bogens zwischen Zenit (0 Grad) und Boden (90 Grad) auf Position 3. Sie zeigt immer noch auf den Kartenmittelpunkt, allerdings ist jetzt der Bereich sichtbar, der von der Linie an Position 4 dargestellt wird.

Karte unter einem Blickwinkel von 45 Grad

Kamerablickwinkel von 45 Grad

Die Karte im Screenshot ist zwar weiterhin auf den gleichen Punkt zentriert wie die ursprüngliche Karte, allerdings sind jetzt oben auf der Karte mehr Objekte zu sehen. Wenn Sie den Winkel auf über 45 Grad vergrößern, erscheinen Objekte zwischen Kamera und Kartenposition proportional größer, während Objekte jenseits der Kartenposition kleiner dargestellt werden. Hierdurch entsteht ein dreidimensionaler Effekt.

Zoom

Von der Zoomstufe der Kamera hängt in Maps der Maßstab der Karte ab. Bei größeren Zoomstufen sind auf dem Bildschirm mehr Details zu sehen, bei kleineren Zoomstufen erhalten Sie einen größeren Überblick. Bei Zoomstufe 0 hat die Karte einen Maßstab, bei dem die gesamte Erde eine Breite von etwa 256 Punkten hat.

Wenn man die Zoomstufe um 1 erhöht, verdoppelt sich die Breite der Erde auf dem Bildschirm. Bei Zoomstufe N beträgt die Breite der Erde also ca. 256 × 2^N Punkte. Bei Zoomstufe 2 ist die Erde beispielsweise ungefähr 1.024 Punkte breit.

Die Zoomstufe muss nicht als ganze Zahl angegeben werden. Der für eine Karte zulässige Zoomstufenbereich hängt von einer Reihe von Faktoren ab, z. B. dem Ziel, dem Kartentyp und der Bildschirmgröße. Jede Zahl außerhalb des Bereichs wird in den nächsten gültigen Wert konvertiert. Das kann entweder die minimale oder die maximale Zoomstufe sein. Die folgende Liste enthält die ungefähre Detailebene, die Sie bei der jeweiligen Zoomstufe wahrscheinlich sehen können:

• 1: Welt
• 5: Landmasse/Kontinent
• 10: Stadt
• 15: Straßen
• 20: Gebäude

Hinweis: Aufgrund von Bildschirmgröße und ‑dichte unterstützen einige Geräte eventuell die niedrigsten Zoomstufen nicht. Mit der Eigenschaft minZoom von GMSMapView lässt sich die minimale Zoomstufe für die Karte abrufen.

Die folgenden Bilder zeigen die visuelle Darstellung bei unterschiedlichen Zoomstufen.

Karte mit Zoomstufe 5

Karte mit Zoomstufe 15

Karte mit Zoomstufe 20

Anfangsposition der Kamera festlegen

Legen Sie die Anfangsposition der Kamera mit dem Objekt GMSCameraPosition fest. Damit können Sie Breiten- und Längengrad des Ziels sowie Ausrichtung, Neigung und Zoom festlegen.

Zum Festlegen der Anfangsposition der Kamera erstellen Sie ein GMSMapViewOptions-Objekt und setzen die Eigenschaft camera auf GMSCameraPosition. Übergeben Sie die Optionen dann an den Convenience-Konstruktor GMSMapView.

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 16)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:16];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Sie können das GMSMapView-Objekt auch mit der Standardinitialisierungsmethode UIView erstellen. In diesem Fall beginnt die Kameraposition am Standardstandort und kann nach dem Erstellen geändert werden.

Swift

let options = GMSMapViewOptions()
options.frame = self.view.bounds
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.frame = self.view.bounds;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Kameraposition ändern

Sie können die Kameraposition programmatisch ändern, um Standort, Ausrichtung, Neigung und Zoom einzustellen. GMSMapView bietet zwar mehrere Methoden zum Ändern der Kameraposition, normalerweise verwendest du aber GMSCameraPosition oder GMSCameraUpdate:

• GMSCameraPosition enthält Eigenschaften und Methoden, mit denen Sie die einzelnen Parameter für die Kameraposition ändern können: Ziel, Peilung, Neigung und Zoom.

• Mit GMSCameraUpdate können Sie Ziel, Peilung, Neigung und Zoom ändern. Außerdem stehen Ihnen zusätzliche praktische Methoden zur Verfügung, die unter anderem das Scrollen, erweiterte Zoomen und das Zentrieren der Kamera innerhalb vordefinierter Grenzen unterstützen.

Wenn Sie die Kamera bewegen, können Sie sie an die neue Position andocken, d. h., es gibt keine Animation oder die Bewegung wird animiert. Wenn Sie beispielsweise eine Änderung am Zielstandort der Kamera animieren, wird die Animation vom vorherigen zum neuen Standort geschwenkt.

Die Animation wird zwischen den aktuellen und den neuen Kameraattributen interpoliert. Sie können die Dauer der Animation mit Core Animation steuern.

„GMSCameraPosition“ verwenden

Wenn Sie die Kamera mit GMSCameraPosition ändern möchten, erstellen Sie ein neues Objekt oder kopieren ein vorhandenes Objekt und legen es dann auf das GMSMapView-Objekt fest. Verwenden Sie das Objekt GMSCameraPosition, um die Kamera mit oder ohne Animation an den neuen Standort auszurichten.

Verwenden Sie ein GMSCameraPosition-Objekt, um Kameraeigenschaften wie Breiten- und Längengrad, Zoom, Peilung und Blickwinkel zu konfigurieren. Mit diesem Objekt legen Sie dann das Attribut camera von GMSMapView fest.

Swift

let fancy = GMSCameraPosition(
  latitude: -33,
  longitude: 151,
  zoom: 6,
  bearing: 270,
  viewingAngle: 45
)
mapView.camera = fancy
      

Objective-C

GMSCameraPosition *fancy = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                       longitude:151.2086
                                                            zoom:6
                                                         bearing:30
                                                    viewingAngle:45];
[mapView setCamera:fancy];
      

Lassen Sie alle GMSCameraPosition-Attribute weg, die Sie auf den Standardwert setzen möchten.

Verwenden Sie zum Animieren des Verschiebevorgangs die Methode animateToCameraPosition:, anstatt das Attribut camera festzulegen.

„GMSCameraUpdate“ verwenden

Mit GMSCameraUpdate können Sie die Kameraposition aktualisieren und festlegen, ob sie an der neuen Position andocken oder animiert werden soll. Der Vorteil von GMSCameraUpdate ist die Benutzerfreundlichkeit. Mit GMSCameraPosition können Sie dieselben Aufgaben wie mit GMSCameraUpdate ausführen. GMSCameraUpdate bietet jedoch zusätzliche Hilfsmethoden, die die Bearbeitung der Kamera erleichtern.

Wenn Sie beispielsweise mit GMSCameraPosition die aktuelle Zoomstufe erhöhen möchten, müssen Sie zuerst die aktuelle Zoomstufe ermitteln und dann ein GMSCameraPosition-Objekt erstellen, in dem Sie den Zoom auf einen Wert festlegen, der um einen Wert größer als der aktuelle Zoomwert ist.

Alternativ können Sie ein GMSCameraUpdate-Objekt mit der Methode zoomIn: erstellen. Aktualisieren Sie dann die Kamera, indem Sie das GMSCameraUpdate-Objekt an die animateWithCameraUpdate:-Methode GMSMapView übergeben.

Swift

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)
      

Objective-C

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];
      

Verwenden Sie stattdessen die GMSMapView-Methode moveCamera:, um die Kamera an der neuen Position auszurichten.

Im nächsten Beispiel wird mit GMSCameraUpdate eine Bewegung der Kamera animiert, um sie auf Vancouver zu zentrieren.

Swift

// Center the camera on Vancouver, Canada
let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let vancouverCam = GMSCameraUpdate.setTarget(vancouver)
mapView.animate(with: vancouverCam)
      

Objective-C

// Center the camera on Vancouver, Canada
CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
GMSCameraUpdate *vancouverCam = [GMSCameraUpdate setTarget:vancouver];
[mapView animateWithCameraUpdate:vancouverCam];
      

GMSCameraUpdate-Objekt erstellen

Konstruieren Sie ein GMSCameraUpdate-Objekt mithilfe einer seiner Methoden.

zoomIn: und zoomOut:

Die aktuelle Zoomstufe wird um 1,0 geändert, während alle anderen Eigenschaften beibehalten werden.

zoomTo:

Ändert die Zoomstufe in den angegebenen Wert, während alle anderen Eigenschaften beibehalten werden.

zoomBy:

Erhöht (oder verringert, wenn der Wert negativ ist) die Zoomstufe um den angegebenen Wert.

zoomBy:atPoint:

Erhöht (oder verringert, wenn der Wert negativ ist) die Zoomstufe um den angegebenen Wert, während die Position des angegebenen Punkts auf dem Bildschirm beibehalten wird.

setTarget:

Ändert den Breiten- und Längengrad der Kamera, während alle anderen Eigenschaften beibehalten werden.

setTarget:zoom:

Ändert Breiten- und Längengrad sowie Zoomstufe der Kamera, während alle anderen Eigenschaften beibehalten werden.

setCamera:

Legt eine neue GMSCameraPosition fest.

scrollByX:Y:

Ändert den Breiten- und Längengrad der Kamera, um die Karte um die angegebene Anzahl von Punkten zu verschieben. Ein positiver X-Wert führt dazu, dass die Kamera nach rechts bewegt wird, sodass der Eindruck entsteht, die Karte wäre nach links verschoben worden. Ein positiver Y-Wert führt dazu, dass die Kamera nach unten bewegt wird, sodass der Eindruck entsteht, die Karte wäre nach oben verschoben worden. Das Scrollen richtet sich nach der aktuellen Ausrichtung der Kamera. Bei einer Kameraposition von 90 Grad ist beispielsweise Osten „oben“.

fitBounds:

Wandelt die Kamera so um, dass die angegebenen Grenzen auf dem Bildschirm bei der größtmöglichen Zoomstufe zentriert werden. Wendet auf die Grenzen ein Standard-Padding von 64 Punkten an.

fitBounds:withPadding:

Wandelt die Kamera so um, dass die angegebenen Grenzen bei der größtmöglichen Zoomstufe auf dem Bildschirm zentriert werden. Verwenden Sie diese Methode, um für alle Seiten des Begrenzungsrahmens denselben Abstand in Punkten anzugeben.

fitBounds:withEdgeInsets:

Wandelt die Kamera so um, dass die angegebenen Grenzen bei der größtmöglichen Zoomstufe auf dem Bildschirm zentriert werden. Mit UIEdgeInsets legen Sie das Padding für jede Seite des Begrenzungsrahmens unabhängig fest.

Hinweis :Bei den fitBounds:-Methoden werden sowohl der Füllbereich, den Sie auf der Karte festgelegt haben, als auch alle Padding-Werte, die beim Einpassen des Rahmens angegeben wurden, berücksichtigt. Wenn Sie beispielsweise 100 Punkte für den Abstand von GMSMapView angeben und dann die Methode fitBounds: aufrufen, berücksichtigen die Kameratransformationen die 64 Punkte des Standard-Paddings zusätzlich zu den 100 Punkten des benutzerdefinierten Abstands.

Mit GMSMapView eine einzelne Property ändern

GMSMapView bietet mehrere Methoden, mit denen Sie die Kamera ohne ein GMSCameraPosition- oder GMSCameraUpdate-Objekt bewegen können. Mit diesen Methoden wie animateToLocation: oder animateToZoom: können Sie eine Änderung an einer einzelnen Kameraeigenschaft animieren.

Hinweis :GMSMapView bietet Methoden zum Ändern einer einzelnen Eigenschaft. Normalerweise verwenden Sie jedoch GMSCameraPosition oder GMSCameraUpdate, um die Kamera zu bewegen, auch wenn Sie mehrere Kameraeigenschaften ändern möchten.

Sie können beispielsweise die Methode toViewingAngle: verwenden, um eine Änderung der Kameraneigung zu animieren.

Swift

mapView.animate(toViewingAngle: 45)
      

Objective-C

[mapView animateToViewingAngle:45];
      

Ziel festlegen (Standort)

Der Standort bestimmt die Kartenmitte. Standorte werden durch Breiten- und Längengrad angegeben und programmatisch durch eine CLLocationCoordinate2D dargestellt, die mit CLLocationCoordinate2DMake erstellt wird.

Verwende GMSCameraPosition, um den Standort zu ändern. In diesem Beispiel wird die Karte an den neuen Standort ausgerichtet.

Swift

let target = CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208)
mapView.camera = GMSCameraPosition(target: target, zoom: 6)
      

Objective-C

CLLocationCoordinate2D target =
    CLLocationCoordinate2DMake(-33.868, 151.208);
mapView.camera = [GMSCameraPosition cameraWithTarget:target zoom:6];
      

Wenn Sie die Änderung animieren und die Karte zum neuen Ort schwenken möchten, können Sie die Methode animateToCameraPosition: verwenden, anstatt die Eigenschaft camera festzulegen. Alternativ können Sie die Methode animateToLocation: für GMSMapView verwenden.

Swift

mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))
      

Objective-C

[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];
      

Sie können auch ein GMSCameraUpdate-Objekt erstellen, um die Kamera zu bewegen. Verwenden Sie die integrierte Methode scrollByX:Y:, um die Anzahl der Punkte zum Scrollen der Kamera in X- und Y-Richtung anzugeben. In diesem Beispiel scrollen Sie 200 Punkte nach rechts und 100 Punkte nach unten durch die Kamera:

Swift

// Move the camera 200 points to the right, and 100 points downwards
let downwards = GMSCameraUpdate.scrollBy(x: 200, y: 100)
mapView.animate(with: downwards)
      

Objective-C

// Move the camera 200 points to the right, and 100 points downwards
GMSCameraUpdate *downwards = [GMSCameraUpdate scrollByX:200.0 Y:100.0];
[mapView animateWithCameraUpdate:downwards];
      

Peilung (Ausrichtung) festlegen

Die Lage ist die Kompassrichtung, gemessen in Grad vom geografischen Norden, für den oberen Rand der Karte. Eine Lage von 90 Grad führt beispielsweise dazu, dass der obere Rand einer Karte nach Osten zeigt.

Legen Sie die Lage programmatisch mit GMSCameraPosition oder GMSCameraUpdate oder mit der animateToBearing:-Methode von GMSMapView fest.

Swift

mapView.animate(toBearing: 0)
      

Objective-C

[mapView animateToBearing:0];
      

Neigung (Blickwinkel) festlegen

Der Blickwinkel ist die Kameraposition auf einem Bogen zwischen dem Kartenmittelpunkt und der Erdoberfläche. Er wird in Grad vom Nadir (Richtung von der Kamera direkt nach unten) gemessen. Wenn Sie den Blickwinkel ändern, wird die Karte perspektivisch dargestellt. Dabei erscheinen Elemente zwischen Kamera und Kartenposition proportional größer, während Objekte jenseits der Kartenposition proportional kleiner erscheinen, was einen dreidimensionalen Effekt erzeugt.

Der Blickwinkel kann zwischen 0 (senkrecht nach unten auf der Karte) und bis zu einem von der Zoomstufe abhängigen Maximum reichen. Bei Zoomstufe 16 oder höher beträgt der maximale Winkel 65 Grad. Bei Zoomstufe 10 oder niedriger beträgt der maximale Winkel 30 Grad.

Sie können den Blickwinkel programmatisch mit GMSCameraPosition oder GMSCameraUpdate oder mit der animateToViewingAngle:-Methode von GMSMapView festlegen.

Swift

mapView.animate(toViewingAngle: 45)
      

Objective-C

[mapView animateToViewingAngle:45];
      

Zoom festlegen

Von der Zoomstufe der Kamera hängt in Maps der Maßstab der Karte ab. Bei größeren Zoomstufen sehen Sie mehr Details auf dem Bildschirm, während Sie bei kleineren Zoomstufen mehr von der Welt sehen können.

Legen Sie den Zoom programmatisch mit GMSCameraPosition oder GMSCameraUpdate oder mit der animateToZoom:-Methode von GMSMapView fest.

Swift

mapView.animate(toZoom: 12)
      

Objective-C

[mapView animateToZoom:12];
      

Im folgenden Beispiel wird mit der Methode zoomIn: ein GMSCameraUpdate-Objekt erstellt, mit dem ein Zoomen um eine Stufe ausgehend von der aktuellen Ebene animiert wird.

Swift

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)
      

Objective-C

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];
      

Grenzen setzen

Wenn Sie die Kamera so bewegen möchten, dass ein gesamter Bereich von Interesse mit der größtmöglichen Zoomstufe sichtbar ist, legen Sie Begrenzungen für die Kameraansicht fest. Wenn Sie beispielsweise alle Tankstellen im Umkreis von fünf Meilen um die aktuelle Position des Nutzers anzeigen möchten, bewegen Sie die Kamera so, dass sie alle auf dem Bildschirm zu sehen sind:

1. Berechnen Sie den GMSCoordinateBounds, der auf dem Bildschirm sichtbar sein soll.
2. Verwenden Sie die Methode cameraForBounds:insets: von GMSMapView, um einen neuen GMSCameraPosition zurückzugeben.

Wenn Sie diese Grenzen festlegen, wird sichergestellt, dass der angegebene GMSCoordinateBounds vollständig in die aktuelle Kartengröße passt. Beachten Sie, dass mit dieser Methode Neigung und Lage der Karte auf 0 festgelegt werden.

Im folgenden Beispiel wird gezeigt, wie Sie die Kamera so ändern, dass die Städte Vancouver und Calgary in derselben Ansicht erscheinen.

Swift

let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let calgary = CLLocationCoordinate2D(latitude: 51.05,longitude: -114.05)
let bounds = GMSCoordinateBounds(coordinate: vancouver, coordinate: calgary)
let camera = mapView.camera(for: bounds, insets: UIEdgeInsets())!
mapView.camera = camera
      

Objective-C

CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
CLLocationCoordinate2D calgary = CLLocationCoordinate2DMake(51.05, -114.05);
GMSCoordinateBounds *bounds =
    [[GMSCoordinateBounds alloc] initWithCoordinate:vancouver coordinate:calgary];
GMSCameraPosition *camera = [mapView cameraForBounds:bounds insets:UIEdgeInsetsZero];
mapView.camera = camera;
      

Hinweis: Die Methode cameraForBounds:insets: berücksichtigt zusätzlich zu den hier angegebenen Einfügungen das Padding, das im GMSMapView festgelegt wurde.

Schwenken auf einen bestimmten Bereich beschränken

In diesen Szenarien werden die Grenzen der Karte festgelegt, aber der Nutzer kann dann außerhalb dieser Grenzen scrollen oder schwenken. Sie können stattdessen die Mittelpunktgrenzen der Koordinaten des Kartenfokus (Kameraziels) so einschränken, dass Nutzer nur innerhalb dieser Grenzen scrollen und schwenken können.

Beispielsweise kann eine Einzelhandels-App für ein Einkaufszentrum oder einen Flughafen die Karte auf bestimmte Grenzen beschränken, damit Nutzer innerhalb dieser Grenzen scrollen und schwenken können.

Wenn Sie das Schwenken auf bestimmte Grenzen beschränken möchten, legen Sie die Eigenschaft cameraTargetBounds von GMSMapView auf ein GMSCoordinateBounds-Objekt fest, das die erforderlichen Grenzen definiert. Wenn Sie die Einschränkung später aufheben möchten, setzen Sie cameraTargetBounds auf „nil“.

Swift

mapView.cameraTargetBounds = bounds
      

Objective-C

mapView.cameraTargetBounds = bounds;
      

Im folgenden Diagramm wird ein Szenario veranschaulicht, in dem das Kameraziel auf einen Bereich beschränkt ist, der etwas größer als der Darstellungsbereich ist. Unter der Voraussetzung, dass das Kameraziel innerhalb des begrenzten Bereichs bleibt, ist der Nutzer in der Lage, zu scrollen und zu schwenken. Das Kreuz stellt das Kameraziel dar:

Die Karte füllt den Darstellungsbereich immer aus, auch wenn das dazu führt, dass im Darstellungsbereich Bereiche außerhalb der festgelegten Grenzen angezeigt werden. Beispiel: Wenn Sie das Kameraziel in einer Ecke des begrenzten Bereichs positionieren, ist der Bereich jenseits der Ecke im Darstellungsbereich sichtbar. Nutzer können in diesen Bereich jedoch nicht weiter scrollen. Dieses Szenario wird im folgenden Diagramm veranschaulicht. Das Kreuz stellt das Kameraziel dar:

Im folgenden Diagramm weist das Kameraziel sehr eingeschränkte Grenzen auf, sodass der Nutzer nur sehr wenige Möglichkeiten zum Scrollen oder Schwenken der Karte hat. Das Kreuz stellt das Kameraziel dar:

Minimalen und maximalen Zoom festlegen

Die globalen Konstanten kGMSMinZoomLevel und kGMSMaxZoomLevel definieren die minimalen oder maximalen Zoomwerte. Standardmäßig sind die Attribute minZoom und maxZoom von GMSMapView auf diese Konstanten festgelegt.

Hinweis :Der zulässige Zoombereich kann auch vom Kartentyp, der Bildschirmgröße und anderen Faktoren abhängen. Jede Zahl außerhalb des zulässigen Bereichs wird in den nächstmöglichen gültigen Wert konvertiert.

Wenn Sie den Bereich der für die Karte verfügbaren Zoomstufen einschränken möchten, legen Sie eine minimale und maximale Zoomstufe fest. Der folgende Code beschränkt die Zoomstufe auf einen Wert zwischen 10 und 15.

Swift

let camera = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 12
)
let mapView = GMSMapView(frame: .zero, camera: camera)
mapView.setMinZoom(10, maxZoom: 15)
      

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:41.887
                                                       longitude:-87.622
                                                             zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero
                                        camera:camera];
[mapView setMinZoom:10 maxZoom:15];
      

Sie müssen den Zoombereich mit der Methode setMinZoom:maxZoom: festlegen. Die aktuellen Werte können Sie jedoch mit den Eigenschaften minZoom und maxZoom lesen. Dieser Ansatz ist hilfreich, wenn Sie nur einen der Werte einschränken. Mit dem folgenden Code wird nur die minimale Zoomstufe geändert.

Swift

mapView.setMinZoom(12, maxZoom: mapView.maxZoom)
      

Objective-C

[mapView setMinZoom:12 maxZoom:mapView.maxZoom];
      

Wenn nach der Aktualisierung des minimalen und maximalen Zoomfaktors die Zoomstufe der Kamera auf einen Wert außerhalb des neuen Bereichs festgelegt wird, wird der aktuelle Zoom automatisch auf den nächsten gültigen Wert aktualisiert. Im folgenden Code ist der ursprüngliche Zoom beispielsweise auf 4 definiert. Wenn der Zoombereich später auf 10–15 eingestellt wird, wird der aktuelle Zoom auf 10 aktualisiert.

Swift

// Sets the zoom level to 4.
let camera2 = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 4
)
let mapView2 = GMSMapView(frame: .zero, camera: camera)

// The current zoom, 4, is outside of the range. The zoom will change to 10.
mapView.setMinZoom(10, maxZoom: 15)
      

Objective-C

// Sets the zoom level to 4.
GMSCameraPosition *camera2 = [GMSCameraPosition cameraWithLatitude:41.887
                                                         longitude:-87.622
                                                              zoom:4];
GMSMapView *mapView2 = [GMSMapView mapWithFrame:CGRectZero
                                         camera:camera];
// The current zoom, 4, is outside of the range. The zoom will change to 10.
[mapView setMinZoom:10 maxZoom:15];