Übersicht
Dies ist die Hauptklasse des Google Maps SDK for iOS und der Einstiegspunkt für alle mit der Karte verbundenen Methoden.
Die Karte sollte über den Convenience Konstruktor instanziiert werden [GMSMapView mapWithFrame:camera:]. Sie kann auch mit der Standardmethode [[GMSMapView alloc] initWithFrame:] erstellt werden, wobei die Kamera auf einen Standardstandort eingestellt ist.
GMSMapView kann nur aus dem Hauptthread gelesen und geändert werden, ähnlich wie bei allen UIKit-Objekten. Der Aufruf dieser Methoden aus einem anderen Thread führt zu einer Ausnahme oder zu einem nicht definierten Verhalten.
Funktionen für öffentliche Mitglieder | |
| (Instanztyp) | – initWithFrame:camera: |
| Erstellt und sendet eine Kartenansicht mit einem Frame und einem Kameraziel. | |
| (Instanztyp) | – initWithFrame:mapID:camera: |
| Erstellt und gibt eine Kartenansicht mit einem Frame, einer Karten-ID und einem Kameraziel zurück. | |
| (void) | – startRendering |
| Weist diese Karte an, ihren Renderer mit mehr Power zu versorgen. | |
| (void) | – stopRendering |
| Weist diese Karte an, den Renderer auszuschalten. | |
| (void) | - klar |
| Löscht alle Markierungen, die der Karte hinzugefügt wurden, einschließlich Markierungen, Polylinien und Boden-Overlays | |
| (void) | – setMinZoom:maxZoom: |
Legt minZoom und maxZoom fest. | |
| (nicht zulässig GMSCameraPosition *) | – cameraForBounds:insets: |
Erstellen Sie eine GMSCameraPosition, in der bounds mit padding angezeigt wird. | |
| (void) | – moveCamera: |
Ändert die Kamera gemäß update. | |
| (BOOL) | – areEqualForRenderingPosition:position: |
| Prüfen Sie, ob die angegebenen Kamerapositionen praktisch das gleiche Rendering der Kamera verursachen würden. Berücksichtigen Sie dabei die Genauigkeit und die intern verwendeten Transformationen. | |
| (void) | – animationToCameraPosition: |
Animiert die Kamera dieser Karte zu cameraPosition. | |
| (void) | – animationToLocation: |
Es ist möglich, nur den Wert der Zeichen "animationToCameraPosition:" zu ändern, sondern nur den Standort der Kamera (d.h. vom aktuellen Standort zu location). | |
| (void) | – animationToZoom: |
| Als animiere die Kameraposition, aber ändert nur die Zoomstufe der Kamera. | |
| (void) | – animationToBearing: |
| Wie bei animationToCameraPosition: ändert sich jedoch nur die Lage der Kamera (in Grad). | |
| (void) | – animationToViewingAngle: |
| Wie bei "animierenderKameraposition": ändert sich jedoch nur den Blickwinkel der Kamera (in Grad). | |
| (void) | – animationWithCameraUpdate: |
Wendet cameraUpdate auf die aktuelle Kamera an und verwendet dann das Ergebnis gemäß animationToCameraPosition:. | |
Statische öffentliche Mitgliederfunktionen | |
| (Instanztyp) | + mapWithFrame:camera: |
| Erstellt und sendet eine Kartenansicht mit einem Frame und einem Kameraziel. | |
| (Instanztyp) | + mapWithFrame:mapID:camera: |
| Praktischer Initialisierer zum Erstellen und Zurückgeben einer Kartenansicht mit einem Frame, einer Karten-ID und einem Kameraziel. | |
Eigenschaften | |
| IBOutlet-ID < GMSMapViewDelegate > | delegieren |
| GMSMapView delegieren. | |
| GMSCameraPosition* | kamera |
| Steuert die Kamera, die definiert, wie die Karte ausgerichtet ist. | |
| GMSProjection* | Projektion |
| Gibt ein GMSProjection-Objekt zurück, mit dem Sie Koordinaten aus Bildschirm und Breiten- und Längengrad umrechnen können. | |
| BOOL | myLocationEnabled |
| Steuert, ob der Punkt „Mein Standort“ und der Genauigkeitskreis aktiviert sind. | |
| CLLocation * | mein Standort |
| Wenn „Mein Standort“ aktiviert ist, wird der Standortpunkt des Nutzers angezeigt. | |
| GMSMarker * | selectedMarker |
| Die Markierung, die ausgewählt ist. | |
| 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. | |
| Gleitkommazahl | MinZoom |
| Mindestzoom (am weitesten entfernt). | |
| Gleitkommazahl | maxZoom |
| Maximaler Zoom, d. h. der nächstgelegenen Kamera zur Erde | |
| BOOL | buildingsEnabled (Gebäude aktiviert) |
| Wenn festgelegt, werden 3D-Gebäude angezeigt (sofern verfügbar). | |
| BOOL | indoorEnabled |
| Legt fest, ob Indoor-Karten angezeigt werden, falls verfügbar. | |
| GMSIndoorDisplay* | Display |
| Ruft die GMSIndoorDisplay-Instanz ab, die es ermöglicht, Aspekte der Anzeige von Indoor-Daten zu beobachten oder zu steuern. | |
| GMSUISettings * | Einstellungen |
| Ruft das GMSUISettings-Objekt ab, über das die Einstellungen der Benutzeroberfläche für die Karte gesteuert werden. | |
| UIEdgeInsets | Abstand |
| Steuert den „sichtbaren“ Bereich der Ansicht. | |
| GMSMapViewPaddingAnpassung Verhalten | paddingAnpassungVerhalten |
| Mit dieser Einstellung legen Sie fest, wie Einfügungen in den Bereich zu den Abständen hinzugefügt werden. | |
| BOOL | accessibilityElementsHidden |
| Der Standardwert ist YES. | |
| GMSMapLayer* | Ebene |
| Zugriffsfunktion für den benutzerdefinierten CALayer-Typ, der für die Ebene verwendet wird. | |
| GMSFrameRate | bevorzugteFramerate |
| Steuert die Rendering-Framerate. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| Wenn nicht "nil", wird das Kameraziel eingeschränkt, sodass Gesten das Verlassen der angegebenen Grenzen nicht verhindern können. | |
Ähnliche Funktionen | |
(Hinweis: Dies sind keine Mitgliederfunktionen.) | |
| NSString *const | kGMSAccessibilityCompass |
| Bedienungshilfen-ID für die Kompassschaltfläche. | |
| NSString *const | kGMSAccessibilityMyLocation |
| Bedienungshilfen-ID für die Schaltfläche „Mein Standort“. | |
Dokumentation zu Mitgliederfunktionen
| + (instancetype) mapWithFrame: | (CGRect) | Frame | |
| Kamera: | (GMSCameraPosition *) | kamera | |
Erstellt und sendet eine Kartenansicht mit einem Frame und einem Kameraziel.
| + (instancetype) mapWithFrame: | (CGRect) | Frame | |
| mapID: | (GMSMapID *) | mapID | |
| Kamera: | (GMSCameraPosition*) | kamera | |
Praktischer 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 und sendet eine Kartenansicht mit einem Frame und einem Kameraziel.
| - (instancetype) initWithFrame: | (CGRect) | Frame | |
| mapID: | (GMSMapID *) | mapID | |
| Kamera: | (GMSCameraPosition *) | kamera | |
Erstellt und gibt eine Kartenansicht mit einem Frame, einer Karten-ID und einem Kameraziel zurück.
| – (start) startRendering |
Weist diese Karte an, ihren Renderer mit mehr Power zu versorgen.
Dies ist optional und idempotent.
- Hinweis:
- Dies wurde eingestellt. Diese Methode ist veraltet und wird in einer zukünftigen Version entfernt.
| – (void) stopRendering |
Weist diese Karte an, den Renderer auszuschalten.
Dies ist optional und idempotent.
- Hinweis:
- Dies wurde eingestellt. Diese Methode ist veraltet und wird in einer zukünftigen Version entfernt.
| - (nicht zutreffend) klar |
Löscht alle Markierungen, die der Karte hinzugefügt wurden, einschließlich Markierungen, Polylinien und Boden-Overlays
Der sichtbare Standortpunkt wird nicht gelöscht und der aktuelle mapType wird nicht zurückgesetzt.
| - (void) setMinZoom: | (Gleitkommazahl) | MinZoom | |
| MaxZoom: | (Gleitkommazahl) | maxZoom | |
Legt minZoom und maxZoom fest.
Bei dieser Methode wird davon ausgegangen, dass das Minimum kleiner oder gleich dem Maximum ist. Andernfalls wird eine Ausnahme mit dem Namen NSRangeException ausgelöst.
| - (Für GMSCameraPosition * zulässig) CameraForBounds: | (GMSCoordinateBounds*) | Grenzen | |
| Einfügungen: | (UIEdgeInsets) | Einfügungen | |
Erstellen Sie eine GMSCameraPosition, in der bounds mit padding angezeigt wird.
Die Kamera hat eine Nullrichtung und eine Neigung, d.h. sie ist nach Norden ausgerichtet und hat einen direkten Blick auf die Erde. Dabei werden der Rahmen und das Padding von GMSMapView berücksichtigt.
Wenn die Grenzen ungültig sind, wird mit dieser Methode eine Null-Kamera zurückgegeben.
| – (void) moveCamera: | (GMSCameraUpdate *) | Aktualisieren |
Ändert die Kamera gemäß update.
Die Kamera wird sofort gewechselt (keine Animation).
| – (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition*) | Position | |
| Position: | (GMSCameraPosition *) | otherPosition | |
Prüfen Sie, ob die angegebenen Kamerapositionen praktisch das gleiche Rendering der Kamera verursachen würden. Berücksichtigen Sie dabei die Genauigkeit und die intern verwendeten Transformationen.
| – voidToCameraPosition: | (GMSCameraPosition*) | cameraPosition |
Animiert die Kamera dieser Karte zu cameraPosition.
| – voidToLocation: | (CLLocationCoordinate2D) | den Standort |
Wie bei "animierenderKameraposition": ändert sich nur die Position der Kamera, d.h. vom aktuellen Ort zu location.
| – (void) animationToZoom: | (Gleitkommazahl) | Zoomen |
Als animiere die Kameraposition, aber ändert nur die Zoomstufe der Kamera.
Dieser Wert wird um [kGMSMinZoomLevel, kGMSMaxZoomLevel] gebunden.
| – voidToBearing: | (CLLocationDirection) | Peilung |
Wie bei animationToCameraPosition: ändert sich jedoch nur die Lage der Kamera (in Grad).
Null zeigt den geografischen Norden.
| – (void) animationToViewingAngle: | (doppelt) | Blickwinkel |
Wie bei "animierenderKameraposition": ändert sich jedoch nur den Blickwinkel der Kamera (in Grad).
Dieser Wert wird auf eine Mindestposition von null (also gerade nach unten) und je nach relativer Nähe zur Erde zwischen 30 und 45 Grad in Richtung Horizont gebunden.
| – voidWithCameraUpdate | (GMSCameraUpdate*) | kamera-Update |
Wendet cameraUpdate auf die aktuelle Kamera an und verwendet dann das Ergebnis gemäß animationToCameraPosition:.
Dokumentation zu Friends und verwandten 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“.
Property-Dokumentation
- (IBOutlet-ID <GMSMapViewDelegate>) delegieren [read, write, assign] |
GMSMapView delegieren.
- (GMSCameraPosition*) Kamera [read, write, copy] |
Steuert die Kamera, die definiert, wie die Karte ausgerichtet ist.
Änderungen an dieser Eigenschaft werden sofort wirksam.
- (GMSProjection*) -Projektion [read, assign] |
Gibt ein GMSProjection-Objekt zurück, mit dem Sie Koordinaten aus Bildschirm und Breiten- und Längengrad umrechnen können.
Dies ist ein Snapshot der aktuellen Projektion, der nicht automatisch aktualisiert wird, wenn die Kamera bewegt wird. Sie stellt die Projektion des letzten eingezeichneten GMSMapView-Frames dar; oder, wenn die Kamera explizit festgelegt wurde oder die Karte gerade erstellt wurde, den anstehenden Frame. Es wird nie 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 der Standortpunkt des Nutzers angezeigt.
Wenn es deaktiviert oder aktiviert ist, aber keine Standortdaten verfügbar sind, ist der Wert null. Diese Property kann mithilfe von KVO beobachtet werden.
- (GMSMarker*) selectedMarker [read, write, assign] |
Die Markierung, die ausgewählt ist.
Wenn Sie diese Eigenschaft festlegen, wird eine bestimmte Markierung ausgewählt und ein Infofenster angezeigt. Wenn diese Eigenschaft auf null gesetzt ist, wird durch Festlegen dieser Eigenschaft auf nil die Markierung aufgehoben, wodurch das Infofenster ausgeblendet wird. Diese Property kann mithilfe von KVO beobachtet werden.
- (BOOL) trafficEnabled [read, write, assign] |
Steuert, ob die Karte Verkehrsdaten zeichnet, sofern verfügbar.
Dies hängt von der Verfügbarkeit der 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.
„mapStyle“ ungleich null wird nur angewendet, wenn mapType „Normal“ ist.
– (float) minZoom [read, assign] |
Mindestzoom (am weitesten entfernt).
Die Standardeinstellung ist kGMSMinZoomLevel. Geändert mit -setMinZoom:maxZoom:.
– (float) maxZoom [read, assign] |
Maximaler Zoom, d. h. der nächstgelegenen Kamera zur Erde
Die Standardeinstellung ist kGMSMaxZoomLevel. Geändert mit -setMinZoom:maxZoom:.
- (BOOL) buildingsEnabled [read, write, assign] |
Wenn festgelegt, werden 3D-Gebäude angezeigt (sofern verfügbar).
Der Standardwert ist YES.
Dies kann nützlich sein, wenn Sie der Karte eine benutzerdefinierte Kachelebene hinzufügen, um sie bei hohen Zoomstufen klarer zu machen. Wenn Sie diesen Wert ändern, werden alle Kacheln kurzzeitig ungültig.
– (BOOL) indoorEnabled [read, write, assign] |
Legt fest, ob Indoor-Karten angezeigt werden, falls verfügbar.
Der Standardwert ist YES.
Wenn dies auf „Nein“ gesetzt ist, werden Caches für Indoor-Daten möglicherweise dauerhaft gelöscht und alle vom Endnutzer aktuell festgelegten Etagen werden möglicherweise zurückgesetzt.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
Ruft die GMSIndoorDisplay-Instanz ab, die es ermöglicht, Aspekte der Anzeige von Indoor-Daten zu beobachten oder zu steuern.
- (GMSUISettings*) settings [read, assign] |
Ruft das GMSUISettings-Objekt ab, über das die Einstellungen der Benutzeroberfläche für die Karte gesteuert werden.
- (UIEdgeInsets) Abstand [read, write, assign] |
Steuert den „sichtbaren“ Bereich der Ansicht.
Durch das Auffüllen kann ein Bereich am Rand der Ansicht erstellt werden, der Kartendaten, aber keine Steuerelemente enthält.
Ist der Abstand nicht ausgeglichen, bewegt sich die visuelle Mitte der Ansicht entsprechend. Das Padding wirkt sich auch auf die Eigenschaft projection aus, sodass der sichtbare Bereich keinen Abstand enthält. GMSCameraUpdate fitToBounds sorgt dafür, dass sowohl dieser Abstand als auch alle angefragten Paddings berücksichtigt werden.
Diese Eigenschaft kann in einem UIView-basierten Animationsblock animiert werden.
- (GMSMapViewPaddingAnpassungVerhalten) paddingKorrekturVerhalten [read, write, assign] |
Mit dieser Einstellung legen Sie fest, wie Einfügungen in den Bereich zu den Abständen hinzugefügt werden.
Wie bei Innenablagen werden die Kartenpositionen auch für Steuerelemente wie den Kompass, die Schaltfläche für die Standortermittlung und die Stockwerkauswahl im sicheren Bereich des Geräts verwendet.
Die Standardeinstellung ist kGMSMapViewPaddingAnpassungVerhalten.
– (BOOL) accessibilityElementsHidden [read, write, assign] |
Der Standardwert ist YES.
Wenn NO festgelegt ist, generiert GMSMapView Bedienungshilfen für Overlay-Objekte wie GMSMarker und GMSPolyline.
Diese Eigenschaft entspricht dem informellen UIAccessibility-Protokoll, außer dem Standardwert von 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 Rendering-Framerate.
Der Standardwert ist kGMSFrameRateMaximum.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]
|
Wenn nicht "nil", wird das Kameraziel eingeschränkt, sodass Gesten das Verlassen der angegebenen Grenzen nicht verhindern können.