设置 Xcode 项目

启用结算功能并创建 API 密钥后，您就可以设置用于开发应用的 Xcode 项目了。

每个版本都有相应的版本说明。

第 1 步：安装所需的软件

如需使用 Maps SDK for iOS 构建项目，您必须下载并安装：

• Xcode 版本 14.0 或更高版本

• Cocoapods

第 2 步：创建 Xcode 项目并安装 Maps SDK for iOS

sudo gem install cocoapods

第 3 步：将您的 API 密钥添加到项目中

在获取 API 密钥中，您为自己的应用生成了一个 API 密钥。现在，将该密钥添加到您的 Xcode 项目中。

在下例中，将 YOUR_API_KEY 替换为您的 API 密钥。

第 4 步（可选）：选择使用 Metal 渲染框架

借助 Maps SDK for iOS，您可以选择使用 Apple 提供的 Metal 渲染框架。如需在应用中试用 Metal 渲染程序，请先调用 Objective-C 中的 [GMSServices setMetalRendererEnabled:YES] 或 Swift 的 GMSServices.setMetalRendererEnabled(true)，然后再创建地图视图。

如果您要手动安装 SDK，则还必须确保在 Xcode 中添加 Metal.framework。

第 5 步：添加地图

以下代码演示了如何向现有 ViewController 添加简单地图：

1. 在应用的默认 ViewController 中添加或更新方法，以创建和初始化 GMSMapView 的实例。

   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. 运行您的应用。您看到的地图应该在澳大利亚悉尼的中心位置带有一个标记。如果您看到了该标记，但看不到地图，请确认您已提供 API 密钥。

第 6 步（可选）：声明 API 使用的网址架构

从 iOS 9 和 Xcode 7 开始，应用可以通过在应用的 Info.plist 文件中指定网址架构来声明其打算打开的网址架构。当用户点击地图上的 Google 徽标时，Maps SDK for iOS 会打开 Google 地图移动应用，因此您的应用可以声明相关的网址架构。

如需声明 Maps SDK for iOS 使用的网址架构，请将以下行添加到 Info.plist 中：

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

下面的屏幕截图显示了 Xcode 用户界面中的配置：

如果没有上述声明，当用户点按地图上的 Google 徽标时，可能会发生以下错误：

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

为了消除这些错误，请按上文所述向 Info.plist 添加声明。

后续步骤

现在，您已经有了 API 密钥和 Xcode 项目，接下来便可以创建和运行应用了。 Maps SDK for iOS 提供了许多可帮助您顺利上手的教程和示例应用。如需了解详情，请参阅以下资源：

• 代码示例
• 教程
  • 添加带标记的地图
  • 在地图上选择当前地点并显示详细信息
  • 反向地理编码
• Codelab
• Google 地图解决方案