Überblick
Dies ist die Hauptklasse des Google Maps SDK for iOS und der Einstiegspunkt für alle Methoden in Bezug auf die Karte.
Die Karte sollte mit einem 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.
Funktionen für öffentliche Mitglieder | |
| (Instanztyp) | – init |
| Initialisiert mit CGRectZero und Standardoptionen. | |
| (Instanztyp) | – initWithOptions: |
| Erstellt eine neue Kartenansicht mit den angegebenen Optionen. | |
| (Instanztyp) | – initWithFrame: |
| (Instanztyp mit Nullwert zulässig) | – initWithCoder: |
| (Instanztyp) | – initWithFrame:camera: |
| Erstellt eine Kartenansicht mit einem Frame und einem Kameraziel und gibt diese 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 zu deaktivieren. | |
| (void) | - löschen |
| Löscht sämtliches 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, bei der bounds mit padding dargestellt wird. | |
| (void) | – moveCamera: |
Ändert die Kamera gemäß update. | |
| (BOOL) | – areEqualForRenderingPosition:position: |
| Überprüfen Sie, ob die gegebenen Kamerapositionen praktisch dazu führen würden, dass die Kamera gleich gerendert wird. Berücksichtigen Sie dabei die intern verwendete Genauigkeit und Transformationen. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
| Gibt eine Element-Ebene des angegebenen Typs zurück. | |
| (GMSDatasetFeatureLayer *) | – datasetFeatureLayerOfDatasetID: |
| Gibt eine Dataset-Featureebene des angegebenen Datensatzes zurück. | |
| (void) | – animateToCameraPosition: |
Animiert die Kamera dieser Karte auf cameraPosition. | |
| (void) | – animateToLocation: |
Als animateToCameraPosition:, ändert aber nur den Standort der Kamera (d.h. vom aktuellen Standort zu location). | |
| (void) | – animateToZoom: |
| Als animateToCameraPosition:, ändert jedoch nur die Zoomstufe der Kamera. | |
| (void) | – animateToBearing: |
| Wie animateToCameraPosition:, ändert aber nur die Ausrichtung der Kamera (in Grad). | |
| (void) | – animateToViewingAngle: |
| Wie animateToCameraPosition:, ändert aber nur den Blickwinkel der Kamera (in Grad). | |
| (void) | – animateWithCameraUpdate: |
Wendet cameraUpdate auf die aktuelle Kamera an und verwendet dann das Ergebnis gemäß animateToCameraPosition:. | |
Statische öffentliche Mitgliederfunktionen | |
| (Instanztyp) | + mapWithFrame:camera: |
| Erstellt eine Kartenansicht mit einem Frame und einem Kameraziel und gibt sie zurück. | |
| (Instanztyp) | + mapWithFrame:mapID:camera: |
| Praktisches Initialisierer zum Erstellen und Zurückgeben einer Kartenansicht mit einem Frame, einer Karten-ID und einem Kameraziel. | |
Eigenschaften | |
| IBOutlet-ID< GMSMapViewDelegate > | bevollmächtigen |
| GMSMapView-Delegaten. | |
| GMSCameraPosition * | Kamera |
| Steuert die Kamera, die definiert, wie die Karte ausgerichtet wird. | |
| GMSProjection * | Projektion |
| Gibt ein GMSProjection-Objekt zurück, mit dem Sie Bildschirmkoordinaten in Breiten- und Längengrad umwandeln können. | |
| BOOL | myLocationEnabled |
| Steuert, ob der Punkt und die Genauigkeitskreis „Mein Standort“ aktiviert sind. | |
| CLLocation * | myLocation |
| Wenn die Funktion "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 die Karte Verkehrsdaten zeichnet, sofern verfügbar. | |
| GMSMapViewType | mapType |
| Steuert den Typ der anzuzeigenden Kartenkacheln. | |
| GMSMapStyle * | mapStyle |
| Steuert den Stil der Karte. | |
| UIUserInterfaceStyle | overrideUserInterfaceStyle |
| Ändern Sie die Karte in den gewünschten UIUserInterfaceStyle. | |
| float | minZoom |
| Minimaler Zoom: Die Kamera ist am weitesten herausgezoomt. | |
| float | maxZoom |
| Maximaler Zoom: die Kamera, die der Erde am nächsten ist. | |
| BOOL | buildingsEnabled |
| Sofern festgelegt, werden 3D-Gebäude angezeigt, sofern verfügbar. | |
| BOOL | indoorEnabled |
| Legt fest, ob Indoor-Karten angezeigt werden, sofern verfügbar. | |
| GMSIndoorDisplay * | indoorDisplay |
| Ruft die GMSIndoorDisplay-Instanz ab, die es ermöglicht, bestimmte Aspekte der Datenanzeige für den Innenbereich zu beobachten oder zu steuern. | |
| GMSUISettings * | Einstellungen |
| Ruft das GMSUISettings-Objekt ab, das Einstellungen für die Benutzeroberfläche für die Karte steuert. | |
| UIEdgeInsets | Abstand |
| Steuert den sichtbaren Bereich der Ansicht. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Steuert, wie Einfügungen des sicheren Bereichs zu den Padding-Werten hinzugefügt werden. | |
| BOOL | accessibilityElementsHidden |
| Die Standardeinstellung ist YES. | |
| GMSMapLayer * | Ebene |
| Zugriffsfunktion für den benutzerdefinierten CALayer-Typ, der für die Ebene verwendet wird | |
| GMSFrameRate | preferredFrameRate |
| Steuert die Framerate für das Rendering. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| Wenn nicht null, wird das Kameraziel eingeschränkt, sodass es nicht durch Touch-Gesten ausgelöst werden kann, die festgelegten Begrenzungen zu überschreiten. | |
| GMSMapCapabilityFlags | mapCapabilities |
| Alle Funktionen, die bedingt verfügbar sind (abhängig von „mapID“ oder anderen Karteneinstellungen), die zum aktuellen Zeitpunkt verfügbar sind. | |
Zugehörige Funktionen | |
(Beachten Sie, dass dies keine Mitgliederfunktionen sind.) | |
| NSString *const | kGMSAccessibilityCompass |
| Bedienungshilfen-ID für die Kompassschaltfläche. | |
| NSString *const | kGMSAccessibilityMyLocation |
| Bedienungshilfen-ID für die Schaltfläche „Mein Standort“. | |
| NSString *const | kGMSAccessibilityOutOfQuota |
| Bedienungshilfen-ID für das Fehlerlabel „Kontingent überschritten“. | |
Dokumentation zu Mitgliederfunktionen
| – (instancetype) init |
Initialisiert mit CGRectZero und Standardoptionen.
| – (Instanztyp) initWithOptions: | (GMSMapViewOptions ungleich null *) | options |
Erstellt eine neue Kartenansicht mit den angegebenen Optionen.
Der Wert des Optionsobjekts wird mit dieser Methode kopiert.
| – (instancetype) initWithFrame: | (CGRect) | Frame |
| – (Instanztyp mit Nullwert) 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 | |
| mapID: | (GMSMapID *) | mapID | |
| Kamera: | (GMSCameraPosition *) | kamera | |
Praktisches Initialisierer zum Erstellen und Zurückgeben einer Kartenansicht mit einem Frame, einer Karten-ID und einem Kameraziel.
| – (instancetype) initWithFrame: | (CGRect) | Frame | |
| Kamera: | (GMSCameraPosition *) | kamera | |
Erstellt eine Kartenansicht mit einem Frame und einem Kameraziel und gibt diese zurück.
- Hinweis:
- Diese Funktion wurde eingestellt. Verwenden Sie stattdessen „-init“ oder „-initWithOptions:“.
| – (instancetype) initWithFrame: | (CGRect) | Frame | |
| mapID: | (GMSMapID *) | mapID | |
| Kamera: | (GMSCameraPosition *) | kamera | |
Erstellt eine Kartenansicht mit einem Frame, einer Karten-ID und einem Kameraziel und gibt diese zurück.
- Hinweis:
- Diese Funktion 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 Funktion wurde eingestellt. Diese Methode ist veraltet und wird in einer zukünftigen Version entfernt.
| – (void) stopRendering |
Weist diese Karte an, ihren Renderer zu deaktivieren.
Dies ist optional und idempotent.
- Hinweis:
- Diese Funktion wurde eingestellt. Diese Methode ist veraltet und wird in einer zukünftigen Version entfernt.
| - (void) löschen |
Löscht sämtliches Markup, das der Karte hinzugefügt wurde, einschließlich Markierungen, Polylinien und Boden-Overlays.
Dadurch wird weder der sichtbare Standortpunkt gelöscht noch der aktuelle „mapType“ 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 *) | bounds | |
| Einsätze: | (UIEdgeInsets) | Einsätze | |
Erstellen Sie eine GMSCameraPosition, bei der bounds mit padding dargestellt wird.
Die Kamera weist keine Ausrichtung und Neigung auf, d.h. sie ist nach Norden ausgerichtet und direkt auf die Erde gerichtet. Dabei werden Frame und Padding dieses GMSMapView-Elements berücksichtigt.
Wenn die Grenzen ungültig sind, gibt diese Methode eine Nullkamera zurück.
| – (void) moveCamera: | (GMSCameraUpdate *) | Update |
Ändert die Kamera gemäß update.
Der Kamerawechsel erfolgt unmittelbar und ohne Animation.
| - (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | Position | |
| Position: | (GMSCameraPosition *) | otherPosition | |
Überprüfen Sie, ob die gegebenen Kamerapositionen praktisch dazu führen würden, dass die Kamera gleich gerendert wird. Berücksichtigen Sie dabei die intern verwendete Genauigkeit und Transformationen.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
Gibt eine Element-Ebene 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, datengestützte Stile nicht aktiviert sind oder das Metal-Rendering-Framework nicht verwendet wird, ist 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.
| – (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
Gibt eine Dataset-Featureebene des angegebenen Datensatzes zurück.
Dataset-IDs müssen in der Cloud Console konfiguriert werden.
Wenn auf dieser Karte kein Datensatz mit der angegebenen ID vorhanden ist oder datengestützte Stile nicht aktiviert sind, ist der isAvailable der resultierenden Ebene NO und reagiert nicht auf Aufrufe.
| – (void) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
Animiert die Kamera dieser Karte auf cameraPosition.
| – (void) animateToLocation: | (CLLocationCoordinate2D) | den Standort |
Als animateToCameraPosition:, ändert aber nur den Standort der Kamera (d.h. vom aktuellen Standort zu location).
| – (void) animateToZoom: | (float) | Zoom |
Als animateToCameraPosition:, ändert jedoch nur die Zoomstufe der Kamera.
Dieser Wert wird durch [kGMSMinZoomLevel, kGMSMaxZoomLevel] eingeschränkt.
| – (void) animateToBearing: | (CLLocationDirection) | Lage |
Wie animateToCameraPosition:, ändert aber nur die Ausrichtung der Kamera (in Grad).
Null gibt den geografischen Norden an.
| – (void) animateToViewingAngle: | (doppelt) | viewingAngle |
Wie animateToCameraPosition:, ändert aber nur den Blickwinkel der Kamera (in Grad).
Dieser Wert wird auf einen Mindestwert von null (d.h. mit Blick auf den Horizont) und zwischen 30 und 45 Grad in Richtung des Horizonts festgelegt, je nach der relativen Nähe zur Erde.
| – (void) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
Wendet cameraUpdate auf die aktuelle Kamera an und verwendet dann das Ergebnis gemäß animateToCameraPosition:.
Dokumentation für Freunde und verwandte Funktionen
– (NSString* const) kGMSAccessibilityCompass [related] |
Bedienungshilfen-ID für die Kompassschaltfläche.
– (NSString* const) kGMSAccessibilityMyLocation [related] |
Bedienungshilfen-ID 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-Delegaten.
- (GMSCameraPosition*) Kamera [read, write, copy] |
Steuert die Kamera, die definiert, wie die Karte ausgerichtet wird.
Änderungen an dieser Eigenschaft erfolgen sofort.
– (GMSProjection*) Prognose [read, assign] |
Gibt ein GMSProjection-Objekt zurück, mit dem Sie Bildschirmkoordinaten in Breiten- und Längengrad umwandeln können.
Dies ist eine Momentaufnahme der aktuellen Projektion. Sie wird nicht automatisch aktualisiert, wenn sich die Kamera bewegt. Sie repräsentiert entweder die Projektion des zuletzt gezeichneten GMSMapView-Frames oder den nächsten Frame, wo die Kamera explizit festgelegt oder die Karte gerade erstellt wurde. Es wird niemals Null sein.
– (BOOL) myLocationEnabled [read, write, assign] |
Steuert, ob der Punkt und die Genauigkeitskreis „Mein Standort“ aktiviert sind.
Die Standardeinstellung ist NO.
– (CLLocation*) myLocation [read, assign] |
Wenn die Funktion "Mein Standort" aktiviert ist, wird angezeigt, wo der Punkt für den Gerätestandort gezeichnet wird.
Wenn sie deaktiviert ist oder aktiviert ist, aber keine Standortdaten verfügbar sind, ist der Wert null. Diese Eigenschaft kann mit 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 darauf angezeigt. Wenn diese Eigenschaft einen anderen Wert als null hat und sie auf null gesetzt ist, wird die Auswahl der Markierung aufgehoben und das Infofenster ausgeblendet. Diese Eigenschaft kann mit KVO beobachtet werden.
– (BOOL) trafficEnabled [read, write, assign] |
Steuert, ob die Karte Verkehrsdaten zeichnet, sofern verfügbar.
Dies hängt von der Verfügbarkeit von Verkehrsdaten ab. Die Standardeinstellung ist NO.
– (GMSMapViewType) mapType [read, write, assign] |
Steuert den Typ der anzuzeigenden Kartenkacheln.
Die Standardeinstellung ist kGMSTypeNormal.
– (GMSMapStyle*) mapStyle [read, write, assign] |
Steuert den Stil der Karte.
Ein "mapStyle"-Element ungleich null wird nur angewendet, wenn "mapType" den Wert "Normal" hat.
– (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
Ändern Sie die Karte in den gewünschten UIUserInterfaceStyle.
Dadurch wird das UIKit-Standardverhalten überschrieben und standardmäßig UIUserInterfaceStyleLight verwendet, um Abwärtskompatibilität zu gewährleisten. Dies wirkt sich auf das Farbschema der Kartentypen "Normal" und "Gelände" aus.
– (Gleitkommazahl) minZoom [read, assign] |
Minimaler Zoom: Die Kamera ist am weitesten herausgezoomt.
Die Standardeinstellung ist kGMSMinZoomLevel. Geändert mit -setMinZoom:maxZoom:.
– (float) maxZoom [read, assign] |
Maximaler Zoom: die Kamera, die der Erde am nächsten ist.
Die Standardeinstellung ist kGMSMaxZoomLevel. Geändert mit -setMinZoom:maxZoom:.
– (BOOL) buildingsEnabled [read, write, assign] |
Sofern festgelegt, werden 3D-Gebäude angezeigt, sofern verfügbar.
Die Standardeinstellung ist YES.
Dies kann hilfreich sein, wenn eine benutzerdefinierte Kachelebene zur Karte hinzugefügt wird, um sie bei hohen Zoomstufen deutlicher zu machen. Wenn Sie diesen Wert ändern, werden alle Tiles kurzzeitig ungültig.
– (BOOL) indoorEnabled [read, write, assign] |
Legt fest, ob Indoor-Karten angezeigt werden, sofern verfügbar.
Die Standardeinstellung ist YES.
Wenn diese Option auf „Nein“ gesetzt ist, können Caches für Indoor-Daten dauerhaft geleert und alle derzeit vom Endnutzer ausgewählten Stockwerke zurückgesetzt werden.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
Ruft die GMSIndoorDisplay-Instanz ab, die es ermöglicht, bestimmte Aspekte der Datenanzeige für den Innenbereich zu beobachten oder zu steuern.
- (GMSUISettings*) Einstellungen [read, assign] |
Ruft das GMSUISettings-Objekt ab, das Einstellungen für die Benutzeroberfläche für die Karte steuert.
– (UIEdgeInsets) Padding [read, write, assign] |
Steuert den sichtbaren Bereich der Ansicht.
Durch das Padding kann am Rand der Ansicht ein Bereich erstellt werden, der Kartendaten, aber keine Benutzeroberflächen-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. Der sichtbare Bereich umfasst also nicht den Innenrandbereich. Mit fitToBounds durch GMSCameraUpdate wird sichergestellt, dass sowohl dieser Abstand als auch alle angeforderten Werte berücksichtigt werden.
Diese Eigenschaft kann innerhalb eines UIView-basierten Animationsblocks animiert werden.
– (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
Steuert, wie Einfügungen des sicheren Bereichs zu den Padding-Werten hinzugefügt werden.
Dazu gehören z. B. der Innenrand, Steuerelemente für den sicheren Bereich zur Positionierung von Karten wie der Kompass, die Schaltfläche „Mein Standort“ und die Etagenauswahl im sicheren Bereich des Geräts.
Die Standardeinstellung ist „kGMSMapViewPaddingAnpassungBehaviorAlways“.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
Die Standardeinstellung ist YES.
Wird sie auf NO gesetzt, generiert GMSMapView Bedienungshilfen für Overlay-Objekte wie GMSMarker und GMSPolyline.
Diese Eigenschaft entspricht dem informellen UIAccessibility-Protokoll, mit Ausnahme des Standardwerts YES.
- (GMSMapLayer*) layer [read, retain] |
Zugriffsfunktion für den benutzerdefinierten CALayer-Typ, der für die Ebene verwendet wird
– (GMSFrameRate) preferredFrameRate [read, write, assign] |
Steuert die Framerate für das Rendering.
Der Standardwert ist kGMSFrameRateMaximum.
– (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Wenn nicht null, wird das Kameraziel eingeschränkt, sodass es nicht durch Touch-Gesten ausgelöst werden kann, die festgelegten Begrenzungen zu überschreiten.
– (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Alle Funktionen, die bedingt verfügbar sind (abhängig von „mapID“ oder anderen Karteneinstellungen), die zum aktuellen Zeitpunkt verfügbar sind.
Umfasst nicht ständig verfügbare Funktionen.