Places API 用量和结算

提醒：若要使用 Places API，您必须为每个项目启用结算功能，还必须在所有 API 或 SDK 请求中添加 API 密钥或 OAuth 令牌。

Places API 的结算和价格

如需了解 Google 如何计算您的结算和价格，请参阅 Google Maps Platform 价格列表或 Google Maps Platform 价格列表 - 印度。

地点（新）产品 SKU

点击信息 信息图标可查看此页面的内容目录。以下部分概述了每个 SKU 的详细信息：

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

关于字段掩码

对于“地点详情（新）”“附近搜索（新）”和“文本搜索（新）”，请使用 API 请求中的 FieldMask 标头来指定要在响应中返回的字段列表。然后，我们会按适用于您请求的最高 SKU 进行结算。这意味着，如果您同时选择了“基本功能版”SKU 和“专业版”SKU 中的字段，我们会根据“专业版”SKU 进行结算。

使用字段遮盖是一种良好的设计做法，可确保您不会请求不必要的数据，这有助于避免产生不必要的处理时间和结算费用。

“自动补全（新）”会话简介

“自动补全（新）”会话包含一个或多个“自动补全（新）”请求，以及一个“地点详情（新）”请求或一个“地址验证”请求。系统会将同一个会话令牌传递给“自动补全（新）”请求以及随后的“地点详情（新）”请求或地址验证请求。

第一个“自动补全（新）”请求发出时，会话开始。然后，当用户选择“自动补全（新）”建议中的某条后，系统会发出“地点详情（新）”请求或“地址验证”请求。如果会话被放弃（即未发出“地点详情（新）”请求或“地址验证”请求），系统会按未提供会话令牌的情况为“自动补全（新）”请求计费。

在用户选择地点（即系统发出“地点详情（新）”请求或“地址验证”请求）后，您必须使用新的会话令牌启动新会话。

注意 ：会话令牌可以在不同项目中重叠，但每个项目中的会话令牌必须是唯一的。例如，使用项目 A 的应用和使用项目 B 的应用可以使用相同的会话令牌，而使用项目 A 的多个应用无法使用相同的会话令牌。

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

SKU：自动补全请求

对于不使用会话的对 Autocomplete API 的请求，您需要支付此 SKU 的费用。如需了解如何使用会话来限制在单个自动补全会话期间计费的请求数量，请参阅会话令牌或 SKU：自动补全会话用量。

	类别	基本功能版
	可结算事件	请求
	触发器	在以下情况下，系统会触发此 SKU： 您的请求不包含会话令牌。 您的请求包含会话令牌，但您放弃了会话。 您的请求包含会话令牌，但您会在特定情况下终止会话。如需了解自动补全会话用量，请参阅会话令牌或自动补全会话用量。
	价格	主要价格表 印度价格表

SKU：自动补全会话使用情况

此 SKU 会对包含会话令牌的对 Autocomplete（新）API 的每次请求收费。

	类别	基本功能版
	可结算事件	请求
	触发器	当您向包含会话令牌的“自动补全（新）”API 发送请求时，系统会触发此 SKU。 此 SKU 可用作“自动补全（新）”请求 SKU 的封装容器，可让您限制单个自动补全会话期间计费的请求数量。如需了解自动补全会话用量，请参阅会话令牌。 注意：如果您不将会话与“自动补全（新）”搭配使用，系统会按“自动补全”请求使用 SKU：自动补全请求 对您进行计费。 如需了解详情，请参阅自动补全（新）和会话价格。
	价格	主要价格表 印度价格表

SKU：Places API 地点详情必备功能（仅限 ID）

此 SKU 用于对仅返回地点 ID 的地点详情请求进行计费。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	基本功能版
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下字段时，系统会触发此 SKU： 网络服务： attributions id name^* photos ^* name 字段包含以下形式的地点资源名称：places/PLACE_ID。使用 displayName 访问地点的文本名称。
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 地点详情必备知识

对于检索此 SKU 中字段的“地点详情”API 请求，系统会按此 SKU 进行计费。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	基本功能版
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下位置信息字段时，系统会触发此 SKU： 网络服务： addressComponents adrFormatAddress formattedAddress location plusCode shortFormattedAddress types viewport
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 地点详情 Pro

