GMSMapView-Klassenreferenz


Überblick

Dies ist die Hauptklasse des Google Maps-SDK für iOS und der Einstiegspunkt für alle Methoden im Zusammenhang mit der Karte.

Die Karte sollte über einen der Konstruktoren -init oder -initWithOptions: instanziiert werden.

GMSMapView kann, ähnlich wie alle UIKit-Objekte, nur aus dem Hauptthread gelesen und geändert werden. Das Aufrufen dieser Methoden aus einem anderen Thread führt zu einer Ausnahme oder einem nicht definierten Verhalten.

Öffentliche Mitgliederfunktionen

(Instanztyp)init
 Wird mit CGRectZero und Standardoptionen initialisiert.
(Instanztyp)initWithOptions:
 Erstellt eine neue Kartenansicht mit den angegebenen Optionen.
(Instanztyp)initWithFrame:
(Instanztyp)initWithCoder:
(Instanztyp)initWithFrame:camera:
 Erstellt eine Kartenansicht mit einem Frame und einem Kameraziel und gibt sie zurück.
(Instanztyp)initWithFrame:mapID:camera:
 Erstellt eine Kartenansicht mit einem Frame, einer Karten-ID und einem Kameraziel und gibt diese zurück.
(void) startRendering
 Weist diese Karte an, ihren Renderer zu aktivieren.
(void) stopRendering
 Weist diese Karte an, ihren Renderer auszuschalten.
(void) - Glasklare
 Löscht das gesamte Markup, das der Karte hinzugefügt wurde, einschließlich Markierungen, Polylinien und Boden-Overlays.
(void) setMinZoom:maxZoom:
 Legt minZoom und maxZoom fest.
(nullable GMSCameraPosition *) cameraForBounds:insets:
 Erstellen Sie eine GMSCameraPosition, die bounds mit padding präsentiert.
(void) moveCamera:
 Stellt die Kamera entsprechend der update um.
(BOOL) areEqualForRenderingPosition:position:
 Prüfen Sie, ob die angegebenen Kamerapositionen praktisch dazu führen würden, dass die Kamera gleich gerendert wird. Berücksichtigen Sie dabei die Genauigkeit und die intern verwendeten Transformationen.
(GMSFeatureLayer
< GMSPlaceFeature * > *)
featureLayerOfFeatureType:
 Gibt eine Elementebene des angegebenen Typs zurück.
(void) animateToCameraPosition:
 Animiert die Kamera dieser Karte zu cameraPosition.
(void) animateToLocation:
 Als animateToCameraPosition:, ändert jedoch nur den Standort der Kamera, d.h. von der aktuellen Position zu location.
(void) animateToZoom:
 Als animateToCameraPosition:, ändert jedoch nur die Zoomstufe der Kamera.
(void) animateToBearing:
 Als animateToCameraPosition:, ändert jedoch nur die Peilung der Kamera (in Grad).
(void) animateToViewingAngle:
 Als animateToCameraPosition:, ändert jedoch nur den Blickwinkel der Kamera (in Grad).
(void) animateWithCameraUpdate:
 Wendet cameraUpdate auf die aktuelle Kamera an und verwendet dann das Ergebnis gemäß „animateToCameraPosition:“.

Statische Funktionen für öffentliche Mitglieder

(Instanztyp)+ mapWithFrame:camera:
 Erstellt eine Kartenansicht mit einem Frame und einem Kameraziel und gibt sie zurück.
(Instanztyp)+ mapWithFrame:mapID:camera:
 Praktischer Initialisierer zum Erstellen und Zurückgeben einer Kartenansicht mit Rahmen, Karten-ID und Kameraziel.

Attribute

IBOutlet-ID< GMSMapViewDelegate >bevollmächtigen
 GMSMapView-Delegate.
GMSCameraPositionKamera
 Steuert die Kamera und definiert die Ausrichtung der Karte.
GMSProjectionProjektion
 Gibt ein GMSProjection-Objekt zurück, das Sie zum Umwandeln von Bildschirmkoordinaten in Breiten- und Längengradkoordinaten verwenden können.
