旧版 Places 和 Routes SKU 详情

本页面提供了旧版 Places API、旧版 Directions API 和旧版 Distance Matrix API SKU 的 SKU 详情、SKU ID、可结算事件和结算触发条件。如需了解这些服务的当前版本,请参阅地点(新版)SKU 详情和路线和导航 SKU 详情。如需查看所有商品类别的目录,请参阅 API 使用情况详情概览。

关于 SKU 表

以下部分概述了每个 SKU 的详细信息:

类别 SKU 是否属于基本功能版、专业版或企业版 SKU 类别。
可结算事件 针对 SKU 计费的事件。
触发器 哪些代码元素会触发计费事件。
价格 指向该 SKU 组的价格表的链接。

旧版地点产品 SKU

如需了解最新版本,请参阅地点(新)产品 SKU。

关于地点数据 SKU

一共有三个地点数据 SKU,包括:基本数据、联系人数据和氛围数据。

系统会针对以下情况触发一个或多个数据 SKU:

  • Android:对 fetchPlace() 或 findCurrentPlace() 的每次请求
  • iOS:对 fetchPlaceFromPlaceID: 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 的每次调用
  • 网络服务:每个地点请求,具体取决于请求中指定的字段

对于触发数据 SKU 的请求,除了基本 SKU 费用之外,您还始终需要支付相应的数据 SKU 费用。例如,对于包含“基本数据”字段的“地点详情”请求,您需要同时支付“基本数据”SKU 费用和“地点详情”SKU 费用。

对于 Web 服务,以下 Places API 请求允许您指定要返回的数据字段:

对于 Web 服务,以下 Places API 调用不支持指定返回的字段。这些调用始终会返回所有地点数据,您除了支付每个 API 请求的费用外,还需支付三个地点数据 SKU 的费用:

[ Essentials: Places Legacy ]

SKU:自动补全 - 按请求结算

  类别 基本功能版
  SKU ID

7384-2DE4-D388(全球)

2164-BC00-53DC(印度)

  API 地点自动补全(旧版)Android、
地点自动补全(旧版)iOS、
地点自动补全(旧版)Web
  可结算事件 不包含会话令牌的请求
  触发器
  示例

如果您从无效的“自动补全”会话(例如,重复使用会话令牌的会话)发出请求,系统也会向您收取“自动补全 - 按请求结算”SKU 费用。

如果您从无效的“自动补全”会话发出请求,则来自 Maps JavaScript API 地点自动补全 widget 的“自动补全”请求可能会被收取“自动补全 - 按请求结算”SKU 费用。当用户输入多个不同的地址或将不同的地址复制/粘贴到该 widget 中,且并不总是选择自动补全联想查询时,可能会发生这种情况。

  价格 价格表(全球)
价格表(印度)

SKU:自动补全(包含地点详情)- 按会话结算

  类别 基本功能版
  SKU ID

E9C9-934B-DDB1(全球)

  API 地点自动补全(旧版)Android、
地点自动补全(旧版)iOS、
地点自动补全(旧版)Web
  可结算事件 会话
  触发器
  • Android:对 fetchPlace() 的调用
  • iOS:对 fetchPlaceFromPlaceID: 的调用
  • 网络服务:“地点详情”请求

请求中的字段:

请务必在请求中指定您需要的字段,以免产生不必要的费用。 根据您指定的字段,“地点详情”请求还会生成以下数据 SKU:

如果您未在“地点详情”请求中指定字段,系统会触发所有数据 SKU。

如果您在“自动补全”会话期间仅请求刷新地点详情 ID(您的请求仅指定 place_id 字段),则该会话将按 SKU:自动补全(不含地点详情)- 按会话结算计费。

  示例

自动补全请求是免费的。当您根据常规地点详情定价请求后续地点详情时,此旧版 SKU 会计费。

此示例说明了按平台划分的一系列请求,当您按 SKU 查看账单时,这些请求会在账单中生成以下 SKU:

  • 自动补全(包含地点详情)- 按会话结算
  • 地点详情
  • 基本数据

按平台划分的请求示例:

Android 请求

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace()(通过包含地点 ID 和 ADDRESS 字段的 FetchPlaceRequest)

