添加带有标记的地图

本教程介绍了如何向 iOS 应用添加 Google 地图。地图中包含一个用于指示特定位置的标记(也称为图钉)。

获取代码

从 GitHub 克隆或下载 Google Maps iOS 示例代码库

设置您的开发项目

安装 Maps SDK for iOS 的步骤如下:

  1. 下载并安装 Xcode 14.0 版或更高版本。
  2. 如果您还没有 CocoaPods,请在 macOS 上从终端运行以下命令进行安装:
    sudo gem install cocoapods
  3. 克隆或下载 Google 地图 iOS 示例代码库
  4. 进入 tutorials/map-with-marker 目录。
  5. 运行 pod install 命令。此操作会安装 Podfile 中指定的 API 及其可能具有的任何依赖项。
  6. 运行 pod outdated 以将已安装的 Pod 版本与所有新更新进行比较。如果检测到新版本,请运行 pod update 以更新 Podfile 并安装最新的 SDK。如需了解详情,请参阅 CocoaPods 指南
  7. 打开(双击)项目的 map-with-marker.xcworkspace 文件,以在 Xcode 中将其打开。您必须使用 .xcworkspace 文件打开项目。

获取 API 密钥并启用必要的 API

如需完成本教程,您需要一个已获得 Maps SDK for iOS 使用授权的 Google API 密钥。点击下面的按钮以获取密钥并激活 API。

开始使用

如需了解详情,请参阅获取 API 密钥

为应用添加API密钥

按照以下方法向 AppDelegate.swift 添加 API 密钥:

  1. 请注意,以下 import 语句已添加到文件中:
    import GoogleMaps
  2. application(_:didFinishLaunchingWithOptions:) 方法中修改下面一行内容,将 YOUR_API_KEY 替换为您的 API 密钥:
    GMSServices.provideAPIKey("YOUR_API_KEY")

构建和运行您的应用

  1. 将 iOS 设备连接到您的计算机,或从 Xcode 架构弹出式菜单中选择模拟器
  2. 如果您使用的是设备,请确保已启用位置信息服务。 如果您使用的是模拟器,请从 Features(功能)菜单中选择一个位置。
  3. 在 Xcode 中,点击 Product/Run 菜单选项(或 play 按钮图标)。
    • Xcode 构建应用,然后在设备或模拟器上运行应用。
    • 您将看到一张地图,该地图的标记以澳大利亚东海岸的悉尼为中心,与本页上的图像类似。

问题排查:

  • 如果您没有看到地图,请检查您是否已按照上文中的说明获取 API 密钥并将其添加到该应用。在 Xcode 的调试控制台中查看关于 API 密钥的错误消息。
  • 如果您通过 iOS 软件包标识符限制了 API 密钥,请修改密钥以为应用添加软件包标识符:com.google.examples.map-with-marker
  • 确保 Wi-Fi 或 GPS 连接良好。
  • 使用 Xcode 调试工具查看日志并调试应用。

理解代码

  1. 创建一个地图,并将其设置为 loadView() 中的视图。

    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. loadView() 中向地图添加标记。

    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;
          

默认情况下,当用户点按某个标记时,Maps SDK for iOS 会显示信息窗口的内容。如果您愿意使用默认行为,则无需为标记添加点击监听器。

恭喜!您已构建了一个 iOS 应用,该应用显示使用标记指示特定位置的 Google 地图。您还学习了如何使用 Maps SDK for iOS

后续步骤

详细了解地图对象以及标记的各种功能。