Karte hinzufügen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Plattform auswählen: Android iOS JavaScript

Karten werden in der API durch die Klasse GMSMapView repräsentiert, eine Unterklasse von UIView. Die Karte ist das wichtigste Objekt im Maps SDK for iOS. Sie bietet die erforderlichen Methoden zum Hinzufügen, Entfernen und Verwalten anderer Objekte wie Markierungen und Polylinien.

Einführung

Mit dem Maps SDK for iOS kannst du eine Google-Karte in deiner iOS-App anzeigen lassen. Diese Karten sehen genauso aus wie in der Google Maps App für iOS. Viele der Funktionen sind auch im SDK verfügbar.

Zusätzlich zur Zuordnungsfunktion unterstützt die API auch eine Reihe von Interaktionen, die mit dem iOS-UI-Modell übereinstimmen. Zum Beispiel können Sie Interaktionen mit einer Karte einrichten, indem Sie Antwortende definieren, die auf Nutzergesten wie Antippen und Doppeltippen reagieren.

Die wichtigste Klasse bei der Arbeit mit einem Kartenobjekt ist die Klasse GMSMapView. GMSMapView führt die folgenden Vorgänge automatisch aus:

  • Verbindung zum Google Maps-Dienst herstellen
  • Kartenkacheln herunterladen
  • Kacheln auf dem Gerätebildschirm anzeigen
  • Verschiedene Steuerelemente z. B. zum Schwenken und Zoomen anzeigen
  • Auf Bewegungen zum Schwenken und Zoomen reagieren, indem die Karte verschoben oder vergrößert bzw. verkleinert wird
  • Auf Bewegungen mit zwei Fingern reagieren, indem der Blickwinkel der Karte geneigt wird

Zusätzlich zu diesen automatischen Vorgängen kannst du das Verhalten und die Darstellung der Karte über die Properties und Methoden steuern, die von der Klasse GMSMapView bereitgestellt werden. Mit GMSMapView können Sie Markierungen, Boden-Overlays und Polylinien hinzufügen und entfernen, den Typ der angezeigten Karte ändern und steuern, was auf der Karte angezeigt wird – mithilfe der Klasse GMSCameraPosition.

Karte hinzufügen

Das Hinzufügen einer Karte umfasst die folgenden grundlegenden Schritte:

  1. Um das SDK zu erhalten, müssen Sie einen API-Schlüssel anfordern und die erforderlichen Frameworks hinzufügen. Folgen Sie dazu den Anleitungen unter:

    1. Projekt in der Google Cloud Console einrichten

    2. API-Schlüssel verwenden

    3. Xcode-Projekt einrichten

  2. Stellen Sie in AppDelegate den API-Schlüssel für die Klassenmethode provideAPIKey: auf GMSServices bereit.

  3. Erstellen oder aktualisieren Sie ein ViewController. Wenn die Karte angezeigt wird, sobald dieser Ansichts-Controller sichtbar wird, müssen Sie ihn mit der Methode loadView erstellen.

    1. Erstellen Sie ein GMSCameraPosition-Objekt, das den Mittelpunkt und die Zoomstufe der Karte angibt. Wenn Sie das Objekt GMSMapView instanziieren, müssen Sie das Objekt GMSCameraPosition als erforderlicher Parameter übergeben.

    2. Erstellen und instanziieren Sie eine GMSMapView-Klasse mit der Methode GMSMapView mapWithFrame:. Wenn diese Karte nur als Ansichtscontroller verwendet werden soll, kann CGRectZero als Rahmen für die Karte verwendet werden. Die Größe der Karte wird dann automatisch angepasst.

    3. Legen Sie das GMSMapView-Objekt als Ansicht des Controllers fest, z.B. self.view = mapView;.

Im folgenden Beispiel wird eine Karte mit der Innenstadt von Singapur in der Mitte zu einer App hinzugefügt.

Swift

import GoogleMaps

class MapObjects : UIViewController {
  override func viewDidLoad() {
    super.viewDidLoad()
    let camera = GMSCameraPosition(latitude: 1.285, longitude: 103.848, zoom: 12)
    let mapView = GMSMapView(frame: .zero, camera: camera)
    self.view = mapView
  }
}
      

Objective-C

#import "MapObjects.h"
@import GoogleMaps;

@implementation MapObjects

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                          longitude:103.848
                                                               zoom:12];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  self.view = mapView;
}

@end
      

Nachdem Sie diese Schritte ausgeführt haben, können Sie das Objekt GMSMapView weiter konfigurieren.

Weitere Informationen

Nachdem Sie diese Schritte ausgeführt haben, können Sie die Karteneinstellungen konfigurieren.