iOS 请求

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (包含地点 ID 和 GMSPlaceFieldFormattedAddress 字段)

Web 服务请求

“地点自动补全”请求 (input="par", session_token: XYZ)
“地点自动补全”请求 (input="paris", session_token: XYZ)
地点详情 (place_id, session_token: XYZ, fields:formatted_address)

  价格 价格表(全球)
价格表(印度)

关于“自动补全”会话

“自动补全”会话包含一些“自动补全”请求(用于在用户输入内容时检索建议地点),以及最多一个“地点详情”请求(用于检索与用户所选的地点有关的详细信息)。系统会将同一个会话令牌传递给“自动补全”请求和随后的“地点详情”请求。第一个“自动补全”请求发出时(通常是在用户开始输入时),会话开始。在用户选择其中一条“自动补全”建议后,系统会执行“地点详情”调用。如果用户未选择建议,系统不会执行“地点详情”调用。

在用户选择地点(即系统执行“地点详情”调用)后,您必须使用新的会话令牌启动新会话。

“自动补全”会话可以通过以下 API 生成:

会话令牌非常适合单个用户会话,但不能用于多个用户会话。如果您重复使用某个会话令牌,相应会话会被视为无效,并且系统会按未提供会话令牌的情况为请求计费。

使用会话的“自动补全”请求和“地点详情”请求以不同的 SKU 计费。

SKU:基本数据

数据 SKU,针对地点详情或查找地点请求中的基本数据字段进行结算。

  类别 基本功能版
  SKU ID

75D4-C522-326B(全球)

5D7B-1F7B-395E(印度)

  API 地点详情(旧版) (包含基本字段)
查找地点(旧版) (包含基本字段)
  可结算事件 成功请求基本数据字段
  触发器

Android SDK 的字段

Place.Field.ACCESSIBILITY_OPTIONS*
   * 用于替代 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE(已弃用)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * 用于替代 Place.Field.NAME(已弃用)
Place.Field.FORMATTED_ADDRESS*
   * 用于替代 Place.Field.ADDRESS(已弃用)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * 用于替代 Place.Field.ICON_URL(已弃用)
Place.Field.ID
Place.Field.LOCATION*
   * 用于替代 Place.Field.LAT_LNG(已弃用)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET。

适用于 iOS 的字段

GMSPlaceFieldFormattedAddress
GMSPlaceFieldBusinessStatus
GMSPlaceFieldID
GMSPlaceFieldCoordinate
GMSPlaceFieldName
GMSPlaceFieldPhotos
GMSPlaceFieldPlusCode
GMSPlaceFieldTypes
GMSPlaceFieldViewport

Web 服务字段

address_component
adr_address
business_status
formatted_address
geometry
icon
name
permanently_closed
photo
place_id
plus_code
type
url
utc_offset
vicinity
wheelchair_accessible_entrance

  字段掩码结算

系统会根据字段掩码中提供的字段对您的请求进行结算。例如:

  • 如果您的字段掩码仅包含此 SKU 中的字段:系统会按此 SKU 的费率对请求计费。
  • 如果您的字段掩码包含其他 SKU 中的字段:系统会按所请求字段的最高 SKU 费率对请求进行结算。例如,如果您同时添加了 Essentials SKU 和 Enterprise SKU 中的字段,则系统会按 Enterprise SKU 费率对请求进行结算。
  价格 价格表(全球)
价格表(印度)

SKU:查找地点 - 仅返回 ID

  类别 基本功能版
  SKU ID

44A2-D839-A3AC(全球)

FE05-60A4-CDDF(印度)

  API Places Web Service 的“查找地点”功能
  可结算事件 仅成功请求了 place_id
  触发器 未指定任何字段或仅指定 place_id 字段的查找地点请求:FindPlace(fields: place_id)。
  价格 价格表(全球)
价格表(印度)

SKU:地点详情 - ID 刷新

  类别 基本功能版
  SKU ID

2D88-4302-6299(全球)