此 SKU 会按您在地点详情 Pro 请求中指定的字段收费。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	Pro
	可结算事件	使用指定字段掩码的请求。
	触发器	当您仅请求以下字段或费率较低的字段时，会触发此 SKU： 网络服务： accessibilityOptions businessStatus containingPlaces displayName googleMapsLinks^* googleMapsUri iconBackgroundColor iconMaskBaseUri primaryType primaryTypeDisplayName pureServiceAreaBusiness subDestinations utcOffsetMinutes ^* googleMapsLinks 字段处于正式发布前预览阶段，在预览期间使用不会产生费用，也就是说，结算金额为 0 美元。
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 地点详情企业版

注意：如果您从“地点详情企业版”SKU 中选择任意字段，则我们会按该费率进行结算。

此 SKU 用于按地点请求（包含企业版字段）进行结算。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下字段时，系统会触发此 SKU： 网络服务： currentOpeningHours currentSecondaryOpeningHours internationalPhoneNumber nationalPhoneNumber priceLevel priceRange rating regularOpeningHours regularSecondaryOpeningHours userRatingCount websiteUri 如果您使用请求 SKU：地点详情（基本、高级或首选）中的任意字段的地点详情调用终止“自动补全”会话，则该调用将按 SKU：地点详情（首选）进行计费。如需了解详情，请参阅 SKU：自动补全会话使用情况。
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 地点详情企业版 + 氛围

此 SKU 会针对请求指定氛围字段的对地点详情 API 的调用进行计费。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	企业
	可结算事件	请求
	触发器	当您请求以下字段时，系统会触发此 SKU： 网络服务： allowsDogs curbsidePickup delivery dineIn editorialSummary evChargeOptions fuelOptions goodForChildren goodForGroups goodForWatchingSports liveMusic menuForChildren parkingOptions paymentOptions outdoorSeating reservable restroom reviews routingSummaries^* servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine takeout ^*仅限文本搜索和附近搜索 如果“自动补全”会话因“地点详情”调用而终止，并且该调用请求了SKU：地点详情（基本、高级或首选）中的任意字段，则该调用将按 SKU：地点详情（首选）进行计费。如需了解详情，请参阅 SKU：自动补全会话使用情况。
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 附近搜索 Pro

此 SKU 按您在附近搜索 Pro 请求中指定的字段进行计费。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	Pro
	可结算事件	使用指定字段掩码的请求。
	触发器	当您仅请求以下字段或费率较低的字段时，会触发此 SKU： 网络服务： places.accessibilityOptions places.addressComponents places.adrFormatAddress places.attributions places.businessStatus places.containingPlaces places.displayName places.formattedAddress places.googleMapsLinks^* places.googleMapsUri places.iconBackgroundColor places.iconMaskBaseUri places.id places.location places.name^** places.photos places.plusCode places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.types places.utcOffsetMinutes places.viewport ^* places.googleMapsLinks 字段处于正式发布前预览阶段，在预览期间使用不收费，即结算金额为 0 美元。 ^** places.name 字段包含地点资源名称，格式为：places/PLACE_ID。使用 places.displayName 访问地点的文本名称。
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 附近搜索企业版

此 SKU 适用于包含任何企业版字段的附近搜索请求。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下字段时，系统会触发此 SKU： 网络服务： places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 附近搜索企业版 + 氛围

此 SKU 针对包含指定 atmostphere 字段的附近搜索请求进行计费。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	企业
	可结算事件	请求
	触发器	当您请求以下字段时，系统会触发此 SKU： 网络服务： places.allowsDogs places.curbsidePickup places.delivery places.dineIn places.editorialSummary places.evChargeOptions places.fuelOptions places.goodForChildren places.goodForGroups places.goodForWatchingSports places.liveMusic places.menuForChildren places.parkingOptions places.paymentOptions places.outdoorSeating places.reservable places.restroom places.reviews places.routingSummaries^* places.servesBeer places.servesBreakfast places.servesBrunch places.servesCocktails places.servesCoffee places.servesDessert places.servesDinner places.servesLunch places.servesVegetarianFood places.servesWine places.takeout ^*仅限文本搜索和附近搜索
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 文本搜索必备功能（仅 ID）

