Xcode-Projekt einrichten

Nachdem Sie die Abrechnung aktiviert und einen API-Schlüssel erstellt haben, können Sie das Xcode-Projekt einrichten, das Sie zum Entwickeln Ihrer Anwendung verwenden.

Schritt 1: Erforderliche Software installieren

Wenn Sie ein Projekt mit dem Maps SDK for iOS erstellen möchten, müssen Sie es herunterladen und installieren:

  • Xcode Version 13.0 oder höher

  • CocoaPods oder Carthage

Schritt 2: Xcode-Projekt erstellen und das Maps SDK for iOS installieren

Mit CocoaPods

Das Maps SDK for iOS ist als Pod von CocoaPods verfügbar. CocoaPods ist ein Open-Source-Abhängigkeitsmanager für Cocoa-Projekte in Swift und Objective-C.

Falls du das Tool „CocoaPods“ noch nicht nutzt, installiere es unter macOS, indem du den folgenden Befehl über das Terminal ausführst. Weitere Informationen findest du im Startleitfaden zu CocoaPods (in englischer Sprache).

sudo gem install cocoapods

Erstelle eine Podfile für das Maps SDK for iOS und verwende sie, um die API und die zugehörigen Abhängigkeiten zu installieren:

  1. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie die iOS-Entwicklung noch nicht kennen:
    1. Erstellen Sie ein neues Projekt.
    2. Wählen Sie die Vorlage iOS > App aus.
    3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie sich den Wert im Feld Paket-ID. Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
      3. Setzen Sie das Projekt Interface (Schnittstelle) auf Storyboard.
      4. Legen Sie für Sprache Swift oder Objective-C fest.
  2. Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.
  3. Bearbeiten Sie Podfile und fügen Sie Ihre Abhängigkeiten zusammen mit ihren Versionen hinzu. Das folgende Beispiel enthält die Abhängigkeit, die du für das Maps SDK for iOS benötigst: 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '7.4.0'
end
    Führe regelmäßig pod outdated aus, um festzustellen, ob es eine neuere Version gibt, damit du immer auf dem neuesten Stand bist. Führen Sie bei Bedarf ein Upgrade auf die neueste Version aus.
  4. Speichere die Podfile.

  5. Öffnen Sie ein Terminal und rufen Sie das Verzeichnis mit dem Podfile auf:

    cd <path-to-project>

  6. Führe den Befehl pod install aus. Dadurch werden die in der Podfile angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert.

    pod install

  7. Schließe Xcode und öffne dann mit einem Doppelklick die Datei .xcworkspace deines Projekts, um Xcode wieder zu starten. Ab jetzt musst du das Projekt über die Datei .xcworkspace aufrufen.

So aktualisieren Sie die API für ein vorhandenes Projekt:

  1. Öffnen Sie ein Terminal und rufen Sie das Projektverzeichnis auf, das die Podfile enthält.
  2. Führe den Befehl pod update aus. Dadurch werden alle in Podfile angegebenen APIs auf die neueste Version aktualisiert.

Karthago

Das Maps SDK for iOS kann mit Carthage verwendet werden, einem einfachen, dezentralen Abhängigkeitsmanager für Swift- und Objective-C Cocoa-Projekte.

  1. Carthage installieren. Es gibt mehrere Methoden. Eine genaue Anleitung finden Sie in der Readme-Datei von Karthago.
  2. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie die iOS-Entwicklung noch nicht kennen:
    1. Erstellen Sie ein neues Projekt.
    2. Wählen Sie die Vorlage iOS > App aus.
    3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie sich den Wert im Feld Paket-ID. Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
      3. Setzen Sie das Projekt Interface (Schnittstelle) auf Storyboard.
      4. Legen Sie für Sprache Swift oder Objective-C fest.
  3. Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Cartfile. Diese Datei definiert die Abhängigkeiten Ihres Projekts.
  4. Bearbeiten Sie Cartfile und fügen Sie die Abhängigkeiten zusammen mit ihren Versionen hinzu:
    binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1
    Führen Sie carthage outdated regelmäßig aus, um zu erkennen, wann eine neuere Version vorhanden ist, damit Sie immer auf dem neuesten Stand sind. Führen Sie bei Bedarf ein Upgrade auf die neueste Version durch.
  5. Speichere die Cartfile.
  6. Wechseln Sie in einem Terminalfenster zum Verzeichnis mit dem Cartfile:
    cd <path-to-project>
  7. Führe den Befehl carthage update aus. Dadurch werden die in der Cartfile angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert.
  8. Rufen Sie im Finder im Projektverzeichnis die heruntergeladenen Framework-Dateien unter Carthage/Build/iOS auf.
  9. Ziehen Sie die folgenden Bundles in Ihr Projekt: Wählen Sie bei entsprechender Aufforderung Elemente bei Bedarf kopieren und dieselbe Version wie oben verwenden aus.
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.xcframework
    • (Nur für Kunden mit Premiumoption) GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.xcframework
  10. Klicke in deinem Projekt mit der rechten Maustaste auf GoogleMaps.xcframework und wähle Show In Finder (In Finder zeigen) aus.
  11. Ziehen Sie GoogleMaps.bundle aus dem Ordner Resources in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, achten Sie darauf, dass Copy items into target group's folder (Elemente in Ordner der Zielgruppe kopieren) nicht ausgewählt ist.
  12. Wähle im Project Navigator dein Projekt aus und gib dann das Ziel deiner App an.
  13. Öffnen Sie den Tab Build Phases (Build-Phasen) für das Ziel Ihrer Anwendung und fügen Sie unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) die folgenden Frameworks und Bibliotheken hinzu:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

  14. Wähle statt eines bestimmten Ziels dein Projekt aus und öffne den Tab Build Settings (Build-Einstellungen). Gib im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) den Code -ObjC ein. Falls die Einstellungen nicht angezeigt werden, filtere in der Leiste Build Settings nicht mehr nach Basic (Standard), sondern nach All (Alle).

  15. Informationen zum Installieren des Places SDK for iOS findest du im Startleitfaden zum Places SDK for iOS (in englischer Sprache).

