Karte konfigurieren

Plattform auswählen: Android iOS

In dieser Übersicht wird beschrieben, wie Sie mit dem Maps SDK for iOS eine Karte konfigurieren, die einer iOS-App hinzugefügt wurde.

Übersicht

Nachdem Sie der App eine Karte hinzugefügt haben, können Sie die Anfangsoptionen und die Laufzeiteinstellungen konfigurieren. Weitere Informationen finden Sie unter Karte hinzufügen.

Zu den Anfangseinstellungen einer Karte gehören:

• Kameraposition einschließlich Standort, Zoomfaktor, Ausrichtung und Neigung; Weitere Informationen zur Positionierung der Kamera finden Sie unter Kamera und Ansicht.
• Die Hintergrundfarbe der Karte.
• Kartentyp
• Die anzuzeigenden UI-Elemente wie die Zoomschaltflächen und der Kompass
• Zu aktivierende Touch-Gesten

Diese und weitere Einstellungen können Sie während der Laufzeit konfigurieren. Hierzu muss das GMSMapView-Objekt aktualisiert werden.

Kartenoptionen

Beim Initialisieren der Kartenansicht werden die Konfigurationsoptionen mit GMSMapViewOptions festgelegt. Zu den Optionen gehören frame, camera, mapID oder backgroundColor.

Kartenoptionen
Frame	Wert: CGRect Den Kartenrahmen Die Standardeinstellung ist CGRectZero.
Kamera	Wert: GMSCameraPosition Die Standardposition der Kamera auf der Karte.
mapID	Wert: GMSMapID Google-Karten-ID. Optionaler Parameter.
backgroundColor	Wert: UIColor Standardmäßig ist UIColor.lightGray festgelegt.

Kartenoptionen konfigurieren

Sie können entweder eigene Optionen festlegen oder eine instanziierte GMSMapViewOptions mit Standardwerten direkt an GMSMapView übergeben.

Swift

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

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Hier ein Beispiel für die direkte Weitergabe eines GMSMapViewOptions-Objekts mit Standardwerten an GMSMapView.

Swift

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

Hintergrundfarbe konfigurieren

Wenn Sie im Dunkelmodus arbeiten oder zwischen Kartenansichten wechseln, kann es hilfreich sein, die Standardfarbe des Kartenhintergrunds zu überschreiben. Dazu können Sie die Eigenschaft „backgroundColor“ für die Kartenoptionen festlegen.

Swift

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Hinweis: Sie können auch das cloudbasierte Gestalten von Karteninhalten verwenden, um die Hintergrundfarbe zu konfigurieren. Die im Karten-Styling festgelegte Hintergrundfarbe hat eine höhere Priorität als die lokale Hintergrundfarbe. Weitere Informationen finden Sie unter App-Hintergrundfarbe für cloudbasiertes Karten-Styling ändern.

Kartentypen

Sie können die Karten mit einem von verschiedenen Kartentypen benutzerdefiniert gestalten. Der Typ einer Karte ist entscheidend für ihre Gesamtdarstellung. Beispielsweise enthält ein Atlas meist politische Karten, mit denen in erster Linie Grenzen dargestellt werden, während auf Straßenkarten vor allem die Straßen einer Stadt oder Region zu sehen sind. Das Maps SDK for iOS bietet die folgenden Kartentypen:

Kartentyp
Normal	Wert: kGMSTypeNormal Typische Straßenkarte. Straßen, einige von Menschen geschaffene Merkmale und wichtige Landschaftsmerkmale wie Flüsse werden angezeigt. Die dazugehörigen Labels sind auch sichtbar. Es ist möglich, das Farbschema der Karte auf „Dunkel“, „Hell“ oder „Systemeinstellungen“ festzulegen.
Hybrid	Wert: kGMSTypeHybrid Enthält Satellitenfotodaten mit zusätzlichen Straßenkarten. Die dazugehörigen Labels sind ebenfalls sichtbar.
Satellit	Wert: kGMSTypeSatellite Enthält Satellitenfotodaten. Straßen und sonstige Merkmale sind nicht beschriftet.
Gelände	Wert: kGMSTypeTerrain Enthält topografische Daten. Die Karte umfasst Farben, Höhenlinien und Labels sowie perspektivische Schattierungen. Außerdem werden einige Straßen und Labels dargestellt. Es ist möglich, das Farbschema der Karte auf „Dunkel“, „Hell“ oder „Systemeinstellungen“ festzulegen.
Keine	Wert: kGMSTypeNone Enthält keine Kartenkacheln. Die Kacheln mit Grundkarten werden nicht wiedergegeben. Dieser Modus ist in Verbindung mit Kachelebenen nützlich. Die Anzeige von Verkehrsdaten ist deaktiviert, wenn der Kartentyp auf „Kein“ festgelegt ist.