您需要为仅返回 ID 的 Text Search API 请求支付此 SKU 费用。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	基本功能版
	可结算事件	使用指定字段掩码的请求。
	触发器	当您仅请求以下字段时，会触发此 SKU： 网络服务： places.attributions places.id places.name^* nextPageToken ^* places.name 字段包含以下形式的地点资源名称：places/PLACE_ID。使用 places.displayName 访问地点的文本名称。
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 文本搜索 Pro

此 SKU 属于数据 SKU，系统会根据您在文本搜索 Pro 请求中指定的字段来计算费用。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	Pro
	可结算事件	使用指定字段掩码的请求。
	触发器	当您仅请求以下字段或费率较低的字段时，会触发此 SKU： 网络服务： places.accessibilityOptions places.addressComponents places.adrFormatAddress places.businessStatus places.containingPlaces places.displayName places.formattedAddress places.googleMapsLinks^* places.googleMapsUri places.iconBackgroundColor places.iconMaskBaseUri places.location places.photos places.plusCode places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.types places.utcOffsetMinutes places.viewport ^* places.googleMapsLinks 字段处于正式发布前预览阶段，在预览期间使用不会产生费用，也就是说，结算金额为 0 美元。
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 文本搜索企业版

此 SKU 适用于包含任何企业版字段的文本搜索请求。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下字段时，系统会触发此 SKU： 网络服务： places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 文本搜索企业版 + 氛围

系统会针对包含任何大气字段的文本搜索请求对此 SKU 进行计费。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

	类别	企业
	可结算事件	请求
	触发器	当您请求以下字段时，系统会触发此 SKU： 网络服务： places.allowsDogs places.curbsidePickup places.delivery places.dineIn places.editorialSummary places.evChargeOptions places.fuelOptions places.goodForChildren places.goodForGroups places.goodForWatchingSports places.liveMusic places.menuForChildren places.parkingOptions places.paymentOptions places.outdoorSeating places.reservable places.restroom places.reviews places.routingSummaries^* places.servesBeer places.servesBreakfast places.servesBrunch places.servesCocktails places.servesCoffee places.servesDessert places.servesDinner places.servesLunch places.servesVegetarianFood places.servesWine places.takeout ^*仅限文本搜索和附近搜索
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：地点详情照片

此 SKU 用于针对地点详情照片请求进行结算。

	类别	企业
	可结算事件	请求
	触发器	当您向地点详情 API 请求照片时，系统会触发结算。
	价格	主要价格表 印度价格表

旧版地点产品 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 请求指定要返回的数据字段：

• 地点详情 Pro
• 查找地点

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

• 地点 - 附近搜索
• 地点 - 文本搜索

SKU：基本数据

此 SKU 属于数据 SKU，用于对“地点详情”或“查找地点”请求中的基本数据字段进行计费。对于触发此 SKU 的请求，除了基本 SKU 费用之外，您还需要支付此 SKU 的费用。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

基本类别中的字段的费用包含在地点请求的基本费用中，它们不会产生任何额外费用。

	类别	基本功能版
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下任一字段时，系统会触发基本数据 SKU： Android： Place.Field.ACCESSIBILITY_OPTIONS Place.Field.ADDRESS_COMPONENTS Place.Field.BUSINESS_STATUS Place.Field.DISPLAY_NAME Place.Field.FORMATTED_ADDRESS Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL Place.Field.ID Place.Field.LOCATION Place.Field.PHOTO_METADATAS Place.Field.PLUS_CODE Place.Field.TYPES Place.Field.VIEWPORT Place.Field.UTC_OFFSET。 已废弃的字段：Places SDK for Android 4.0 版本已废弃以下字段：Place.Field.ADDRESS、Place.Field.ICON_URL、Place.Field.LAT_LNG、Place.Field.NAME 和 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE。请改用 Place.Field.FORMATTED_ADDRESS、Place.Field.ICON_MASK_URL、Place.Field.LOCATION、Place.Field.DISPLAY_NAME 和 Place.ACCESSIBILITY_OPTIONS。Place.Field.ACCESSIBILITY_OPTIONS 仅适用于“地点详情（新）”。 iOS： GMSPlaceFieldFormattedAddress GMSPlaceFieldBusinessStatus GMSPlaceFieldID GMSPlaceFieldCoordinate GMSPlaceFieldName GMSPlaceFieldPhotos GMSPlaceFieldPlusCode GMSPlaceFieldTypes GMSPlaceFieldViewport 网络服务： 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 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：联系人数据

