Places SDK for iOS 代码示例

请选择平台Android iOS JavaScript

GitHub GitHub 上提供的 Places SDK for iOS 演示版应用随 Places SDK for iOS 一起提供,演示了多项功能,包括地点自动补全和 Place Photos。此外,您亦可在本开发者指南的每个页面上找到代码段。 您可以导入并构建应用、添加 API 密钥、查看演示版功能,并以提供的示例代码为出发点开发您的应用。

当您运行示例应用时,它会显示一个包含可用示例的列表,您可以在自己的设备上运行这些示例。选择其中一个选项。

在本地运行完整示例应用

Places SDK for iOS 示例应用可从 GitHub 下载归档文件。请按照以下步骤安装并试用 Places SDK for iOS 示例应用。

  1. 从 GitHub 下载代码示例归档文件,然后解压缩该归档文件。或者,将代码库克隆到本地目录:
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git
  2. 打开终端窗口,导航到解压缩示例文件的目录,然后深入到要使用的版本的目录:

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
    open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
    open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
    open GooglePlacesXCFrameworkDemos.xcodeproj
  3. 在 Xcode 项目中,依次前往 File (文件)> Add Package Dependencies (添加软件包依赖项)。输入 https://github.com/googlemaps/ios-places-sdk 作为网址,按 Enter 键拉取软件包,然后点击 Add Package(添加软件包)。
  4. 为您的 Google Cloud 控制台项目启用 Places SDK for iOS Maps SDK for iOS
  5. 从启用了 Places API 和/或 Places API(新) 的项目中 获取 API 密钥。
  6. 按照下面的相应说明将 API 密钥添加到应用中。

    SwiftUI

    在与演示应用的 Info.plist 文件 (GooglePlacesDemos/GooglePlacesDemos) 相同的目录中,为您的 API 密钥创建一个名为 GooglePlacesDemos.xcconfig 的本地配置文件。

    向配置文件添加两行代码,以定义您的 API 密钥:

    PLACES_API_KEY = YOUR_PLACES_API_KEYMAPS_API_KEY = YOUR_MAPS_API_KEY

    YOUR_PLACES_API_KEYYOUR_MAPS_API_KEY 替换为上一步中的 API 密钥。

    如需有关创建本地配置文件的帮助,请参阅配置文件 (xcconfig) 格式

    Swift

    修改 SDKDemoAPIKey 文件,并将您的 API 密钥 粘贴到相应的常量中。例如:

    let placesAPIKey = "YOUR_API_KEY"

    如果存在以下行,请将其移除:

    #error (Register for API Key and insert here. Then delete this line.)

    如果 Xcode 提示您解锁 SDKDemoAPIKey 文件以进行 修改,请选择 Unlock

    Objective-C

    修改 SDKDemoAPIKey 文件,并将您的 API 密钥 粘贴到相应的常量中。例如:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    如果存在以下行,请将其移除

    #error (Register for API Key and insert here. Then delete this line.)

    如果 Xcode 提示您解锁 SDKDemoAPIKey 文件以进行 修改,请选择 Unlock

  7. 构建应用
  8. 如果构建失败,或者应用在首次运行时因 API 密钥 而崩溃并显示错误,请确保您已按照上述说明提供了所需的 密钥。
  9. 如果您运行示例应用,iOS 模拟器 窗口将显示地点演示列表。
  10. 如果系统提示您允许演示版应用访问您的位置信息,请选择 允许
  11. 现在可以运行您选择的示例了。