BOOLmyLocationEnabled
 Steuert, ob der Punkt „Mein Standort“ und der Genauigkeitskreis aktiviert sind.
CLLocation * myLocation
 Wenn "Mein Standort" aktiviert ist, wird angezeigt, wo der Punkt für den Gerätestandort gezeichnet wird.
GMSMarkerselectedMarker
 Die ausgewählte Markierung.
BOOLtrafficEnabled
 Steuert, ob auf der Karte Verkehrsdaten erfasst werden, falls verfügbar.
GMSMapViewTypemapType
 Steuert den Typ der Kartenkacheln, die angezeigt werden sollen.
GMSMapStylemapStyle
 Steuert den Stil der Karte.
float minZoom
 Minimaler Zoom (der weit weiteste Zoomfaktor, mit dem die Kamera herausgezoomt werden darf)
float maxZoom
 Maximaler Zoom (d. h., die Kamera muss der Erde möglichst nahe sein).
BOOLbuildingsEnabled
 Falls festgelegt, werden 3D-Gebäude angezeigt, sofern verfügbar.
BOOLindoorEnabled
 Legt fest, ob Indoor-Karten angezeigt werden, falls verfügbar.
GMSIndoorDisplayindoorDisplay
 Ruft die GMSIndoorDisplay-Instanz ab, mit der Aspekte der Datenanzeige in Innenräumen beobachtet oder gesteuert werden können.
GMSUISettingsEinstellungen
 Ruft das GMSUISettings-Objekt ab, das die Einstellungen der Benutzeroberfläche für die Karte steuert.
UIEdgeInsetsAbstand
 Steuert den "sichtbaren" Bereich der Ansicht.
GMSMapViewPaddingAdjustmentBehaviorpaddingAdjustmentBehavior
 Steuert, wie Werte für den sicheren Bereich zu den Padding-Werten hinzugefügt werden.
BOOLaccessibilityElementsHidden
 Die Standardeinstellung ist YES (JA).
GMSMapLayerEbene
 Zugriffsfunktion für den benutzerdefinierten CALayer-Typ, der für die Ebene verwendet wird.
GMSFrameRatepreferredFrameRate
 Steuert die Rendering-Framerate.
GMSCoordinateBoundscameraTargetBounds
 Ist der Wert nicht „nil“, wird das Kameraziel so eingeschränkt, dass es durch Gesten nicht die angegebenen Grenzen überschreitet.
GMSMapCapabilityFlagsmapCapabilities
 Alle bedingt verfügbaren (abhängig von der Karten-ID oder anderen Karteneinstellungen) Funktionen, die zum aktuellen Zeitpunkt verfügbar sind.

(Beachten Sie, dass dies keine Mitgliederfunktionen sind.)

NSString *constkGMSAccessibilityCompass
 Bedienungskennung für die Kompassschaltfläche
NSString *constkGMSAccessibilityMyLocation
 Bedienungskennung für die Schaltfläche „Mein Standort“.
NSString *constkGMSAccessibilityOutOfQuota
 Bedienungshilfen-ID für das Fehlerlabel „Kontingent überschritten“.

Dokumentation zu Mitgliederfunktionen

– (Instanztyp) init

Wird mit CGRectZero und Standardoptionen initialisiert.

- (Instanztyp) initWithOptions: (nicht null GMSMapViewOptions *) options

Erstellt eine neue Kartenansicht mit den angegebenen Optionen.

Der Wert des Optionsobjekts wird mit dieser Methode kopiert.

- (Instanztyp) initWithFrame: (CGRect) Frame
- (Instanztyp) initWithCoder: (NSCoder *) Coder
+ (instancetype) mapWithFrame: (CGRect) Frame
Kamera: (GMSCameraPosition *) Kamera

Erstellt eine Kartenansicht mit einem Frame und einem Kameraziel und gibt sie zurück.

+ (instancetype) mapWithFrame: (CGRect) Frame
Karten-ID: (GMSMapID *) mapID
Kamera: (GMSCameraPosition *) Kamera

Praktischer Initialisierer zum Erstellen und Zurückgeben einer Kartenansicht mit Rahmen, Karten-ID und Kameraziel.