此 SKU 属于数据 SKU，用于针对“地点详情”或“查找地点”请求中的联系人数据字段进行结算。对于触发此 SKU 的请求，除了基本 SKU 费用之外，您还需要支付此 SKU 的费用。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

在“地点详情”请求或“查找地点”请求中使用 fields 参数时（对于网络服务），或使用 Place.Field 数组时（对于 Android 或 iOS），您可以将响应限制为仅包含指定的字段。联系人类别中的字段会产生额外费用。

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	系统会在收到以下任一字段请求时触发联系人数据 SKU： Android： Place.Field.CURRENT_OPENING_HOURS、Place.Field.INTERNATIONAL_PHONE_NUMBER、Place.Field.OPENING_HOURS、Place.Field.SECONDARY_OPENING_HOURS 或 Place.Field.WEBSITE_URI 已废弃的字段：Place.Field.PHONE_NUMBER 字段已在 Places SDK for Android 4.0 版中废弃。请改用 Place.Field.INTERNATIONAL_PHONE_NUMBER。 iOS：GMSPlaceFieldOpeningHours、GMSPlaceFieldPhoneNumber 或 GMSPlaceFieldWebsite 网络服务：formatted_phone_number、international_phone_number、opening_hours、current_opening_hours、secondary_opening_hours 或 website
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：氛围数据

对于向 Atmosphere Data API 发出并指定此 SKU 中字段的请求，您需要支付此 SKU 的费用。

注意：此 API 会针对不同的字段对不同的 SKU 进行计费。使用字段掩码、字段列表或字段数组（对于 Android 或 iOS）在请求中指定所需的字段。如果您包含价格较高的 SKU 中的任何字段，则系统会按较高的费率对您的请求进行结算。系统只会针对每个请求中的一件 SKU 收费。

注意：此 SKU 属于数据 SKU，因此除了基本 SKU 费用之外，您还需要支付这些字段的费用。

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下任一字段时，系统就会触发结算： AndroidiOSJavaScript 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 已废弃的字段：Place.Field.USER_RATINGS_TOTAL 字段已在 Places SDK for Android 4.0 版中废弃。请改用 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 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

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

此 SKU 用于结算不包含会话令牌的请求

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

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

	类别	基本功能版
	可结算事件	请求
	触发器	系统会针对以下情况触发结算： Android： findAutocompletePredictions() iOS： findAutocompletePredictionsFromQuery: JavaScript： Maps JavaScript API 的地点自动补全服务 网络服务： Places API 的“地点自动补全”服务
	价格	主要价格表 印度价格表

SKU：自动补全（不含地点详情）- 按会话结算

此 SKU 适用于不包含“地点详情”请求的自动补全会话（在会话开始的几分钟内）。

	类别	Pro
	可结算事件	会话
	触发器	如果您的应用在单次会话中发出以下两个请求，系统就会触发结算： Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... 网络服务 “地点自动补全”请求 (input="par", session_token: XYZ) “地点自动补全”请求 (input="paris", session_token: XYZ) 按 SKU 查看账单时，您会看到账单中列出了以下 SKU： 自动补全（不含地点详情）- 按会话结算
	价格	主要价格表 印度价格表

SKU：自动补全（包含地点详情）- 按会话结算

注意：您可以在结算报告中看到此 SKU，但不会在 Google Cloud 控制台的“结算”>“价格”页面上看到。