4604-F56B-7086(印度)

  API 地点详情(旧版)
  可结算事件 仅请求 ID 字段的成功请求
  触发器 仅包含地点 ID 字段的请求:getPlaceDetails(fields: place_id)。
  价格 价格表(全球)
价格表(印度)

SKU:查询自动补全 - 按请求结算

  类别 基本功能版
  SKU ID

C4B1-8805-63EF(全球)

59E9-EB83-5CA3(印度)

  API 查询自动补全服务
  可结算事件 请求成功
  触发器

使用“查询自动补全”时,不支持按“自动补全”会话定价。随后的“地点详情”请求需按地点详情 Pro SKU 支付费用。

  价格 价格表(全球)
价格表(印度)

[ Pro:Places Legacy ]

SKU:自动补全(不含地点详情)- 按会话结算

  类别 Pro
  SKU ID

B52C-8320-6DC5(全球)

C625-D3CE-DF37(印度)

  API 地点自动补全(旧版)Android、
地点自动补全(旧版)iOS、
地点自动补全(旧版)Web
  可结算事件 会话
  触发器
  价格 价格表(全球)
价格表(印度)

SKU:查找当前地点

  类别 Pro
  SKU ID

7218-264C-D1D7(全球)

0862-F46E-1A1A(印度)

  API Places SDK for Android、
Places SDK for iOS
  可结算事件 请求成功
  触发器
  示例

以下示例展示了在发出“查找当前地点”请求并指定基本数据、联系人数据和氛围数据 SKU 中的字段时,系统会向您收取哪些 SKU 的费用。如需查看账单中的 SKU,请按照按 SKU 分析用量和费用中的说明按 SKU 查看账单。

您发出“查找当前地点”请求,且仅指定 ADDRESS 字段:

您的账单会显示以下 SKU:

  • 查找当前地点
  • 基本数据

您发出“查找当前地点”请求,且仅指定 PHONE_NUMBER 字段:

您的账单会显示以下 SKU:

  • 查找当前地点
  • 联系人数据

您发出“查找当前地点”请求并指定所有三个数据类型字段:

您的账单会显示以下 SKU:

  • 查找当前地点
  • 基本数据
  • 联系人数据
  • 环境氛围数据

  价格 价格表(全球)
价格表(印度)

SKU:查找地点

  类别 Pro
  SKU ID

DC67-3188-2294(全球)

ECB4-087C-9A27(印度)

  API 查找地点(旧版)
  可结算事件 成功请求了 ID 字段以外的其他字段
  触发器 查找地点请求,其中指定的字段不只是 ID 字段。
  示例

以下示例展示了在发出“查找当前地点”请求并指定基本数据、联系人数据和氛围数据 SKU 中的字段时,系统会向您收取哪些 SKU 的费用。如需查看账单中的 SKU,请按照按 SKU 分析用量和费用中的说明按 SKU 查看账单。

您发出仅包含 ADDRESS 字段的“查找地点”请求:

您的账单会显示以下 SKU:

  • 查找当前地点
  • 基本数据

您发出仅包含 PHONE_NUMBER 字段的“查找地点”请求:

您的账单会显示以下 SKU:

  • 查找当前地点
  • 联系人数据

您发出“查找地点”请求并指定所有三个数据类型字段:

您的账单会显示以下 SKU:

  • 查找当前地点
  • 基本数据
  • 联系人数据
  • 环境氛围数据

  价格 价格表(全球)
价格表(印度)

SKU:地点 - 附近搜索

  类别 Pro
  SKU ID

6B23-8A17-D29D(全球)

CC66-BE0E-2477(印度)

  API 附近搜索(旧版)
  可结算事件 Pro 版功能申请成功
  触发器

此请求不支持指定要返回的字段。响应会返回一个地点列表和受支持的数据字段子集。

  示例

您发出“附近搜索”请求,例如 NearbySearch (San Francisco, 100 meters)。按 SKU 查看账单时,您的账单会显示以下 SKU:

  • 地点
  • 基本数据
  • 联系人数据
  • 环境氛围数据
  价格 价格表(全球)
价格表(印度)

SKU:地点 - 文本搜索

  类别 Pro
  SKU ID

E95A-86C7-7F47(全球)