- (Instanztyp) initWithFrame: (CGRect) Frame
Kamera: (GMSCameraPosition *) Kamera

Erstellt eine Kartenansicht mit einem Frame und einem Kameraziel und gibt sie zurück.

Hinweis:
Diese Option wurde eingestellt. Verwenden Sie stattdessen -init oder -initWithOptions:.
- (Instanztyp) initWithFrame: (CGRect) Frame
Karten-ID: (GMSMapID *) mapID
Kamera: (GMSCameraPosition *) Kamera

Erstellt eine Kartenansicht mit einem Frame, einer Karten-ID und einem Kameraziel und gibt diese zurück.

Hinweis:
Diese Option wurde eingestellt. Verwenden Sie stattdessen -init oder -initWithOptions:.
– (void) startRendering

Weist diese Karte an, ihren Renderer zu aktivieren.

Dies ist optional und idempotent.

Hinweis:
Diese Option wurde eingestellt. Diese Methode ist veraltet und wird in einer zukünftigen Version entfernt.
– (void) stopRendering

Weist diese Karte an, ihren Renderer auszuschalten.

Dies ist optional und idempotent.

Hinweis:
Diese Option wurde eingestellt. Diese Methode ist veraltet und wird in einer zukünftigen Version entfernt.
- (void) clear

Löscht das gesamte Markup, das der Karte hinzugefügt wurde, einschließlich Markierungen, Polylinien und Boden-Overlays.

Dadurch wird der Punkt für den sichtbaren Standort nicht gelöscht und der aktuelle „mapType“ wird nicht zurückgesetzt.

– (void) setMinZoom: (float)  minZoom
maxZoom: (float)  maxZoom

Legt minZoom und maxZoom fest.

Diese Methode erwartet, dass das Minimum kleiner oder gleich dem Maximum ist, und löst ansonsten eine Ausnahme mit dem Namen NSRangeException aus.

- (nullable GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds *) Grenzen
Einsätze: (UIEdgeInsets) Einsätze

Erstellen Sie eine GMSCameraPosition, die bounds mit padding präsentiert.

Ausrichtung und Neigung der Kamera sind null, sie ist also nach Norden ausgerichtet und wird direkt auf die Erde gerichtet. Dabei werden Frame und Abstand von GMSMapView berücksichtigt.

Wenn die Grenzen ungültig sind, gibt diese Methode eine Kamera „nil“ zurück.

- (void) moveCamera: (GMSCameraUpdate *) Aktualisieren

Stellt die Kamera entsprechend der update um.

Der Kamerawechsel erfolgt sofort und ohne Animation.

– (BOOL) areEqualForRenderingPosition: (GMSCameraPosition *) Position
Position: (GMSCameraPosition *) otherPosition

Prüfen Sie, ob die angegebenen Kamerapositionen praktisch dazu führen würden, dass die Kamera gleich gerendert wird. Berücksichtigen Sie dabei die Genauigkeit und die intern verwendeten Transformationen.

Gibt eine Elementebene des angegebenen Typs zurück.

Featureebenen müssen in der Cloud Console konfiguriert werden.

Wenn eine Ebene des angegebenen Typs auf dieser Karte nicht vorhanden ist, keine datengestützten Stile aktiviert sind oder das Metal-Rendering-Framework nicht verwendet wird, lautet der Wert für „isAvailable“ der resultierenden Ebene NO und reagiert nicht auf Aufrufe.

Erfordert den Metal-Renderer. Informationen zum Aktivieren von Metal finden Sie unter https://developers.google.com/maps/documentation/ios-sdk/config#use-metal.

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Animiert die Kamera dieser Karte zu cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D)  den Standort

Als animateToCameraPosition:, ändert jedoch nur den Standort der Kamera, d.h. von der aktuellen Position zu location.

- (void) animateToZoom: (float)  Zoomen

Als animateToCameraPosition:, ändert jedoch nur die Zoomstufe der Kamera.

Dieser Wert wird durch [kGMSMinZoomLevel, kGMSMaxZoomLevel] beschränkt.

- (void) animateToBearing: (CLLocationDirection) Lagerung