So aktualisieren Sie die API für ein vorhandenes Projekt:

  1. Öffnen Sie ein Terminal und rufen Sie das Projektverzeichnis auf, das die Cartfile enthält.
  2. Führe den Befehl carthage update aus. Dadurch werden alle in Cartfile angegebenen APIs auf die neueste Version aktualisiert.

Manuell installieren

In diesem Leitfaden erfahren Sie, wie Sie das Maps SDK for iOS Ihrem Projekt manuell hinzufügen und Ihre Build-Einstellungen in Xcode konfigurieren.

  1. Laden Sie die SDK-Quelldateien herunter: GoogleMaps-7.4.0.
  2. Entpacke die Quelldateien.
  3. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie die iOS-Entwicklung noch nicht kennen:
    1. Erstellen Sie ein neues Projekt.
    2. Wählen Sie die Vorlage iOS > App aus.
    3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie sich den Wert im Feld Paket-ID. Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
      3. Setzen Sie das Projekt Interface (Schnittstelle) auf Storyboard.
      4. Legen Sie für Sprache Swift oder Objective-C fest.
  4. Ziehen Sie die folgenden Bundles in Ihr Projekt: Wählen Sie bei entsprechender Aufforderung Elemente bei Bedarf kopieren und dieselbe Version wie oben verwenden aus.
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.xcframework
    • (Nur für Kunden mit Premiumoption) GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.xcframework
  5. Klicke in deinem Projekt mit der rechten Maustaste auf GoogleMaps.xcframework und wähle Show In Finder (In Finder zeigen) aus.
  6. Ziehen Sie GoogleMaps.bundle aus dem Ordner Resources in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, achten Sie darauf, dass Copy items into target group's folder (Elemente in Ordner der Zielgruppe kopieren) nicht ausgewählt ist.
  7. Wähle im Project Navigator dein Projekt aus und gib dann das Ziel deiner App an.
  8. Öffnen Sie den Tab Build Phases (Build-Phasen) für das Ziel Ihrer Anwendung und fügen Sie unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) die folgenden Frameworks und Bibliotheken hinzu:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

  9. Wähle statt eines bestimmten Ziels dein Projekt aus und öffne den Tab Build Settings (Build-Einstellungen). Gib im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) den Code -ObjC ein. Falls die Einstellungen nicht angezeigt werden, filtere in der Leiste Build Settings nicht mehr nach Basic (Standard), sondern nach All (Alle).

  10. Informationen zum Installieren des Places SDK for iOS findest du im Startleitfaden zum Places SDK for iOS (in englischer Sprache).

XCFramework installieren

Ein XCFramework ist ein binäres Paket, das Sie auf mehreren Plattformen verwenden können, einschließlich Computern, auf denen der M1-Chipsatz verwendet wird, um das Maps SDK for iOS zu installieren. In diesem Leitfaden erfahren Sie, wie Sie das XCFramework, das das Maps SDK for iOS enthält, Ihrem Projekt hinzufügen und die Build-Einstellungen in Xcode konfigurieren.

Mit Karthago