您无需为“自动补全”请求付费。当您请求后续地点详情时，系统会按常规的地点详情定价对此 SKU 进行计费。

	类别	基本功能版
	可结算事件	会话
	触发器	您需要为包含以下任何一项的“自动补全”会话支付自动补全（包含地点详情）- 按会话结算 SKU 的费用： Android：对 fetchPlace() 的调用 iOS：对 fetchPlaceFromPlaceID: 的调用 网络服务：“地点详情”请求 “地点详情”请求会生成数据 SKU（基本数据、联系人数据和/或氛围数据），具体取决于您在请求中指定的字段。 如果您未在“地点详情”请求中请求特定字段，系统会触发所有数据 SKU（基本版、专业版、企业版和企业版 + 氛围数据）。请仅指定您需要的字段，以免产生不必要的费用。 如果您在“自动补全”会话期间仅请求刷新地点详情 ID（您的请求仅指定 place_id 字段），系统会按 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 字段） 网络服务 网络服务 “地点自动补全”请求 (input="par", session_token: XYZ) “地点自动补全”请求 (input="paris", session_token: XYZ) 地点详情 (place_id, session_token: XYZ, fields:formatted_address) 您会看到账单中列出了以下 SKU（按 SKU 查看账单时）： 自动补全（包含地点详情）- 按会话结算 地点详情 基本数据
	价格	主要价格表 印度价格表

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

此旧版 SKU 用于按查询自动补全请求计费。

	类别	基本功能版
	可结算事件	请求
	触发器	当您使用以下服务发出查询自动补全请求时，系统会触发此 SKU： JavaScript： Maps JavaScript API 的地点自动补全服务 (getQueryPredictions())，以及对 Maps JavaScript API 的搜索框 widget 的使用（“查询自动补全”请求在用户输入内容时生成）。 网络服务： Places API 的“查询自动补全”服务 使用“查询自动补全”时，不支持按“自动补全”会话定价。随后的“地点详情”请求需按“地点详情 Pro”SKU支付费用。
	价格	主要价格表 印度价格表

SKU：地点详情 Pro

此 SKU 用于按旧版地点详情请求计费。

	类别	Pro
	可结算事件	请求
	触发器	系统会针对以下 API 发出的请求触发结算： Android：Places SDK for Android (fetchPlace()) iOS：Places SDK for iOS (fetchPlaceFromPlaceID:) JavaScript： Maps JavaScript API 地点详情服务 (getDetails) JavaScript： Maps JavaScript API 地点自动补全 widget (getPlace) JavaScript： Maps JavaScript API 地点搜索框 widget：用户选择地点结果（图标：图钉）而*非* 查询（图标：放大镜）后调用的 getPlaces() 方法，如下所示： 在搜索框 widget 的结果中可以看到，在搜索框中输入“pizza”后，“Pizza Autentico”前带有图钉图标，这表示它属于地点结果（而非查询）。 网络服务： Places API 的“地点详情”服务 使用网络 API 和服务时，无论您是否提供会话令牌，都会收取“地点详情”SKU 费用。 此 SKU 还会触发数据 SKU 的计费：如果您在请求中添加数据字段，系统可能会针对数据 SKU（基本数据、联系人数据和氛围数据）触发额外的计费。 请仅指定您需要的数据字段，以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。
	示例	发出以下某项调用或请求： 移动设备：在 Android 上调用 fetchPlace()，或在 iOS 上调用 fetchPlaceFromPlaceID:，且仅指定 ADDRESS 字段 网络 API 或服务：发出“地点详情”请求，且仅指定“地址”字段：getPlaceDetails(fields: formatted_address) 您会看到账单中列出了以下 SKU（按 SKU 查看账单时）： 地点详情 基本数据 发出以下某项调用或请求： 移动设备：在 Android 上调用 fetchPlace()，或在 iOS 上调用 fetchPlaceFromPlaceID:，且仅指定 PHONE_NUMBER 字段 网络 API 或服务：发出“地点详情”请求并指定“电话号码”字段：getPlaceDetails(fields: formatted_phone_number) 您会看到账单中列出了以下 SKU（按 SKU 查看账单时）： 地点详情 联系人数据 发出以下某项调用或请求： 移动设备：在 Android 上调用 fetchPlace()，或在 iOS 上调用 fetchPlaceFromPlaceID:，并指定所有字段 网络 API 或服务：发出“地点详情”请求并指定所有字段（如果您未指定任何字段，系统将默认发出此类请求）：getPlaceDetails()。 您会看到账单中列出了以下 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 分析用量和费用中所述。 您发出“查找地点”请求并仅指定“地址”字段：FindPlace(fields: formatted_address)。您的账单中显示了以下 SKU： 查找地点 基本数据 您发出“查找地点”请求并指定“电话号码”字段：FindPlace(fields: formatted_phone_number)。您的账单中显示了以下 SKU： 查找地点 联系人数据 您发出“查找地点”请求并指定所有三个数据类型范畴的字段：FindPlace(fields: formatted_address, opening_hours, price_level)。您的账单中显示了以下 SKU： 查找地点 基本数据 联系人数据 环境氛围数据
	价格	主要价格表 印度价格表