Als animateToCameraPosition:, ändert jedoch nur die Peilung der Kamera (in Grad).

Null gibt den geografischen Norden an.

– (void) animateToViewingAngle: (doppelt) viewingAngle

Als animateToCameraPosition:, ändert jedoch nur den Blickwinkel der Kamera (in Grad).

Dieser Wert wird abhängig von der relativen Nähe zur Erde auf einen Mindestwert von null (d.h. senkrecht nach unten) und zwischen 30 und 45 Grad in Richtung Horizont festgelegt.

- (void) animateWithCameraUpdate: (GMSCameraUpdate *) cameraUpdate

Wendet cameraUpdate auf die aktuelle Kamera an und verwendet dann das Ergebnis gemäß „animateToCameraPosition:“.


– (NSString* const) kGMSAccessibilityCompass [related]

Bedienungskennung für die Kompassschaltfläche

– (NSString* const) kGMSAccessibilityMyLocation [related]

Bedienungskennung für die Schaltfläche „Mein Standort“.

– (NSString* const) kGMSAccessibilityOutOfQuota [related]

Bedienungshilfen-ID für das Fehlerlabel „Kontingent überschritten“.


Property-Dokumentation

- (IBOutlet-ID<GMSMapViewDelegate>) delegate [read, write, assign]

GMSMapView-Delegate.

- (GMSCameraPosition*) Kamera [read, write, copy]

Steuert die Kamera und definiert die Ausrichtung der Karte.

Diese Eigenschaft wird sofort geändert.

- (GMSProjection*) Projektion [read, assign]

Gibt ein GMSProjection-Objekt zurück, das Sie zum Umwandeln von Bildschirmkoordinaten in Breiten- und Längengradkoordinaten verwenden können.

Dies ist eine Momentaufnahme der aktuellen Projektion. Sie wird nicht automatisch aktualisiert, wenn die Kamera bewegt wird. Sie stellt entweder die Projektion des zuletzt gezeichneten GMSMapView-Frames dar oder, wo die Kamera explizit festgelegt wurde oder die Karte gerade erstellt wurde, den nachfolgenden Frame. Es wird niemals null sein.

– (BOOL) myLocationEnabled [read, write, assign]

Steuert, ob der Punkt „Mein Standort“ und der Genauigkeitskreis aktiviert sind.

Die Standardeinstellung ist „NO“.

– (CLLocation*) myLocation [read, assign]

Wenn "Mein Standort" aktiviert ist, wird angezeigt, wo der Punkt für den Gerätestandort gezeichnet wird.

Wenn sie deaktiviert oder aktiviert ist, aber keine Standortdaten verfügbar sind, ist der Wert null. Diese Eigenschaft kann mithilfe von KVO beobachtet werden.

- (GMSMarker*) selectedMarker [read, write, assign]

Die ausgewählte Markierung.

Durch Festlegen dieser Eigenschaft wird eine bestimmte Markierung ausgewählt und ein Infofenster angezeigt. Wenn diese Eigenschaft nicht "nil" ist, wird durch das Festlegen von "nil" die Markierung der Markierung aufgehoben, sodass das Infofenster ausgeblendet wird. Diese Eigenschaft kann mithilfe von KVO beobachtet werden.

– (BOOL) trafficEnabled [read, write, assign]

Steuert, ob auf der Karte Verkehrsdaten erfasst werden, falls verfügbar.

Dies ist von der Verfügbarkeit von Verkehrsdaten abhängig. Die Standardeinstellung ist „NO“.

- (GMSMapViewType) mapType [read, write, assign]

Steuert den Typ der Kartenkacheln, die angezeigt werden sollen.

Die Standardeinstellung ist kGMSTypeNormal.

- (GMSMapStyle*) mapStyle [read, write, assign]

Steuert den Stil der Karte.

Ein „mapStyle“, das nicht null ist, wird nur angewendet, wenn „mapType“ auf „Normal“ gesetzt ist.

- (Gleitkommazahl) minZoom [read, assign]

Minimaler Zoom (der weit weiteste Zoomfaktor, mit dem die Kamera herausgezoomt werden darf)

