Karte mit Markierung hinzufügen

In dieser Anleitung erfahren Sie, wie Sie Ihrer iOS-App eine einfache Google-Karte mit einer Markierung hinzufügen. Sie eignet sich für Einsteiger oder Nutzer mit entsprechenden Vorkenntnissen in Swift oder Objective-C sowie allgemeinen Kenntnissen in Xcode. Einen Leitfaden zum Erstellen von Karten für fortgeschrittene Nutzer finden Sie im Entwicklerhandbuch.

In dieser Anleitung erstellen Sie die folgende Karte. Die Markierung befindet sich in Sydney, Australien.

Screenshot einer Karte mit einer Markierung über Sydney

Code abrufen

Klonen Sie das Google Maps iOS-Beispielrepository auf GitHub oder laden Sie es herunter.

Alternativ können Sie auf die folgende Schaltfläche klicken, um den Quellcode herunterzuladen:

Geben Sie mir den Code.

Swift

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.
        let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        let mapView = GMSMapView.map(withFrame: self.view.frame, camera: camera)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}
      

Objective-C

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:6];
  GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
  mapView.myLocationEnabled = YES;
  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end
      

Jetzt starten

Swift Package Manager

Das Maps SDK for iOS kann mit dem Swift Package Manager installiert werden.

  1. Entfernen Sie alle vorhandenen Abhängigkeiten vom Maps SDK for iOS.
  2. Öffnen Sie ein Terminalfenster und wechseln Sie zum Verzeichnis tutorials/map-with-marker.
  3. Schließen Sie Ihren Xcode-Arbeitsbereich und führen Sie die folgenden Befehle aus:
    sudo gem install cocoapods-deintegrate cocoapods-clean
    pod deintegrate
    pod cache clean --all
    rm Podfile
    rm map-with-marker.xcworkspace
  4. Öffnen Sie Ihr Xcode-Projekt und löschen Sie die Podfile.
  5. Wählen Sie Datei > Paketabhängigkeiten hinzufügen aus.
  6. Geben Sie https://github.com/googlemaps/ios-maps-sdk als URL ein, drücken Sie die Eingabetaste, um das Paket einzubinden, und klicken Sie auf Paket hinzufügen.
  7. Möglicherweise müssen Sie den Paketcache zurücksetzen. Klicken Sie dazu auf Datei > Pakete > Paketcache zurücksetzen.

Mit CocoaPods

  1. Laden Sie Xcode Version 15.0 oder höher herunter und installieren Sie es.
  2. Falls du CocoaPods noch nicht nutzt, installiere es unter macOS, indem du den folgenden Befehl über das Terminal ausführst:
    sudo gem install cocoapods
  3. Rufen Sie das Verzeichnis tutorials/map-with-marker auf.
  4. Führen Sie den Befehl pod install aus: Dadurch werden das in der Podfile angegebene Maps SDK und alle zugehörigen Abhängigkeiten installiert.
  5. Führen Sie pod outdated aus, um die installierte Pod-Version mit neuen Updates zu vergleichen. Wenn eine neue Version erkannt wird, führen Sie pod update aus, um Podfile zu aktualisieren und das neueste SDK zu installieren. Weitere Informationen finden Sie im CocoaPods-Leitfaden.
  6. Öffnen Sie die Datei map-with-marker.xcworkspace des Projekts mit einem Doppelklick, um sie in Xcode zu öffnen. Du musst das Projekt über die Datei .xcworkspace aufrufen.

API-Schlüssel abrufen und die erforderlichen APIs aktivieren

Als letzten Schritt benötigen Sie noch einen Google API-Schlüssel, der zum Verwenden des Maps SDK for iOS berechtigt. Klicke auf die folgende Schaltfläche, um einen Schlüssel anzufordern und die API zu aktivieren.

Jetzt starten

Weitere Informationen finden Sie unter API-Schlüssel anfordern.

API-Schlüssel zur App hinzufügen

Füge deinen API-Schlüssel folgendermaßen in AppDelegate.swift ein:

  1. Der Datei wurde die folgende Importanweisung hinzugefügt:
    import GoogleMaps
  2. Bearbeite die folgende Zeile in der Methode application(_:didFinishLaunchingWithOptions:) und ersetze YOUR_API_KEY durch deinen API-Schlüssel:
    GMSServices.provideAPIKey("YOUR_API_KEY")

App erstellen und ausführen

  1. Verbinden Sie ein iOS-Gerät mit Ihrem Computer oder wählen Sie einen Simulator aus dem Xcode-Schemamenü aus.
  2. Wenn Sie ein Gerät verwenden, müssen die Standortdienste aktiviert sein. Wenn Sie einen Simulator verwenden, wählen Sie im Menü Funktionen einen Standort aus.
  3. Klicken Sie in Xcode auf die Menüoption Product/Run (Produkt/Ausführen) oder das Wiedergabesymbol.
    • Xcode erstellt die App und führt sie dann auf dem Gerät oder im Simulator aus.
    • Es sollte eine Karte mit einer Markierung in der Mitte für Sydney an der Ostküste Australiens angezeigt werden, ähnlich wie das Bild auf dieser Seite.

Fehlerbehebung:

  • Wenn Sie keine Karte sehen, prüfen Sie, ob Sie einen API-Schlüssel erhalten und ihn wie oben beschrieben in die App eingefügt haben. Prüfe, ob es in der Xcode-Debugkonsole Fehlermeldungen zum API-Schlüssel gibt.
  • Wenn Sie den API-Schlüssel anhand der iOS-Bundle-ID eingeschränkt haben, bearbeiten Sie den Schlüssel, um die Bundle-ID für die App hinzuzufügen: com.google.examples.map-with-marker.
  • Sie benötigen eine gute WLAN- oder GPS-Verbindung.
  • Verwenden Sie die Xcode-Debugging-Tools, um Protokolle aufzurufen und Fehler in der App zu beheben.

Code verstehen

  1. Erstellen Sie eine Karte und legen Sie sie als Ansicht in viewDidLoad() fest.

    Swift

    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
    let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
    view = mapView
          

    Objective-C

    // Create a GMSCameraPosition that tells the map to display the
    // coordinate -33.86,151.20 at zoom level 6.
    GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                            longitude:151.20
                                                                 zoom:6.0];
    GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
    self.view = mapView;
          
  2. Fügen Sie der Karte in viewDidLoad() eine Markierung hinzu.

    Swift

    // Creates a marker in the center of the map.
    let marker = GMSMarker()
    marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
    marker.title = "Sydney"
    marker.snippet = "Australia"
    marker.map = mapView
          

    Objective-C

    // Creates a marker in the center of the map.
    GMSMarker *marker = [[GMSMarker alloc] init];
    marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
    marker.title = @"Sydney";
    marker.snippet = @"Australia";
    marker.map = mapView;
          

Standardmäßig wird vom Maps SDK for iOS der Inhalt des Infofensters angezeigt, wenn der Nutzer auf eine Markierung tippt. Wenn Sie mit der Standardfunktionsweise zufrieden sind, müssen Sie keinen Klick-Listener für die Markierung hinzufügen.

Glückwunsch! Sie haben eine iOS-App erstellt, in der eine Google-Karte mit einer Markierung für einen bestimmten Standort angezeigt wird. Außerdem haben Sie gelernt, wie Sie das Maps SDK for iOS verwenden.

Nächste Schritte

Weitere Informationen zum Kartenobjekt und den Möglichkeiten, die Markierungen bieten