102E-888D-5596(印度)

  API 文本搜索(旧版)
  可结算事件 对文本搜索(旧版)的成功请求
  触发器

“文本搜索”请求会返回地点列表,但不支持指定返回哪些字段。“文本搜索”请求会返回受支持的数据字段子集。您需要为“文本搜索”请求以及所有数据类型的 SKU(基本数据、联系人数据和氛围数据)付费。

SKU:地点 - 文本搜索也会由 Maps JavaScript API 地点搜索框 widget 触发:用户选择地点查询(图标:放大镜)而不是结果(图标:图钉)后调用的 getPlaces() 方法,如下所示:

地点详情搜索框微件查询选择
在搜索框 widget 的结果中可以看到,在搜索框中输入“pizza”后,“pizza delivery”前带有放大镜图标,这表示它属于地点查询(而非结果)。
  示例

如果您发出文本搜索(旧版)请求,按 SKU 查看账单时,账单中会显示以下 SKU:

  • 地点 - 文本搜索
  • 基本数据
  • 联系人数据
  • 环境氛围数据
  价格 价格表(全球)
价格表(印度)

SKU:地点详情

  类别 Pro
  SKU ID

FC5C-DF28-543F(全球)

F7AA-FEF9-C90E(印度)

  API 地点详情(旧版)
  可结算事件 Pro 版功能申请成功
  触发器

使用网络 API 和服务时,无论您是否提供会话令牌,都会收取“地点详情”SKU 费用。

  示例
  1. 发出以下某项调用或请求:
    • 移动设备:在 Android 上调用 fetchPlace(),或在 iOS 上调用 fetchPlaceFromPlaceID:,且仅指定 ADDRESS 字段
    • 网络 API 或服务:发出“地点详情(旧版)”请求,且仅指定“地址”字段:getPlaceDetails(fields: formatted_address)
    您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
    • 地点详情
    • 基本数据
  2. 发出以下某项调用或请求:
    • 移动设备:在 Android 上调用 fetchPlace(),或在 iOS 上调用 fetchPlaceFromPlaceID:,且仅指定 PHONE_NUMBER 字段
    • 网络 API 或服务:发出“地点详情(旧版)”请求并指定“电话号码”字段:getPlaceDetails(fields: formatted_phone_number)
    您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
    • 地点详情
    • 联系人数据
  3. 发出以下某项调用或请求:
    • 移动设备:在 Android 上调用 fetchPlace(),或在 iOS 上调用 fetchPlaceFromPlaceID:,并指定所有字段
    • 网络 API 或服务:发出“地点详情(旧版)”请求并指定所有字段(如果您未指定任何字段,系统将默认发出此类请求):getPlaceDetails()。
    您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
    • 地点详情
    • 基本数据
    • 联系人数据
    • 环境氛围数据
  价格 价格表(全球)
价格表(印度)

[ 企业版:地点 Legacy ]

SKU:氛围数据

一种数据 SKU,用于对地点详情或查找地点请求中的氛围数据字段进行结算。

  类别 企业版
  SKU ID

D63D-5CC5-302A(全球)

0CE0-1963-137E(印度)

  API 地点详情(旧版)(包含氛围字段)
查找地点(旧版)(包含氛围字段)
  可结算事件 成功请求氛围数据字段
  触发器
  字段掩码结算示例

系统会根据字段掩码中提供的字段对您的请求进行结算。例如:

  • 如果您的字段掩码仅包含此 SKU 中的字段:系统会按此 SKU 的费率对请求计费。
  • 如果您的字段掩码包含其他 SKU 中的字段:系统会按所请求字段的最高 SKU 费率对请求进行结算。例如,如果您同时添加了 Essentials SKU 和 Enterprise SKU 中的字段,则系统会按 Enterprise SKU 费率对请求进行结算。
  价格 价格表(全球)
价格表(印度)

SKU:联系人数据

数据 SKU,用于对地点详情或查找地点请求中的联系人数据字段进行结算。

  类别 企业版
  SKU ID

F095-CD01-81B2(全球)

A03F-5079-C66C(印度)

  API 地点详情(旧版)(包含联系人字段)