Das Maps SDK for iOS kann mit Carthage verwendet werden, einem einfachen, dezentralen Abhängigkeitsmanager für Swift- und Objective-C-Cocoa-Projekte.

  1. Carthage installieren. Es gibt mehrere Methoden. Eine genaue Anleitung finden Sie in der Readme-Datei von Karthago.
  2. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie die iOS-Entwicklung noch nicht kennen:
    1. Erstellen Sie ein neues Projekt.
    2. Wählen Sie die Vorlage iOS > App aus.
    3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie sich den Wert im Feld Paket-ID. Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
      3. Setzen Sie das Projekt Interface (Schnittstelle) auf Storyboard.
      4. Legen Sie für Sprache Swift oder Objective-C fest.
  3. Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Cartfile. Diese Datei definiert die Abhängigkeiten Ihres Projekts.

  4. Bearbeiten Sie Cartfile und fügen Sie die Abhängigkeiten zusammen mit ihren Versionen hinzu:

    binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1-beta
  5. Speichere die Cartfile.
  6. Wechseln Sie in einem Terminalfenster zum Verzeichnis mit dem Cartfile:
    cd <path-to-project>
  7. Führe den Befehl carthage update aus. Dadurch werden die in Cartfile angegebenen APIs sowie ggf. zugehörige Abhängigkeiten installiert.
  8. Rufen Sie im Finder im Projektverzeichnis die heruntergeladenen Framework-Dateien unter Carthage/Build auf.
  9. Ziehen Sie die folgenden XCFrameworks unter Frameworks, Libraries, Embedded Content in Ihr Projekt. Wähle für jedes XCFramework Do Not Embed (Nicht einbetten) aus:
    • GoogleMaps-x.x.x/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/GoogleMapsCore.xcframework
    • (Nur für Kunden mit Premiumoption) GoogleMaps-x.x.x/GoogleMapsM4B.xcframework
  10. Klicken Sie mit der rechten Maustaste auf GoogleMaps.xcframework in Ihrem Projekt und wählen Sie In Finder anzeigen aus.
  11. Ziehen Sie GoogleMaps.bundle aus dem Ordner ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, muss Bei Bedarf kopieren nicht ausgewählt sein.
  12. Wählen Sie Ihr Projekt im Project Navigator und dann das Ziel Ihrer Anwendung aus.
  13. Öffnen Sie den Tab Build Phases (Build-Phasen) für das Ziel Ihrer Anwendung sowie unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) und fügen Sie die folgenden Frameworks und Bibliotheken hinzu:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

  14. Wählen Sie Ihr Projekt anstelle eines bestimmten Ziels aus und öffnen Sie den Tab Build Settings (Build-Einstellungen). Fügen Sie im Abschnitt Andere Linker-Flags -ObjC hinzu. Wenn diese Einstellungen nicht sichtbar sind, ändern Sie den Filter in der Leiste Build Settings von Basic zu All.

  15. Informationen zum Installieren des Places SDK for iOS XCFramework finden Sie unter Erste Schritte mit dem Places SDK for iOS.

Manuell

In diesem Leitfaden erfahren Sie, wie Sie das Maps SDK for iOS Ihrem Projekt manuell hinzufügen und Ihre Build-Einstellungen in Xcode konfigurieren.

  1. Laden Sie die SDK-Quelldateien herunter: GoogleMaps-7.4.0.
  2. Entpacke die Quelldateien. Rufen Sie den Ordner Frameworks auf, um auf das XCFramework zuzugreifen.
  3. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie die iOS-Entwicklung noch nicht kennen:
    1. Erstellen Sie ein neues Projekt.
    2. Wählen Sie die Vorlage iOS > App aus.
    3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie sich den Wert im Feld Paket-ID. Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
      3. Setzen Sie das Projekt Interface (Schnittstelle) auf Storyboard.
      4. Legen Sie für Sprache Swift oder Objective-C fest.
  4. Ziehen Sie die folgenden XCFrameworks unter Frameworks, Libraries, Embedded Content in Ihr Projekt. Wähle für jedes XCFramework Do Not Embed (Nicht einbetten) aus:
    • GoogleMaps-x.x.x/GoogleMapsBase.xcframework
    • GoogleMaps-x.x.x/GoogleMaps.xcframework
    • GoogleMaps-x.x.x/GoogleMapsCore.xcframework
    • (Nur für Kunden mit Premiumoption) GoogleMaps-x.x.x/GoogleMapsM4B.xcframework
  5. Klicken Sie mit der rechten Maustaste auf GoogleMaps.xcframework in Ihrem Projekt und wählen Sie In Finder anzeigen aus.
  6. Ziehen Sie GoogleMaps.bundle aus dem Ordner ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, muss Bei Bedarf kopieren nicht ausgewählt sein.
  7. Wählen Sie Ihr Projekt im Project Navigator und dann das Ziel Ihrer Anwendung aus.
  8. Öffnen Sie den Tab Build Phases (Build-Phasen) für das Ziel Ihrer Anwendung sowie unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) und fügen Sie die folgenden Frameworks und Bibliotheken hinzu:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

  9. Wählen Sie Ihr Projekt anstelle eines bestimmten Ziels aus und öffnen Sie den Tab Build Settings (Build-Einstellungen). Fügen Sie im Abschnitt Andere Linker-Flags -ObjC hinzu. Wenn diese Einstellungen nicht sichtbar sind, ändern Sie den Filter in der Leiste Build Settings von Basic zu All.

  10. Informationen zum Installieren des Places SDK for iOS XCFramework finden Sie unter Erste Schritte mit dem Places SDK for iOS.

