概览

请选择平台： Android iOS JavaScript 网络服务

简介

借助 Places SDK for iOS，您可以构建位置感知应用，以便根据上下文对本地商家和其他地点做出响应。这意味着，您可以根据对用户有意义的地方构建内容丰富的应用。

概念

地点是指具有名称的物理空间。对地点的另一种说法是可以在地图上找到的任何地点。例如本地商家、地图注点和地理位置。在 API 中，地点由 GMSPlace Class Reference 表示。其中包括地点的名称及地址、地理位置、地点 ID、电话号码、地点类型、网站网址等信息。

选择 SDK 版本

Places SDK for iOS 版本 9.0.0 支持两个 SDK 版本：现有的 Places SDK for iOS 和 Places SDK for iOS（新）（新一代 SDK）。

您的第一项任务是确定要使用的 SDK。如果您是新客户或已在使用 SDK 的现有客户，则出现这种情况。如需了解两个 SDK 版本之间的主要区别，请参阅选择 SDK 版本。

每个 SDK 版本的价格

价格由您选择的 SDK 版本控制。Places SDK for iOS（新）支持简化的价格模式，这样您只需为实际使用的数据付费。如需详细了解这两种 SDK 的价格信息，请参阅用量和结算。

GooglePlacesSwift 预览版

此版本包含 GooglePlacesSwift 0.1.0 版的预览版。借助 GooglePlacesSwift，您可以使用新的 Swift 接口调用 Place API，包括 Places SDK for iOS（新）中的所有 API：

  • 地点自动补全（新）
  • 地点详情（新）
  • 地点照片（新）
  • 文本搜索（新）
  • 附近搜索（新功能）

GooglePlacesSwift 要求：

如需了解详情，请参阅 GooglePlacesSwift API 参考文档。

SDK 概览

使用 Places SDK for iOS 帮助客户探索他们的位置和周围环境。Places SDK for iOS 提供以下 API：

Places SDK for iOS（新） Places SDK for iOS 说明
地点详情（新） 地点详情 返回地点的相关信息，包括地点的名称和地址、地理位置、地点类型（如夜总会、宠物店、博物馆）等。
地点照片（新） 地点照片 返回地点的高品质图片。
文本搜索（新） 根据文本搜索返回一组地点的相关信息。
附近搜索（新功能） 通过将某个位置指定为搜索区域，返回一组地点的相关信息。
自动补全（新） 自动补全 在用户输入内容时，自动填入地点的名称和/或地址。
当前地点 返回用户设备最后已知所在地点的列表，以及每个地点的相对可能性指示。

SDK 的其他亮点包括：

  • 通过 Wi-Fi 扫描在低功耗下准确检测地点。
  • 设备端缓存：对 Places SDK for iOS 发出的大多数请求可能涉及到 Google 服务器的往返，但您也可以在本地缓存数据 30 天。

政策和条款

所有使用 Places SDK for iOS 的应用都必须遵守 Google Maps Platform 服务条款和显示提供方说明中所述的要求。