Ü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. | |
GMSCameraPosition * | Kamera |
Steuert die Kamera und definiert die Ausrichtung der Karte. | |
GMSProjection * | Projektion |
Gibt ein GMSProjection-Objekt zurück, das Sie zum Umwandeln von Bildschirmkoordinaten in Breiten- und Längengradkoordinaten verwenden können. | |
BOOL | myLocationEnabled |
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. | |
GMSMarker * | selectedMarker |
Die ausgewählte Markierung. | |
BOOL | trafficEnabled |
Steuert, ob auf der Karte Verkehrsdaten erfasst werden, falls verfügbar. | |
GMSMapViewType | mapType |
Steuert den Typ der Kartenkacheln, die angezeigt werden sollen. | |
GMSMapStyle * | mapStyle |
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). | |
BOOL | buildingsEnabled |
Falls festgelegt, werden 3D-Gebäude angezeigt, sofern verfügbar. | |
BOOL | indoorEnabled |
Legt fest, ob Indoor-Karten angezeigt werden, falls verfügbar. | |
GMSIndoorDisplay * | indoorDisplay |
Ruft die GMSIndoorDisplay-Instanz ab, mit der Aspekte der Datenanzeige in Innenräumen beobachtet oder gesteuert werden können. | |
GMSUISettings * | Einstellungen |
Ruft das GMSUISettings-Objekt ab, das die Einstellungen der Benutzeroberfläche für die Karte steuert. | |
UIEdgeInsets | Abstand |
Steuert den "sichtbaren" Bereich der Ansicht. | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
Steuert, wie Werte für den sicheren Bereich zu den Padding-Werten hinzugefügt werden. | |
BOOL | accessibilityElementsHidden |
Die Standardeinstellung ist YES (JA). | |
GMSMapLayer * | Ebene |
Zugriffsfunktion für den benutzerdefinierten CALayer-Typ, der für die Ebene verwendet wird. | |
GMSFrameRate | preferredFrameRate |
Steuert die Rendering-Framerate. | |
GMSCoordinateBounds * | cameraTargetBounds |
Ist der Wert nicht „nil“, wird das Kameraziel so eingeschränkt, dass es durch Gesten nicht die angegebenen Grenzen überschreitet. | |
GMSMapCapabilityFlags | mapCapabilities |
Alle bedingt verfügbaren (abhängig von der Karten-ID oder anderen Karteneinstellungen) Funktionen, die zum aktuellen Zeitpunkt verfügbar sind. | |
Weitere Funktionen | |
(Beachten Sie, dass dies keine Mitgliederfunktionen sind.) | |
NSString *const | kGMSAccessibilityCompass |
Bedienungskennung für die Kompassschaltfläche | |
NSString *const | kGMSAccessibilityMyLocation |
Bedienungskennung für die Schaltfläche „Mein Standort“. | |
NSString *const | kGMSAccessibilityOutOfQuota |
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.
– (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
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:“.
Dokumentation zu Friends & Related-Funktionen
– (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.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
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.