Karte mit einer Markierung hinzufügen

In dieser Anleitung erfahren Sie, wie Sie in Ihre iOS-App eine Google-Karte mit einer Markierung für einen bestimmten Standort einbinden.

Code abrufen

Klonen Sie das Google Maps iOS-Beispiel-Repository oder laden Sie es von GitHub herunter.

/*
 * Copyright 2020 Google Inc. All rights reserved.
 *
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
 * file except in compliance with the License. You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 * ANY KIND, either express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */

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
  }
}

/*
* Copyright 2020 Google Inc. All rights reserved.
*
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
* file except in compliance with the License. You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under
* the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
* ANY KIND, either express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/

#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

Entwicklungsprojekt einrichten

So installieren Sie das Maps SDK for iOS:

1. Laden Sie Xcode Version 14.0 oder höher herunter und installieren Sie es.
2. Wenn Sie CocoaPods noch nicht haben, installieren Sie sie unter macOS. Führen Sie dazu den folgenden Befehl im Terminal aus:

   sudo gem install cocoapods

3. Klonen oder laden Sie das Google Maps iOS-Beispiel-Repository herunter.
4. Rufen Sie das Verzeichnis tutorials/map-with-marker auf.
5. Führe den Befehl pod install aus. Dadurch werden die in Podfile angegebenen APIs sowie ggf. vorhandene Abhängigkeiten installiert.
6. 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.
7. Öffnen Sie die Datei map-with-marker.xcworkspace des Projekts, um sie in Xcode zu öffnen. Zum Öffnen des Projekts müssen Sie die Datei .xcworkspace verwenden.

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. Klicken Sie auf die Schaltfläche unten, um einen Schlüssel anzufordern und die API zu aktivieren.

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

API-Schlüssel zur App hinzufügen

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

1. Die folgende Importanweisung wurde der Datei hinzugefügt:

   import GoogleMaps

2. Bearbeiten Sie die folgende Zeile in der Methode application(_:didFinishLaunchingWithOptions:) und ersetzen Sie YOUR_API_KEY durch Ihren API-Schlüssel:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Anwendung erstellen und ausführen

1. Verbinden Sie ein iOS-Gerät mit Ihrem Computer oder wählen Sie im Pop-up-Menü Xcode-Schema einen Simulator aus.
2. Wenn Sie ein Gerät verwenden, müssen die Standortdienste aktiviert sein. Wenn Sie einen Simulator verwenden, wählen Sie einen Standort aus dem Menü Features 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.
• Sie sollten eine Karte mit einer Markierung für Sydney an der Ostküste Australiens sehen, ä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üfen Sie die Debugging-Konsole von Xcode auf Fehlermeldungen zum API-Schlüssel.
• Wenn du den API-Schlüssel durch die iOS-Paket-ID eingeschränkt hast, bearbeite den Schlüssel, um die Bundle-ID für die App hinzuzufügen: com.google.examples.map-with-marker.
• Prüfen Sie, ob Sie eine gute WLAN- oder GPS-Verbindung haben.
• Verwenden Sie die Xcode-Debugging-Tools, um Logs aufzurufen und Fehler in der Anwendung zu beheben.

Den Code verstehen

1. Erstellen Sie eine Karte und legen Sie sie als Ansicht in loadView() 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. Markierung zur Karte in loadView() hinzufügen

   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 wissen Sie jetzt, wie das Maps SDK for iOS verwendet wird.

Nächste Schritte

Weitere Informationen zum Kartenobjekt und dazu, was Sie mit Markierungen tun können