Kartentyp ändern

Wenn Sie den Typ einer Karte festlegen möchten, weisen Sie der Eigenschaft GMSMapView.mapType einen neuen Wert zu. Beispiel: Anzeigen des Kartentyps „Satellit“:

Swift

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

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

Die folgende Auswahl zeigt einen Vergleich von Gelände-, Normal- und Hybridkarten für denselben Ort:

Indoor-Karten

Bei einem hohen Zoomfaktor sind im Maps SDK for iOS Gebäudepläne für Innenbereiche wie z. B. Flughäfen, Einkaufszentren, große Geschäfte und Bahnhöfe zu sehen. Gebäudepläne sind in die Standardkartenkacheln für den Kartentyp „Normal“ (kGMSTypeNormal) integriert. Sie werden automatisch aktiviert, wenn der Nutzer heranzoomt, und ausgeblendet, wenn die Karte herausgezoomt wird.

Sie können Indoor-Karten deaktivieren, indem Sie die indoorEnabled-Eigenschaft von GMSMapView auf NO setzen.

Swift

mapView.isIndoorEnabled = false
      

Objective-C

mapView.indoorEnabled = NO;
      

Alternativ können Sie nur das Steuerelement Etagenauswahl deaktivieren.

Gebäudepläne hinzufügen

Gebäudepläne sind an ausgewählten Standorten verfügbar. Wenn für ein Gebäude, das du in deiner App hervorheben möchtest, keine Gebäudeplandaten verfügbar sind, hast du folgende Möglichkeiten:

• Du kannst Gebäudepläne direkt zu Google Maps hinzufügen. So sind Ihre Pläne für alle Nutzer von Google Maps verfügbar.
• Sie können einen Gebäudeplan als Boden-Overlay anzeigen lassen. Dann können nur Nutzer deiner App deine Gebäudepläne sehen.

Verkehrsebene

Du kannst den Nutzern die Möglichkeit geben, eine Karte mit darüber gelagerten Informationen zur Verkehrsdichte zu sehen. Das ist eine visuelle Zusammenfassung der lokalen Verkehrssituation. Du kannst die Verkehrsebene aktivieren und deaktivieren, indem du die Methode trafficEnabled aufrufst. Das folgende Beispiel zeigt, wie die Verkehrsebene auf einer Karte aussehen könnte.

Bedienungshilfen

Standardmäßig sind die Elemente zur erleichteren Bedienung der Karte verborgen. Sie können die Barrierefreiheit aktivieren, indem Sie die accessibilityElementsHidden-Eigenschaft von GMSMapView auf NO festlegen. Dadurch werden Elemente für Barrierefreiheit für Overlay-Objekte generiert, z. B. GMSMarker und Infofenster GMSPolyline.

Swift

mapView.accessibilityElementsHidden = false
      

Objective-C

mapView.accessibilityElementsHidden = NO;
      

Diese Eigenschaft entspricht dem informellen UIAccessibility-Protokoll, mit der Ausnahme, dass der Standardwert im Maps SDK for iOS YES ist.

Mein Standort

Standardmäßig werden auf der Karte keine Standortdaten angezeigt. Sie können den blauen Punkt „Mein Standort“ und die Kompassrichtung aktivieren, indem Sie myLocationEnabled auf GMSMapView stellen.

Swift

mapView.isMyLocationEnabled = true
      

Objective-C

mapView.myLocationEnabled = YES;
      

Wenn Sie diese Funktion aktivieren, wird der aktuelle Standort des Nutzers über die Eigenschaft myLocation bereitgestellt. Diese Property ist möglicherweise nicht sofort verfügbar, z. B. wenn der Nutzer von iOS aufgefordert wird, den Zugriff auf diese Daten zuzulassen. In diesem Fall ist das nil.

