本页面提供了旧版 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 |
|
| 可结算事件 | 会话 | |
| 触发器 |
请求中的字段: 请务必在请求中指定您需要的字段,以免产生不必要的费用。 根据您指定的字段,“地点详情”请求还会生成以下数据 SKU: 如果您未在“地点详情”请求中指定字段,系统会触发所有数据 SKU。 如果您在“自动补全”会话期间仅请求刷新地点详情 ID(您的请求仅指定 |
|
| 示例 |
自动补全请求是免费的。当您根据常规地点详情定价请求后续地点详情时,此旧版 SKU 会计费。 此示例说明了按平台划分的一系列请求,当您按 SKU 查看账单时,这些请求会在账单中生成以下 SKU:
按平台划分的请求示例: Android 请求
iOS 请求
Web 服务请求
“地点自动补全”请求 (input="par", session_token: XYZ) |
|
| 价格 |
价格表(全球) 价格表(印度) |
关于“自动补全”会话
“自动补全”会话包含一些“自动补全”请求(用于在用户输入内容时检索建议地点),以及最多一个“地点详情”请求(用于检索与用户所选的地点有关的详细信息)。系统会将同一个会话令牌传递给“自动补全”请求和随后的“地点详情”请求。第一个“自动补全”请求发出时(通常是在用户开始输入时),会话开始。在用户选择其中一条“自动补全”建议后,系统会执行“地点详情”调用。如果用户未选择建议,系统不会执行“地点详情”调用。
在用户选择地点(即系统执行“地点详情”调用)后,您必须使用新的会话令牌启动新会话。
“自动补全”会话可以通过以下 API 生成:
- Places API 的“地点自动补全”服务或 Maps JavaScript API 的“地点自动补全”服务。您需要将应用设计为提供会话令牌(您可能需要更改现有代码)。
- Maps JavaScript API 的“自动补全”widget。系统会自动为这些 widget 启用基于会话的结算方式,您无需更改任何代码。
会话令牌非常适合单个用户会话,但不能用于多个用户会话。如果您重复使用某个会话令牌,相应会话会被视为无效,并且系统会按未提供会话令牌的情况为请求计费。
使用会话的“自动补全”请求和“地点详情”请求以不同的 SKU 计费。
SKU:基本数据
数据 SKU,针对地点详情或查找地点请求中的基本数据字段进行结算。
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
75D4-C522-326B(全球) 5D7B-1F7B-395E(印度) |
|
| API |
地点详情(旧版)
(包含基本字段)
查找地点(旧版) (包含基本字段) |
|
| 可结算事件 | 成功请求基本数据字段 | |
| 触发器 |
Android SDK 的字段
适用于 iOS 的字段
Web 服务字段
|
|
| 字段掩码结算 |
系统会根据字段掩码中提供的字段对您的请求进行结算。例如:
|
|
| 价格 |
价格表(全球)
价格表(印度) |
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 查看账单。 您发出“查找当前地点”请求,且仅指定
您的账单会显示以下 SKU:
您发出“查找当前地点”请求,且仅指定
您的账单会显示以下 SKU:
您发出“查找当前地点”请求并指定所有三个数据类型字段:
您的账单会显示以下 SKU:
|
|
| 价格 |
价格表(全球)
价格表(印度) |
SKU:查找地点
| 类别 | Pro | |
|---|---|---|
| SKU ID |
DC67-3188-2294(全球) ECB4-087C-9A27(印度) |
|
| API | 查找地点(旧版) | |
| 可结算事件 | 成功请求了 ID 字段以外的其他字段 | |
| 触发器 | 查找地点请求,其中指定的字段不只是 ID 字段。 | |
| 示例 |
以下示例展示了在发出“查找当前地点”请求并指定基本数据、联系人数据和氛围数据 SKU 中的字段时,系统会向您收取哪些 SKU 的费用。如需查看账单中的 SKU,请按照按 SKU 分析用量和费用中的说明按 SKU 查看账单。 您发出仅包含
您的账单会显示以下 SKU:
您发出仅包含
您的账单会显示以下 SKU:
您发出“查找地点”请求并指定所有三个数据类型字段:
您的账单会显示以下 SKU:
|
|
| 价格 |
价格表(全球)
价格表(印度) |
SKU:地点 - 附近搜索
| 类别 | Pro | |
|---|---|---|
| SKU ID |
6B23-8A17-D29D(全球) CC66-BE0E-2477(印度) |
|
| API | 附近搜索(旧版) | |
| 可结算事件 | Pro 版功能申请成功 | |
| 触发器 |
此请求不支持指定要返回的字段。响应会返回一个地点列表和受支持的数据字段子集。 |
|
| 示例 |
您发出“附近搜索”请求,例如
|
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:地点 - 文本搜索
| 类别 | Pro | |
|---|---|---|
| SKU ID |
E95A-86C7-7F47(全球) 102E-888D-5596(印度) |
|
| API | 文本搜索(旧版) | |
| 可结算事件 | 对文本搜索(旧版)的成功请求 | |
| 触发器 |
“文本搜索”请求会返回地点列表,但不支持指定返回哪些字段。“文本搜索”请求会返回受支持的数据字段子集。您需要为“文本搜索”请求以及所有数据类型的 SKU(基本数据、联系人数据和氛围数据)付费。
SKU:地点 - 文本搜索也会由
Maps JavaScript API 地点搜索框 widget 触发:用户选择地点查询(图标:放大镜)而不是结果(图标:图钉)后调用的
|
|
| 示例 |
如果您发出文本搜索(旧版)请求,按 SKU 查看账单时,账单中会显示以下 SKU:
|
|
| 价格 |
价格表(全球)
价格表(印度) |
SKU:地点详情
| 类别 | Pro | |
|---|---|---|
| SKU ID |
FC5C-DF28-543F(全球) F7AA-FEF9-C90E(印度) |
|
| API | 地点详情(旧版) | |
| 可结算事件 | Pro 版功能申请成功 | |
| 触发器 |
使用网络 API 和服务时,无论您是否提供会话令牌,都会收取“地点详情”SKU 费用。 |
|
| 示例 |
|
|
| 价格 |
价格表(全球) 价格表(印度) |
[ 企业版:地点 Legacy ] |
|---|
SKU:氛围数据
一种数据 SKU,用于对地点详情或查找地点请求中的氛围数据字段进行结算。
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
D63D-5CC5-302A(全球) 0CE0-1963-137E(印度) |
|
| API |
地点详情(旧版)(包含氛围字段)
查找地点(旧版)(包含氛围字段) |
|
| 可结算事件 | 成功请求氛围数据字段 | |
| 触发器 | ||
| 字段掩码结算示例 |
系统会根据字段掩码中提供的字段对您的请求进行结算。例如:
|
|
| 价格 | 价格表(全球) 价格表(印度) |
SKU:联系人数据
数据 SKU,用于对地点详情或查找地点请求中的联系人数据字段进行结算。
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
F095-CD01-81B2(全球) A03F-5079-C66C(印度) |
|
| API |
地点详情(旧版)(包含联系人字段)
查找地点(旧版)(包含联系人字段) |
|
| 可结算事件 | 成功请求联系人数据字段 | |
| 触发器 |
Android SDK 的字段
iOS SDK 的字段
Web 服务的字段
|
|
| 字段掩码结算 |
系统会根据字段掩码中提供的字段对您的请求进行结算。例如:
|
|
| 价格 |
价格表(全球)
价格表(印度) |
SKU:地点照片
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
81E7-85D0-58A7(全球) 9F4B-2E19-1B63(印度) |
|
| API | Places Photo(旧版) | |
| 可结算事件 | 成功请求照片 | |
| 触发器 |
|
|
| 价格 |
价格表(全球)
价格表(印度) |
旧版 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 数量的乘积便是元素数量。 |
|
| 触发器 |
|
|
| 价格 |
价格表(全球)
价格表(印度) |
相关 SKU 详情页面
- 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 价格和印度价格:每月用量层级和每次事件费率。