SKU：查找地点 - 仅返回 ID

此 SKU 适用于仅返回地点 ID 的“查找地点”请求。默认情况下，如果您未在“查找地点”请求中指定任何字段，则系统仅会返回地点 ID。

	类别	基本功能版
	可结算事件	请求
	触发器	您发出“查找地点”请求，但未指定任何字段，或者仅指定 place_id 字段：FindPlace(fields: place_id)。
	价格	主要价格表 印度价格表

SKU：地点 - 附近搜索

此 SKU 用于按“附近搜索”请求进行结算。

	类别	Pro
	可结算事件	请求
	触发器	当您使用以下任一 API 发出附近搜索请求时，系统会触发此 SKU： Maps JavaScript API 地点附近搜索服务 (nearbySearch()) Places API 的“附近搜索”服务 此请求不支持指定要返回的字段。响应会返回地点列表和受支持的数据字段子集。 此 SKU 还会触发数据 SKU 的计费：如果您在请求中添加数据字段，系统可能会针对数据 SKU（基本数据、联系人数据和氛围数据）触发额外的计费。 请仅指定您需要的数据字段，以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。
	示例	您发出“附近搜索”请求，例如 NearbySearch (San Francisco, 100 meters)。按 SKU 查看账单时，您的账单会显示以下 SKU： 地点 基本数据 联系人数据 环境氛围数据
	价格	主要价格表 印度价格表

SKU：地点 - 文本搜索

对于对地点文本搜索服务的请求，系统会按此 SKU 进行计费。

	类别	Pro
	可结算事件	请求
	触发器	系统会针对对以下服务的请求触发结算： Maps JavaScript API 地点文本搜索服务 (textSearch())。 Places API 文本搜索服务 “文本搜索”请求会返回地点列表，但不支持指定返回哪些字段。“文本搜索”请求会返回受支持的数据字段子集。您需要为“文本搜索”请求以及所有数据类型的 SKU（基本数据、联系人数据和氛围数据）付费。 “地点 - 文本搜索”SKU 也由 Maps JavaScript API 的地点搜索框 widget 触发：用户选择地点查询（图标：放大镜）而不是结果（图标：图钉）后调用的 getPlaces() 方法，如下所示： 在搜索框 widget 的结果中可以看到，在搜索框中输入“pizza”后，“pizza delivery”前带有放大镜图标，这表示它属于地点查询（而非结果）。
	示例	如果您发出“文本搜索”请求（例如 TextSearch(123 Main Street)），则在按 SKU 查看账单时，账单中会显示以下 SKU： 地点 - 文本搜索 基本数据 联系人数据 环境氛围数据
	价格	主要价格表 印度价格表

SKU：Places API 地点详情照片

此 SKU 用于计费旧版地点照片服务。

	类别	企业
	可结算事件	请求
	触发器	系统会针对以下情况触发结算： Android：对 fetchPhoto() 的调用 iOS：对 loadPlacePhoto: 的调用 JavaScript：从 PlacePhoto.getUrl() 返回的网址中请求数据以加载图片像素数据时，对于向 Maps JavaScript API 地点库的“地点照片”服务发出的请求，您需要支付相应费用。只有在将网址实际用于获取像素数据时，才会触发结算。 网络服务：对 Places API 的“地点照片”服务的请求
	价格	主要价格表 印度价格表

其他用量限制

虽然每天的请求数量没有上限，但仍需遵守以下用量限制：

• Places API（新版）：每个项目的每个 API 方法的速率限制为 600 QPM（每分钟请求数）。也就是说，每个 API 方法都有单独的配额。

• Places API：速率限制为 6,000 QPM（每分钟请求数）。其计算方法为使用同一项目凭据的所有应用的客户端请求和服务器端请求的总和。

使用条款限制

如需了解使用条款，请参阅 Places API 政策以及 Google Maps Platform 服务条款的“许可限制”部分。

---