Maps JavaScript API 的结算和定价
如需了解 Google 如何计算您的结算和价格,请参阅 Google Maps Platform 价格列表或 Google Maps Platform 价格列表 - 印度。
SKU:动态地图
此 SKU 会按应用显示地图时地图加载次数进行计费。
类别 | 基本功能版 | |
可结算事件 | 地图加载 | |
触发器 | 当应用以以下任一方式显示已加载的地图时,此 SKU 会按地图加载次数计费:
用户与地图互动(例如平移、缩放或切换地图图层)时不会产生额外的地图加载。 |
|
价格 | 主要价格表 印度价格表 |
SKU:动态街景
此 SKU 适用于向 Street View Static API 发出并返回动态街景全景图片的请求。
类别 | Pro | |
可结算事件 | 全景 | |
触发器 | 当您使用以下某个类或方法实例化全景图片对象时,系统会触发此 SKU:
|
|
价格 | 主要价格表 印度价格表 |
Maps JavaScript API 地点库的定价
SKU:自动补全请求
对于不使用会话的对 Autocomplete API 的请求,您需要支付此 SKU 的费用。如需了解如何使用会话来限制在单个自动补全会话期间计费的请求数量,请参阅会话令牌或 SKU:自动补全会话用量。
SKU:自动补全会话使用情况
此 SKU 会对包含会话令牌的对 Autocomplete(新)API 的每次请求收费。
类别 | 基本功能版 | |
可结算事件 | 请求 | |
触发器 | 当您向包含会话令牌的“自动补全(新)”API 发送请求时,系统会触发此 SKU。 此 SKU 可用作“自动补全(新)”请求 SKU 的封装容器,可让您限制单个自动补全会话期间计费的请求数量。如需了解自动补全会话用量,请参阅会话令牌。 注意:如果您不将会话与“自动补全(新)”搭配使用,系统会按“自动补全”请求使用 SKU:自动补全请求 对您进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 地点详情必备功能(仅限 ID)
此 SKU 用于对仅返回地点 ID 的地点详情请求进行计费。
类别 | 基本功能版 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 | 当您请求以下字段时,系统会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 地点详情必备知识
对于检索此 SKU 中字段的“地点详情”API 请求,系统会按此 SKU 进行计费。类别 | 基本功能版 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 | 当您请求以下位置信息字段时,系统会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 地点详情 Pro
此 SKU 会按您在地点详情 Pro 请求中指定的字段收费。
类别 | Pro | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 |
当您仅请求以下字段或费率较低的字段时,会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 地点详情企业版
此 SKU 用于按地点请求(包含企业版字段)进行结算。
类别 | 企业 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 | 当您请求以下字段时,系统会触发此 SKU:
如果您使用请求 SKU:地点详情(基本、高级或首选)中的任意字段的地点详情调用终止“自动补全”会话,则该调用将按 SKU:地点详情(首选)进行计费。如需了解详情,请参阅 SKU:自动补全会话使用情况。 |
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 地点详情企业版 + 氛围
此 SKU 会针对请求指定氛围字段的对地点详情 API 的调用进行计费。
类别 | 企业 | |
可结算事件 | 请求 | |
触发器 | 当您请求以下字段时,系统会触发此 SKU:
如果“自动补全”会话因“地点详情”调用而终止,并且该调用请求了SKU:地点详情(基本、高级或首选)中的任意字段,则该调用将按 SKU:地点详情(首选)进行计费。如需了解详情,请参阅 SKU:自动补全会话使用情况。 |
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 附近搜索 Pro
此 SKU 按您在附近搜索 Pro 请求中指定的字段进行计费。
类别 | Pro | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 |
当您仅请求以下字段或费率较低的字段时,会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 附近搜索企业版
此 SKU 适用于包含任何企业版字段的附近搜索请求。
类别 | 企业 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 |
当您请求以下字段时,系统会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 |
主要价格表 印度价格表 |
SKU:Places API 附近搜索企业版 + 氛围
此 SKU 针对包含指定 atmostphere 字段的附近搜索请求进行计费。
类别 | 企业 | |
可结算事件 | 请求 | |
触发器 | 当您请求以下字段时,系统会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 文本搜索必备功能(仅 ID)
您需要为仅返回 ID 的 Text Search API 请求支付此 SKU 费用。类别 | 基本功能版 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 | 当您仅请求以下字段时,会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 文本搜索 Pro
此 SKU 属于数据 SKU,系统会根据您在文本搜索 Pro 请求中指定的字段来计算费用。类别 | Pro | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 |
当您仅请求以下字段或费率较低的字段时,会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 文本搜索企业版
此 SKU 适用于包含任何企业版字段的文本搜索请求。
类别 | 企业 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 | 当您请求以下字段时,系统会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:Places API 文本搜索企业版 + 氛围
系统会针对包含任何大气字段的文本搜索请求对此 SKU 进行计费。
类别 | 企业 | |
可结算事件 | 请求 | |
触发器 | 当您请求以下字段时,系统会触发此 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:地点详情照片
此 SKU 用于针对地点详情照片请求进行结算。
关于“自动补全”会话
“自动补全”会话包含一些“自动补全”请求(用于在用户输入内容时检索建议地点),以及最多一个“地点详情”请求(用于检索与用户所选的地点有关的详细信息)。系统会将同一个会话令牌传递给“自动补全”请求和随后的“地点详情”请求。第一个“自动补全”请求发出时(通常是在用户开始输入时),会话开始。在用户选择其中一条“自动补全”建议后,系统会执行“地点详情”调用。如果用户未选择建议,系统不会执行“地点详情”调用。
在用户选择地点(即系统执行“地点详情”调用)后,您必须使用新的会话令牌启动新会话。
“自动补全”会话可以通过以下 API 生成:
- Places API 的“地点自动补全”服务或 Maps JavaScript API 的“地点自动补全”服务。您需要将应用设计为提供会话令牌(您可能需要更改现有代码)。
- Maps JavaScript API 的“自动补全”widget。系统会自动为这些 widget 启用基于会话的结算方式,您无需更改任何代码。
会话令牌非常适合单个用户会话,但不能用于多个用户会话。如果您重复使用某个会话令牌,相应会话会被视为无效,并且系统会按未提供会话令牌的情况为请求计费。
使用会话的“自动补全”请求和“地点详情”请求以不同的 SKU 计费。
关于地点数据 SKU
三个地点数据 SKU 包括:基本数据、联系人数据和氛围数据。系统会针对以下情况触发一个或多个数据 SKU:
- Android:对
fetchPlace()
或findCurrentPlace()
的每次请求 - iOS:对
fetchPlaceFromPlaceID:
或findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
的每次调用 - 网络服务:每个地点请求,具体取决于请求中指定的字段
对于触发数据 SKU 的请求,除了基本 SKU 费用之外,您还始终需要支付相应的数据 SKU 费用。例如,对于包含“基本数据”字段的“地点详情”请求,您需要同时支付“基本数据”SKU 费用和“地点详情”SKU 费用。
对于 Web 服务,您可以通过以下 Places API 请求指定要返回的数据字段:
对于 Web 服务,以下 Places API 调用不支持指定返回的字段。这些调用始终会返回所有地点数据,您除了支付每个 API 请求的费用外,还需支付三个地点数据 SKU 的费用:
SKU:基本数据
此 SKU 属于数据 SKU,用于对“地点详情”或“查找地点”请求中的基本数据字段进行计费。对于触发此 SKU 的请求,除了基本 SKU 费用之外,您还需要支付此 SKU 的费用。
基本类别中的字段的费用包含在地点请求的基本费用中,它们不会产生任何额外费用。
类别 | 基本功能版 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 | 当您请求以下任一字段时,系统会触发基本数据 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:联系人数据
此 SKU 属于数据 SKU,用于针对“地点详情”或“查找地点”请求中的联系人数据字段进行结算。对于触发此 SKU 的请求,除了基本 SKU 费用之外,您还需要支付此 SKU 的费用。在“地点详情”请求或“查找地点”请求中使用 fields 参数时(对于网络服务),或使用 Place.Field
数组时(对于 Android 或 iOS),您可以将响应限制为仅包含指定的字段。联系人类别中的字段会产生额外费用。
类别 | 企业 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 | 系统会在收到以下任一字段请求时触发联系人数据 SKU:
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:氛围数据
对于向 Atmosphere Data API 发出并指定此 SKU 中字段的请求,您需要支付此 SKU 的费用。
类别 | 企业 | |
可结算事件 | 使用指定字段掩码的请求。 | |
触发器 | 当您请求以下任一字段时,系统就会触发结算:
Place.Field.CURBSIDE_PICKUP Place.Field.DELIVERY Place.Field.EDITORIAL_SUMMARY Place.Field.DINE_IN Place.Field.PRICE_LEVEL Place.Field.RATING Place.Field.RESERVABLE Place.Field.SERVES_BEER Place.Field.SERVES_BREAKFAST Place.Field.SERVES_BRUNCH Place.Field.SERVES_DINNER Place.Field.SERVES_LUNCH Place.Field.SERVES_VEGETARIAN_FOOD Place.Field.SERVES_WINE Place.Field.TAKEOUT Place.Field.USER_RATING_COUNT
GMSPlaceFieldPriceLevel GMSPlaceFieldRating GMSPlaceFieldUserRatingsTotal GMSPlaceFieldTakeout GMSPlaceFieldDelivery GMSPlaceFieldDineIn GMSPlaceFieldCurbsidePickup GMSPlaceFieldReservable GMSPlaceFieldServesBreakfast GMSPlaceFieldServesLunch GMSPlaceFieldServesDinner GMSPlaceFieldServesBeer GMSPlaceFieldServesWine GMSPlaceFieldServesBrunch GMSPlaceFieldServesVegetarianFood 。
curbside_pickup delivery dine_in ,
editorial_summary price_level rating reservable reviews serves_beer serves_breakfast serves_brunch serves_dinner serves_lunch ,serves_vegetarian_food serves_wine takeout user_ratings_total 。
|
|
字段遮罩结算示例 |
以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。
|
|
价格 | 主要价格表 印度价格表 |
SKU:自动补全 - 按请求结算
此 SKU 用于结算不包含会话令牌的请求
如果您从无效的“自动补全”会话(例如重复使用会话令牌的会话)发出请求,系统也会收取“自动补全 - 按请求结算”SKU 费用。
如果您从无效的“自动补全”会话发出请求,来自 Maps JavaScript API 的地点自动补全 widget 的“自动补全”请求可能会被收取“自动补全 - 按请求结算”SKU 费用。当用户输入多个不同的地址或将不同的地址复制/粘贴到该 widget 中,且并不总是选择自动补全联想查询时,可能会发生这种情况。
类别 | 基本功能版 | |
可结算事件 | 请求 | |
触发器 | 系统会针对以下情况触发结算:
|
|
价格 | 主要价格表 印度价格表 |
SKU:自动补全(不含地点详情)- 按会话结算
此 SKU 适用于不包含“地点详情”请求的自动补全会话(在会话开始的几分钟内)。
类别 | Pro | |
可结算事件 | 会话 | |
触发器 |
如果您的应用在单次会话中发出以下两个请求,系统就会触发结算:
按 SKU 查看账单时,您会看到账单中列出了以下 SKU:
|
|
价格 |
主要价格表 印度价格表 |
SKU:自动补全(包含地点详情)- 按会话结算
您无需为“自动补全”请求付费。当您请求后续地点详情时,系统会按常规的地点详情定价对此 SKU 进行计费。
类别 | 基本功能版 | |
可结算事件 | 会话 | |
触发器 | 您需要为包含以下任何一项的“自动补全”会话支付自动补全(包含地点详情)- 按会话结算 SKU 的费用:
“地点详情”请求会生成数据 SKU(基本数据、联系人数据和/或氛围数据),具体取决于您在请求中指定的字段。 如果您未在“地点详情”请求中请求特定字段,系统会触发所有数据 SKU(基本版、专业版、企业版和企业版 + 氛围数据)。请仅指定您需要的字段,以免产生不必要的费用。 如果您在“自动补全”会话期间仅请求刷新地点详情 ID(您的请求仅指定 |
|
示例 | 如果您的应用在单次会话中发出以下三个调用:
网络服务
您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
|
|
价格 | 主要价格表 印度价格表 |
SKU:查询自动补全 - 按请求结算
此旧版 SKU 用于按查询自动补全请求计费。
类别 | 基本功能版 | |
可结算事件 | 请求 | |
触发器 |
当您使用以下服务发出查询自动补全请求时,系统会触发此 SKU:
使用“查询自动补全”时,不支持按“自动补全”会话定价。随后的“地点详情”请求需按“地点详情 Pro”SKU支付费用。 |
|
价格 |
主要价格表 印度价格表 |
SKU:地点详情 Pro
此 SKU 用于按旧版地点详情请求计费。
类别 | Pro | |
可结算事件 | 请求 | |
触发器 |
系统会针对以下 API 发出的请求触发结算:
使用网络 API 和服务时,无论您是否提供会话令牌,都会收取“地点详情”SKU 费用。 此 SKU 还会触发数据 SKU 的计费:如果您在请求中添加数据字段,系统可能会针对数据 SKU(基本数据、联系人数据和氛围数据)触发额外的计费。 请仅指定您需要的数据字段,以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。 |
|
示例 |
|
|
价格 |
主要价格表 印度价格表 |
SKU:地点详情 - ID 刷新
对于向地点详情 API 发出用于 刷新过时的地点 ID 的请求,您需要支付此 SKU 的费用。
类别 | 基本功能版 | |
可结算事件 | 请求 | |
触发器 | 当您发出仅指定“地点 ID”字段的“地点详情”请求时,系统会触发结算:getPlaceDetails(fields: place_id) 。
|
|
价格 | 主要价格表 印度价格表 |
SKU:查找地点
对于返回地点 ID 以外的其他字段的“查找地点”请求,系统会按此 SKU 进行计费。
此 SKU 还会触发数据 SKU 的计费:如果您在请求中添加数据字段,系统可能会针对数据 SKU(基本数据、联系人数据和氛围数据)触发额外的计费。 请仅指定您需要的数据字段,以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。
类别 | Pro | |
可结算事件 | 请求 | |
触发器 | 此 SKU 会对以下方法的请求进行计费:
此 SKU 还会触发数据 SKU 的计费:如果您在请求中添加数据字段,系统可能会针对数据 SKU(基本数据、联系人数据和氛围数据)触发额外的计费。 请仅指定您需要的数据字段,以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。 |
|
示例 | 以下示例展示了在发出“查找当前地点”请求并指定基本数据、联系人数据和氛围数据 SKU 中的字段时,系统会按哪些 SKU 向您收费。如需查看账单中的 SKU,请按 SKU 查看账单,如按 SKU 分析用量和费用中所述。
|
|
价格 | 主要价格表 印度价格表 |
SKU:查找地点 - 仅返回 ID
此 SKU 适用于仅返回地点 ID 的“查找地点”请求。默认情况下,如果您未在“查找地点”请求中指定任何字段,则系统仅会返回地点 ID。
类别 | 基本功能版 | |
可结算事件 | 请求 | |
触发器 | 您发出“查找地点”请求,但未指定任何字段,或者仅指定 place_id 字段:FindPlace(fields: place_id) 。
|
|
价格 | 主要价格表 印度价格表 |
SKU:地点 - 附近搜索
此 SKU 用于按“附近搜索”请求进行结算。
类别 | Pro | |
可结算事件 | 请求 | |
触发器 |
当您使用以下任一 API 发出附近搜索请求时,系统会触发此 SKU:
此请求不支持指定要返回的字段。响应会返回地点列表和受支持的数据字段子集。 此 SKU 还会触发数据 SKU 的计费:如果您在请求中添加数据字段,系统可能会针对数据 SKU(基本数据、联系人数据和氛围数据)触发额外的计费。 请仅指定您需要的数据字段,以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。 |
|
示例 |
您发出“附近搜索”请求,例如
|
|
价格 |
主要价格表 印度价格表 |
SKU:地点 - 文本搜索
对于对地点文本搜索服务的请求,系统会按此 SKU 进行计费。
类别 | Pro | |
可结算事件 | 请求 | |
触发器 |
系统会针对对以下服务的请求触发结算:
“文本搜索”请求会返回地点列表,但不支持指定返回哪些字段。“文本搜索”请求会返回受支持的数据字段子集。您需要为“文本搜索”请求以及所有数据类型的 SKU(基本数据、联系人数据和氛围数据)付费。
“地点 - 文本搜索”SKU 也由
Maps JavaScript API 的地点搜索框 widget 触发:用户选择地点查询(图标:放大镜)而不是结果(图标:图钉)后调用的 ![]() |
|
示例 |
如果您发出“文本搜索”请求(例如
|
|
价格 |
主要价格表 印度价格表 |
SKU:Places API 地点详情照片
此 SKU 用于计费旧版地点照片服务。
类别 | 企业 | |
可结算事件 | 请求 | |
触发器 |
系统会针对以下情况触发结算:
|
|
价格 |
主要价格表 印度价格表 |
JavaScript 服务的定价
JavaScript 服务是单独定价的。如需了解详情,请参阅服务的用量和结算页面:
- 路线服务 - Directions API 用量和结算
- 距离矩阵服务 - 距离矩阵 API 用量和结算
- 海拔服务 - Elevation API 用量和结算
- 地理编码服务 - Geocoding API 用量和结算
- 街景服务 - Street View API 用量和结算
其他用量限制
虽然每天的请求数量没有上限,但 Maps JavaScript API 存在以下用量限额:
- 30,000 QPM(每分钟请求数)
- 每个 IP 地址 300 QPM(每分钟请求数)。在 Google Cloud 控制台中,此配额称为 Map loads per minute per user(每用户每分钟地图加载次数)。
Maps JavaScript 中的仿真 3D 地图用量限制
Maps JavaScript 中的仿真 3D 地图设有以下使用限制
- 100 QPM(每分钟请求数)。
- 每个 IP 地址 10 QPM(每分钟请求数)。
使用条款限制
如需了解允许用法的完整详情,请参阅 Google Maps Platform 服务条款中的“许可限制”部分。