Die Standardeinstellung ist kGMSMinZoomLevel. Geändert mit -setMinZoom:maxZoom:.

- (Gleitkommazahl) maxZoom [read, assign]

Maximaler Zoom (d. h., die Kamera muss der Erde möglichst nahe sein).

Die Standardeinstellung ist kGMSMaxZoomLevel. Geändert mit -setMinZoom:maxZoom:.

– (BOOL) buildingsEnabled [read, write, assign]

Falls festgelegt, werden 3D-Gebäude angezeigt, sofern verfügbar.

Die Standardeinstellung ist YES (JA).

Dies kann beim Hinzufügen einer benutzerdefinierten Kachelebene zur Karte nützlich sein, damit sie bei hohen Zoomstufen deutlicher wird. Eine Änderung dieses Werts führt dazu, dass alle Kacheln kurzzeitig ungültig werden.

– (BOOL) indoorEnabled [read, write, assign]

Legt fest, ob Indoor-Karten angezeigt werden, falls verfügbar.

Die Standardeinstellung ist YES (JA).

Wenn sie auf „Nein“ gesetzt ist, können Caches für Daten zu Innenräumen dauerhaft gelöscht und alle aktuell vom Endnutzer ausgewählten Stockwerke zurückgesetzt werden.

– (GMSIndoorDisplay*) indoorDisplay [read, assign]

Ruft die GMSIndoorDisplay-Instanz ab, mit der Aspekte der Datenanzeige in Innenräumen beobachtet oder gesteuert werden können.

- (GMSUISettings*) Einstellungen [read, assign]

Ruft das GMSUISettings-Objekt ab, das die Einstellungen der Benutzeroberfläche für die Karte steuert.

- (UIEdgeInsets) Padding [read, write, assign]

Steuert den "sichtbaren" Bereich der Ansicht.

Durch das Anwenden von Innenabständen kann ein Bereich am Rand der Ansicht erstellt werden, der Kartendaten, aber keine UI-Steuerelemente enthält.

Ist der Abstand nicht ausgeglichen, wird die visuelle Mitte der Ansicht entsprechend verschoben. Der Innenabstand wirkt sich auch auf die Eigenschaft projection aus, sodass der sichtbare Bereich diesen Bereich nicht enthält. Über GMSCameraUpdate „fitToBounds“ sorgen Sie dafür, dass sowohl dieser Innenabstand als auch jeder angeforderte Abstand berücksichtigt werden.

Diese Eigenschaft kann in einem UIView-basierten Animationsblock animiert werden.

Steuert, wie Werte für den sicheren Bereich zu den Padding-Werten hinzugefügt werden.

Wie Innenabstände werden Kartensteuerelemente wie der Kompass, die Schaltfläche „Mein Standort“ und die Etagenauswahl im sicheren Bereich des Geräts positioniert.

Die Standardeinstellung ist kGMSMapViewPaddingAnpassungBehaviorAlways.

– (BOOL) accessibilityElementsHidden [read, write, assign]

Die Standardeinstellung ist YES (JA).

Wenn auf NO gesetzt, generiert GMSMapView Bedienungshilfen für Overlay-Objekte wie GMSMarker und GMSPolyline.

Diese Eigenschaft folgt dem informellen UIAccessibility-Protokoll mit Ausnahme des Standardwerts YES (JA).

- (GMSMapLayer*) Ebene [read, retain]

Zugriffsfunktion für den benutzerdefinierten CALayer-Typ, der für die Ebene verwendet wird.

- (GMSFrameRate) preferredFrameRate [read, write, assign]

Steuert die Rendering-Framerate.

Der Standardwert ist kGMSFrameRateMaximum.

- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]

Ist der Wert nicht „nil“, wird das Kameraziel so eingeschränkt, dass es durch Gesten nicht die angegebenen Grenzen überschreitet.

– (GMSMapCapabilityFlags) mapCapabilities [read, assign]

Alle bedingt verfügbaren (abhängig von der Karten-ID oder anderen Karteneinstellungen) Funktionen, die zum aktuellen Zeitpunkt verfügbar sind.

Enthält nicht immer verfügbare Funktionen.