Kamera und Ansicht

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

Mit dem Maps SDK for iOS können Ihre Nutzer Ihre Karten neigen und drehen, um sie an die für ihren Kontext sinnvolle Ausrichtung anzupassen. Auf jeder Zoomstufe können Nutzer die Karte geschwenkt oder die Perspektive gewechselt werden.

Durch Veränderungen der Kamera ändern sich jedoch die Markierungen, Polylinien oder andere hinzugefügte Grafiken nicht, wobei Sie jedoch ggf. Änderungen an Ihren Ergänzungen vornehmen sollten, um sie besser an die neue Ansicht anzupassen.

Kartenansicht

Das Maps SDK for iOS verwendet die Mercator-Projektion, um die Erdoberfläche (eine Kugel) auf dem Bildschirm Ihres Geräts (eine ebene Fläche) darzustellen.

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.

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.

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.

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 circa 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 ca. 256 × 2^N Punkte. Bei Zoomstufe 2 ist sie demzufolge ca. 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

Anfangsposition der Kamera festlegen

Lege die Anfangsposition der Kamera mit dem Objekt GMSCameraPosition fest. Damit kannst du den Breiten- und Längengrad des Ziels sowie Ausrichtung, Neigung und Zoom festlegen.

Um die Anfangsposition der Kamera festzulegen, erstellen Sie ein GMSMapViewOptions-Objekt und setzen Sie die Eigenschaft camera auf GMSCameraPosition. Übergeben Sie dann Ihre Optionen an den GMSMapView-Konstruktor.

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

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 Standardmethode UIView init erstellen. In diesem Fall beginnt die Kameraposition am Standardort und Sie ändern sie nach der Erstellung.

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

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 festzulegen. GMSMapView bietet mehrere Methoden, mit denen Sie die Kameraposition ändern können. Normalerweise werden GMSCameraPosition oder GMSCameraUpdate verwendet:

• GMSCameraPosition enthält Eigenschaften und Methoden, mit denen Sie alle Parameter der Kameraposition ändern können: Ziel, Ausrichtung, Neigung und Zoom.

• Mit GMSCameraUpdate können Sie Ziel, Ausrichtung, Neigung und Zoom ändern. Außerdem bietet es zusätzliche praktische Methoden, z. B. zum Scrollen, zum erweiterten Zoomen und zum Zentrieren der Kamera innerhalb vordefinierter Grenzen.

Wenn Sie die Kamera bewegen, können Sie festlegen, ob sie an der neuen Position „einrastet“ (d. h., es gibt keine Animation) oder ob die Bewegung animiert wird. Wenn Sie beispielsweise eine Änderung am Zielstandort der Kamera animieren, wird die Kamera von der vorherigen Position zum neuen Ziel schwenken.

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 auf den neuen Ort zu schwenken.

Mit einem GMSCameraPosition-Objekt können Sie Kameraeigenschaften wie Breiten- und Längengrad, Zoom, Ausrichtung und Blickwinkel konfigurieren. Mit diesem Objekt legen Sie dann die camera-Property von GMSMapView fest.

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

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

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

Verwenden Sie die Methode animateToCameraPosition:, um die Bewegung zu animieren, anstatt die Property camera festzulegen.

„GMSCameraUpdate“ verwenden

Mit GMSCameraUpdate können Sie die Kameraposition aktualisieren und festlegen, ob die Kamera an diese neue Position springt oder sich dorthin animiert. Der Vorteil von GMSCameraUpdate ist die Bequemlichkeit. Mit GMSCameraPosition können Sie dieselben Aufgaben ausführen wie mit GMSCameraUpdate. GMSCameraUpdate bietet jedoch zusätzliche Hilfsmethoden, die die Bedienung 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 eins höher als der aktuelle Zoom 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 Methode GMSMapView animateWithCameraUpdate: übergeben.

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

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

Verwenden Sie stattdessen die Methode GMSMapView moveCamera:, um die Kamera an die neue Position zu snappen.

Im nächsten Beispiel verwenden Sie GMSCameraUpdate, um eine Kamerabewegung zu animieren, damit Vancouver zentriert wird.

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

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

GMSCameraUpdate-Objekt erstellen

Erstellen Sie ein GMSCameraUpdate-Objekt mit einer der Methoden.

zoomIn: und zoomOut:

Die aktuelle Zoomstufe um 1,0 ändern, 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 bei einem negativen Wert) die Zoomstufe um den angegebenen Wert.

zoomBy:atPoint:

Erhöht (oder verringert bei einem negativen Wert) die Zoomstufe um den angegebenen Wert und behält dabei die Position des angegebenen Punkts auf dem Bildschirm bei.

setTarget:

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

setTarget:zoom:

Ändert den Breiten- und Längengrad sowie den Zoom der Kamera, wobei alle anderen Eigenschaften beibehalten werden.

setCamera:

Legt einen neuen 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. Der Bildlauf ist relativ zur aktuellen Ausrichtung der Kamera. Bei einer Kameraposition von 90 Grad ist beispielsweise Osten „oben“.

fitBounds:

Die Kamera wird so transformiert, dass die angegebenen Grenzen auf dem Bildschirm mit der größtmöglichen Zoomstufe zentriert werden. Wählt einen Standardabstand von 64 Punkten für die Ränder aus.

fitBounds:withPadding:

Die Kamera wird so transformiert, dass die angegebenen Grenzen auf dem Bildschirm mit der größtmöglichen Zoomstufe zentriert werden. Mit dieser Methode können Sie für alle Seiten des Begrenzungsrahmens denselben Abstand in Punkten angeben.

fitBounds:withEdgeInsets:

Die Kamera wird so transformiert, dass die angegebenen Grenzen auf dem Bildschirm mit der größtmöglichen Zoomstufe zentriert werden. Mit UIEdgeInsets können Sie den Abstand für jede Seite des Begrenzungsrahmens unabhängig voneinander festlegen.

GMSMapView zum Ändern einer einzelnen Property verwenden

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

Mit der Methode toViewingAngle: kannst du beispielsweise eine Änderung der Kameraneigung animieren.

mapView.animate(toViewingAngle: 45)
      

[mapView animateToViewingAngle:45];
      

Ziel (Standort) festlegen

Der Standort bestimmt die Kartenmitte. Standorte werden durch Längen- und Breitengrad angegeben und programmatisch durch ein CLLocationCoordinate2D dargestellt, das mit CLLocationCoordinate2DMake erstellt wurde.

Verwenden Sie GMSCameraPosition, um den Standort zu ändern. In diesem Beispiel wird die Karte an den neuen Standort angedockt.

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

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

Wenn Sie die Änderung animieren und die Karte auf die neue Position schwenken möchten, können Sie die Methode animateToCameraPosition: verwenden, anstatt die Eigenschaft camera festzulegen. Alternativ können Sie die Methode animateToLocation: auf GMSMapView anwenden.

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

[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 anzugeben, um die die Kamera in X- und Y-Richtung scrollen soll. In diesem Beispiel scrollen Sie die Kamera 200 Punkte nach rechts und 100 Punkte nach unten:

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

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

Richtung (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 auf einer Karte Osten oben ist.

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

mapView.animate(toBearing: 0)
      

[mapView animateToBearing:0];
      

Neigung (Blickwinkel) festlegen

Der Blickwinkel ist die Position der Kamera auf einem Bogen, der vom Mittelpunkt der Karte zur Erdoberfläche verläuft, gemessen im Gradabstand vom Nadir (Richtung von der Kamera direkt nach unten). Wenn Sie den Blickwinkel ändern, wird die Karte perspektivisch dargestellt. Objekte zwischen Kamera und Kartenposition erscheinen dann proportional größer, während Objekte jenseits der Kartenposition kleiner dargestellt werden. Hierdurch entsteht ein dreidimensionaler Effekt.

Der Blickwinkel kann zwischen 0 (direkt auf die Karte gerichtet) und einem von der Zoomstufe abhängigen Maximum liegen. Bei Zoomstufe 16 oder höher beträgt der maximale Neigungswinkel 65 Grad. Bei Zoomstufe 10 oder niedriger beträgt der maximale Winkel 30 Grad.

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

mapView.animate(toViewingAngle: 45)
      

[mapView animateToViewingAngle:45];
      

Zoom festlegen

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.

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

mapView.animate(toZoom: 12)
      

[mapView animateToZoom:12];
      

Im folgenden Beispiel wird mit der Methode zoomIn: ein GMSCameraUpdate-Objekt erstellt, um einen Zoom von der aktuellen Ebene um eine Ebene zu animieren.

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

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

Grenzen setzen

Wenn Sie die Kamera so positionieren möchten, dass ein gesamter Bereich von Interesse mit der größtmöglichen Zoomstufe dargestellt wird, legen Sie Grenzen für die Kameraansicht fest. Wenn Sie zum Beispiel alle Tankstellen im Umkreis von fünf Kilometern von der aktuellen Nutzerposition eingeblendet haben, sollte sich die Kamera so bewegen, dass alle Tankstellen auf dem Bildschirm zu sehen sind:

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

Wenn Sie diese Grenzen festlegen, passt die angegebene GMSCoordinateBounds vollständig in die Größe der aktuellen Karte. Mit dieser Methode werden die Neigung und die Lage/Ausrichtung der Karte auf 0 festgelegt.

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

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
      

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;
      

Schwenken auf einen bestimmten Bereich beschränken

In diesen Szenarien werden die Grenzen der Karte festgelegt. Der Nutzer kann jedoch außerhalb dieser Grenzen scrollen oder schwenken. Sie können aber auch die Koordinatengrenzwerte des Kartenfokus (Kameraziels) einschränken, sodass Nutzer nur innerhalb dieser Grenzen scrollen und schwenken können.

Beispiel: Eine Einzelhandels-App für ein Einkaufszentrum oder einen Flughafen kann die Karte auf bestimmte Grenzen beschränken und ermöglicht Nutzern das Scrollen und Schwenken innerhalb dieser Grenzen.

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

mapView.cameraTargetBounds = bounds
      

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 beschränkte Grenzen auf und bietet dem Nutzer nur wenige Möglichkeiten zum Scrollen oder Schwenken. 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.

Wenn Sie den Bereich der für die Karte verfügbaren Zoomstufen einschränken möchten, legen Sie eine minimale und eine maximale Zoomstufe fest. Im folgenden Code wird die Zoomstufe auf 10 bis 15 beschränkt.

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

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 abrufen. Dieser Ansatz ist hilfreich, wenn nur einer der Werte eingeschränkt werden soll. Mit dem folgenden Code wird nur die minimale Zoomstufe geändert.

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

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

Wenn nach dem Aktualisieren des Mindest- und Höchstzooms die Zoomstufe der Kamera auf einen Wert außerhalb des neuen Bereichs festgelegt ist, wird der aktuelle Zoom automatisch auf den nächsten gültigen Wert aktualisiert. Im folgenden Code ist der ursprüngliche Zoom beispielsweise auf 4 festgelegt. Wenn der Zoombereich später auf 10–15 festgelegt wird, wird der aktuelle Zoom auf 10 aktualisiert.

// 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)
      

// 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];