Swift

print("User's location: \(String(describing: mapView.myLocation))")
      

Objective-C

NSLog(@"User's location: %@", mapView.myLocation);
      

3D-Gebäude

In vielen Städten sind in der Nahansicht 3D-Gebäude zu sehen, wie zum Beispiel unten im Bild von Seattle, Washington.

Sie können die 3D-Gebäude deaktivieren, indem Sie die entsprechende GMSMapView-Eigenschaft in Swift oder Objective-C festlegen, wie unten dargestellt:

Swift

mapView.isBuildingsEnabled = false
      

Objective-C

[mapView setBuildingsEnabled:NO];
      

Karte mit Innenrand versehen

Eine Google-Karte füllt standardmäßig den gesamten Bereich aus, der von der GMSMapView definiert wird. Verschiedene Aspekte der Darstellung und Funktionsweise der Karte werden durch die Abmessungen der Ansicht definiert:

• Das Ziel der Kamera entspricht der Mitte des abgesetzten Bereichs.
• Kartensteuerelemente werden relativ zu den Rändern der Karte positioniert.
• Rechtliche Informationen wie Urheberrechtsangaben oder das Google-Logo werden am unteren Rand der Karte angezeigt.

Mithilfe von GMSMapView können Sie an der Kartenaußenseite einen Innenrand hinzufügen.padding-Attribut. Die Karte füllt weiterhin den gesamten Container aus, aber die Positionierung von Text und Steuerelementen, Touch-Gesten für die Kartensteuerung und Kamerabewegung verhalten sich so, als wenn die Karte in einem kleineren Bereich platziert worden wäre. Das führt zu folgenden Änderungen:

• Kamerabewegungen über API-Aufrufe oder die Betätigung von Schaltflächen (z.B. der Kompassschaltfläche oder der Schaltfläche „Mein Standort“) erfolgen relativ zum abgesetzten Bereich.
• GMSMapView.projection gibt eine Projektion zurück, die nur den abgesetzten Bereich enthält.
• UI-Steuerelemente werden um die angegebene Anzahl von Punkten vom Rand des Containers verschoben.

Padding kann beim Entwerfen von Benutzeroberflächen hilfreich sein, die sich mit einem Teil der Karte überschneiden. Auf dem Bild wurden zum Beispiel Innenränder entlang des oberen und rechten Rands der Karte festgelegt. Sichtbare Kartensteuerelemente und rechtliche Informationen werden entlang der Ränder des abgesetzten Bereichs (grün) angezeigt. Die Karte füllt aber weiterhin den gesamten Container (blau) aus. In diesem Beispiel kann rechts auf der Karte ein Menü eingeblendet werden, ohne die Kartensteuerelemente zu verdecken.

Wenn Sie Ihrer Karte einen Abstand hinzufügen möchten, erstellen Sie ein UIEdgeInsets-Objekt und übergeben Sie es an die GMSMapView.padding-Attribut.

Swift

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

Objective-C

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;
      

Hinweis: Gemäß den Nutzungsbedingungen für die Google Maps Platform dürfen das Google-Logo und die Urheberrechtshinweise in Ihrer App weder entfernt noch verdeckt werden. Mithilfe eines Innenrands auf der Karte können Sie diese Elemente bei Bedarf neu positionieren. Wenn Sie unten auf der Karte eine benutzerdefinierte Benutzeroberfläche anzeigen lassen, legen Sie einen Innenrand vom unteren Kartenrand fest, damit das Logo und die rechtlichen Hinweise sichtbar sind.

Kartenfarbschema

Bei Karten vom Typ „Normal“ und „Terrain“ können Sie das Kartenfarbschema auf „Dunkel“, „Hell“ oder „Aktuelle Systemeinstellungen“ festlegen. So können Sie beispielsweise das Farbschema der Karte je nach Tageszeit oder Verwendung des Geräts im Innen- oder Außenbereich verdunkeln oder aufhellen.

Verwenden Sie GMSMapView overrideUserInterfaceStyle:, um das Kartenfarbschema festzulegen und zu aktualisieren.

Swift

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;