查找地点(旧版)(包含联系人字段)
  可结算事件 成功请求联系人数据字段
  触发器

Android SDK 的字段

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * 用于替代 Place.Field.PHONE_NUMBER(已弃用)。
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

iOS SDK 的字段

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

Web 服务的字段

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  字段掩码结算

系统会根据字段掩码中提供的字段对您的请求进行结算。例如:

  • 如果您的字段掩码仅包含此 SKU 中的字段:系统会按此 SKU 的费率对请求计费。
  • 如果您的字段掩码包含其他 SKU 中的字段:系统会按所请求字段的最高 SKU 费率对请求进行结算。例如,如果您同时添加了 Essentials SKU 和 Enterprise SKU 中的字段,则系统会按 Enterprise SKU 费率对请求进行结算。
  价格 价格表(全球)
价格表(印度)

SKU:地点照片

  类别 企业版
  SKU ID

81E7-85D0-58A7(全球)

9F4B-2E19-1B63(印度)

  API Places Photo(旧版)
  可结算事件 成功请求照片
  触发器
  • Android:对 fetchPhoto() 的请求
  • iOS:向 loadPlacePhoto: 发出的请求
  • JavaScript:向 PlacePhoto.getUrl() 发出的加载图片像素数据的请求。
  • 网络服务:对 Places API“地点照片”服务的请求。
  价格 价格表(全球)
价格表(印度)

旧版 Routes API SKU

[ Essentials: Routes Legacy ]

SKU:路线

  类别 基本功能版
  SKU ID

28A8-3EB4-4595(全球)

4714-291C-3199(印度)

  API Maps JavaScript API 的路线服务、
Directions API(旧版)
  可结算事件 请求成功,未使用 Pro 或 Enterprise 功能
  触发器 不会触发更高费率 SKU 的查询
  价格 价格表(全球)
价格表(印度)

SKU:距离矩阵

  类别 基本功能版
  SKU ID

C1B6-FF9D-7700(全球)

558A-4F88-F361(印度)

  API Distance Matrix API(旧版)、
Maps JavaScript API 距离矩阵服务
  可结算事件 每个不包含 Pro 或 Enterprise 版功能的元素。发送至 Distance Matrix API 的每个请求都会生成元素,origins 数量与 destinations 数量的乘积便是元素数量。
  触发器 对不会触发高价 SKU 的元素的请求
  价格 价格表(全球)
价格表(印度)

[ Pro: Routes Legacy ]

SKU:高级路线

  类别 Pro
  SKU ID

9407-00C2-CF85(全球)

E27B-BD57-FD7D(印度)

  API Maps JavaScript API 的路线服务、
Directions API(旧版)
  可结算事件 使用 Pro 功能成功发出请求
  触发器
  价格 价格表(全球)
价格表(印度)

SKU:高级距离矩阵

  类别 Pro
  SKU ID

DFAE-763F-CF6E(全球)

C0F4-32AE-F6D1(印度)

  API Distance Matrix API(旧版)、
Maps JavaScript API 距离矩阵服务
  可结算事件 每个元素都返回了 Pro 功能。发送至 Distance Matrix API 的每个请求都会生成元素,origins 数量与 destinations 数量的乘积便是元素数量。
  触发器
  价格 价格表(全球)
价格表(印度)

  • API 使用情况详情概览:按基本功能版、专业版、企业版和旧版层级整理的完整 SKU 目录。
  • 地图 SKU 详情:Maps SDK for Android、Maps SDK for iOS、Maps JavaScript API、Maps Embed API、Maps Static API、街景 Static API、Elevation API、Aerial View API 和 Map Tiles API SKU。
  • 路线 SKU 详情:Routes API、Route Optimization API、Roads API 和 Navigation SDK SKU。
  • 地点(新版)SKU 详情:Places API(新版)、Places UI Kit、Places Aggregate API、Address Validation API、Geocoding API、地理定位 API、时区 API 和 Maps Grounding Lite SKU。
  • 环境 SKU 详情:Air Quality API、Pollen API、Solar API 和 Weather API SKU。
  • Google Maps Platform 价格和印度价格:每月用量层级和每次事件费率。