概览

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

简介

借助 Places SDK for iOS,您可以构建能够根据情境响应设备附近的本地商家和其他地点的位置感知应用。也就是说,您可以根据对用户有意义的地方构建内容丰富的应用。

概念

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

选择 SDK 版本

Places SDK for iOS 版本 8.5.0 支持两个 SDK 版本:现有的 Places SDK for iOSPlaces SDK for iOS(新)(新一代 SDK)。

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

每个 SDK 版本的价格

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

API 概览

帮助客户探索其所在位置和周围环境:

  • 地点详情会返回地点的相关信息,包括地点的名称和地址、以纬度和经度坐标形式指定的地理位置、地点类型(如夜总会、宠物店、博物馆)等。
  • 当前地点会返回用户设备最后已知所在地点的列表,以及每个地点的相对可能性指示。
  • 地点自动补全功能会在用户输入内容时自动填充地点的名称和/或地址。
  • 地点照片会返回商家的高画质图片。
  • 地点 ID 存储一个或多个地点的唯一 ID,以便按需检索地点信息。
  • 文本搜索会根据文本搜索返回一组地点的相关信息。

API 的其他重要内容包括:

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

政策和条款

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