Schritt 3: API-Schlüssel zum Projekt hinzufügen

Im Abschnitt API-Schlüssel abrufen haben Sie einen API-Schlüssel für Ihre App generiert. Fügen Sie diesen Schlüssel nun Ihrem Xcode-Projekt hinzu.

Ersetze YOUR_API_KEY in den folgenden Beispielen durch deinen API-Schlüssel.

Swift

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

  1. Fügen Sie die folgende Importanweisung hinzu: 
    import GoogleMaps
  2. Fügen Sie der Methode application(_:didFinishLaunchingWithOptions:) mit Ihrem API-Schlüssel Folgendes hinzu: 
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Wenn Sie auch die Places API verwenden, fügen Sie Ihren Schlüssel noch einmal hinzu, wie hier gezeigt: 
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

  1. Fügen Sie die folgende Importanweisung hinzu: 
    @import GoogleMaps;
  2. Fügen Sie der Methode application:didFinishLaunchingWithOptions: mit Ihrem API-Schlüssel Folgendes hinzu: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Wenn Sie auch die Places API verwenden, fügen Sie Ihren Schlüssel noch einmal hinzu, wie hier gezeigt: 
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Schritt 4 (optional): Meta-Rendering-Framework aktivieren

Mit dem Maps SDK for iOS kannst du das Metal-Rendering-Framework von Apple aktivieren. Wenn Sie den Metal-Renderer in Ihrer App ausprobieren möchten, rufen Sie [GMSServices setMetalRendererEnabled:YES] in Objective-C oder GMSServices.setMetalRendererEnabled(true) in Swift auf, bevor Sie Kartenansichten erstellen.

Wenn Sie das SDK manuell installieren, müssen Sie auch Metal.framework in Xcode hinzufügen.

Schritt 5: Karte hinzufügen

Der folgende Code zeigt, wie Sie einem vorhandenen ViewController eine einfache Karte hinzufügen:

  1. Fügen Sie Methoden im Standard-ViewController Ihrer Anwendung hinzu, um eine Instanz von GMSMapView zu erstellen und zu initialisieren.

    Swift

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

    Objective-C

    /*
* 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

    ViewController.m

  2. Führe deine App aus. Sie sollten eine Karte mit einer einzelnen Markierung über Sydney in Australien sehen. Wenn Sie die Markierung, aber nicht die Karte sehen, prüfen Sie, ob Sie Ihren API-Schlüssel angegeben haben.

Schritt 6 (optional): Von der API verwendete URL-Schemas angeben

Ab iOS 9 und Xcode 7 können Anwendungen die URL-Schemas deklarieren, die sie öffnen möchten, indem sie die Schemas in der Datei Info.plist der App angeben. Über das Maps SDK for iOS wird die Google Maps App geöffnet, wenn der Nutzer auf das Google-Logo auf der Karte klickt. In der App werden dann die entsprechenden URL-Schemas deklariert.

Wenn Sie die vom Maps SDK for iOS verwendeten URL-Schemas angeben möchten, fügen Sie Ihrem Info.plist die folgenden Zeilen hinzu:

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>googlechromes</string>
    <string>comgooglemaps</string>
</array>

Im folgenden Screenshot wird die Konfiguration in der Benutzerschnittstelle von Xcode gezeigt:

LSApplicationQueriesSchemes-Konfiguration in Xcode

Ohne die obige Erklärung können die folgenden Fehler auftreten, wenn der Nutzer auf das Google-Logo auf der Karte tippt:

-canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
-canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

Fügen Sie die Deklaration wie oben beschrieben zu Info.plist hinzu, um diese Fehler zu beheben.

Nächste Schritte

Nachdem Sie nun einen API-Schlüssel und ein Xcode-Projekt haben, können Sie Anwendungen erstellen und ausführen. Das Maps SDK for iOS bietet viele Anleitungen und Beispiel-Apps, die Ihnen den Einstieg erleichtern. Weitere Informationen finden Sie hier: