Places SDK for iOS 用量和结算

提醒：如需使用 Places SDK for iOS，您必须在所有 API 请求中添加 API 密钥，并且必须为每个项目启用结算功能。

错误：kGMSPlacesRateLimitExceeded

注意：如果您的 iOS 应用遇到 kGMSPlacesRateLimitExceeded 错误，则表示您使用的可能是已弃用的 Places API 版本。 Places API 2.7.0 版本自 2019 年 1 月 29 日起已弃用，并于 2019 年 7 月 29 日停用。新版 Places API 现已发布。我们建议您尽快更新到新版本。 如需了解详情，请参阅迁移指南。

针对 Places API 的 Places SDK for iOS 请求按 SKU 结算。 点击信息 信息图标可查看此页面的内容目录。

Places SDK for iOS 的结算和价格

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

Places SDK for iOS（新）SKU 详情

关于字段掩码

在请求中使用字段掩码（也称为字段列表），以指定要在响应中返回的字段列表。然后，我们会按适用于您请求的最高 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： iOS： GMSPlacePropertyPlaceID GMSPlacePropertyPhotos
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

---

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

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

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

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

---

SKU：Places API 地点详情 Pro

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

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

	类别	Pro
	可结算事件	使用指定字段掩码的请求。
	触发器	当您仅请求以下字段或费率较低的字段时，会触发此 SKU： iOS： GMSPlacePropertyBusinessStatus GMSPlacePropertyIconBackgroundColor GMSPlacePropertyIconImageURL GMSPlacePropertyName GMSPlacePropertyUTCOffsetMinutes GMSPlacePropertyWheelchairAccessibleEntrance
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

---

SKU：Places API 地点详情企业版

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

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

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

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下字段时，系统会触发此 SKU： iOS： GMSPlacePropertyCurrentOpeningHours GMSPlacePropertySecondaryOpeningHours GMSPlacePropertyPhoneNumber GMSPlacePropertyPriceLevel GMSPlacePropertyRating GMSPlacePropertyOpeningHours GMSPlacePropertyUserRatingsTotal GMSPlacePropertyWebsite 如果您使用请求 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： iOS： GMSPlacePropertyCurbsidePickup GMSPlacePropertyDelivery GMSPlacePropertyDineIn GMSPlacePropertyEditorialSummary GMSPlacePropertyReservable GMSPlacePropertyReviews GMSPlacePropertyServesBeer GMSPlacePropertyServesBreakfast GMSPlacePropertyServesBrunch GMSPlacePropertyServesDinner GMSPlacePropertyServesLunch GMSPlacePropertyServesVegetarianFood GMSPlacePropertyServesWine GMSPlacePropertyTakeout 如果“自动补全”会话因“地点详情”调用而终止，并且该调用请求了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： iOS： GMSPlacePropertyAddressComponents GMSPlacePropertyBusinessStatus GMSPlacePropertyCoordinate GMSPlacePropertyFormattedAddress GMSPlacePropertyName GMSPlacePropertyIconBackgroundColor GMSPlacePropertyIconImageURL GMSPlacePropertyPhotos GMSPlacePropertyPlaceID GMSPlacePropertyPlusCode GMSPlacePropertyTypes GMSPlacePropertyUTCOffsetMinutes GMSPlacePropertyViewport GMSPlacePropertyWheelchairAccessibleEntrance
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

---

SKU：Places API 附近搜索企业版

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

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

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下字段时，系统会触发此 SKU： iOS： GMSPlacePropertyCurrentOpeningHours GMSPlacePropertySecondaryOpeningHours GMSPlacePropertyPhoneNumber GMSPlacePropertyPriceLevel GMSPlacePropertyRating GMSPlacePropertyOpeningHours GMSPlacePropertyUserRatingsTotal GMSPlacePropertyWebsite
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

---

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

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

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

	类别	企业
	可结算事件	请求
	触发器	当您请求以下字段时，系统会触发此 SKU： iOS： GMSPlacePropertyCurbsidePickup GMSPlacePropertyDelivery GMSPlacePropertyDineIn GMSPlacePropertyEditorialSummary GMSPlacePropertyReservable GMSPlacePropertyReviews GMSPlacePropertyServesBeer GMSPlacePropertyServesBreakfast GMSPlacePropertyServesBrunch GMSPlacePropertyServesDinner GMSPlacePropertyServesLunch GMSPlacePropertyServesVegetarianFood GMSPlacePropertyServesWine GMSPlacePropertyTakeout
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 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： iOS： GMSPlacePropertyPlaceID GMSPlacePropertyName
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 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： iOS： GMSPlacePropertyAddressComponents GMSPlacePropertyBusinessStatus GMSPlacePropertyFormattedAddress GMSPlacePropertyIconBackgroundColor GMSPlacePropertyIconImageURL GMSPlacePropertyCoordinate GMSPlacePropertyPhotos GMSPlacePropertyPlusCode GMSPlacePropertyTypes GMSPlacePropertyUTCOffsetMinutes GMSPlacePropertyViewport GMSPlacePropertyWheelchairAccessibleEntrance
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：Places API 文本搜索企业版

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

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

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下字段时，系统会触发此 SKU： iOS： GMSPlacePropertyCurrentOpeningHours GMSPlacePropertySecondaryOpeningHours GMSPlacePropertyPhoneNumber GMSPlacePropertyPriceLevel GMSPlacePropertyRating GMSPlacePropertyOpeningHours GMSPlacePropertyUserRatingsTotal GMSPlacePropertyWebsite
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

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

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

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

	类别	企业
	可结算事件	请求
	触发器	当您请求以下字段时，系统会触发此 SKU： iOS： GMSPlacePropertyCurbsidePickup GMSPlacePropertyDelivery GMSPlacePropertyDineIn GMSPlacePropertyEditorialSummary GMSPlacePropertyReservable GMSPlacePropertyReviews GMSPlacePropertyServesBeer GMSPlacePropertyServesBreakfast GMSPlacePropertyServesBrunch GMSPlacePropertyServesDinner GMSPlacePropertyServesLunch GMSPlacePropertyServesVegetarianFood GMSPlacePropertyServesWine GMSPlacePropertyTakeout
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行结算。例如，您可以请求此 SKU 中的一个或多个字段，并按此 SKU 的费率付费。 如果您的请求字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您包含多个 SKU（例如“基本”SKU 和“企业”SKU）中的字段，则系统会按“企业”SKU 的费率对该请求进行结算。
	价格	主要价格表 印度价格表

SKU：地点详情照片

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

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

---

Places SDK for iOS 旧版 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 费用。

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 费用之外，您还需要支付这些字段的费用。

	类别	企业
	可结算事件	使用指定字段掩码的请求。
	触发器	当您请求以下任一字段时，系统就会触发结算： iOS GMSPlaceFieldPriceLevel GMSPlaceFieldRating GMSPlaceFieldUserRatingsTotal GMSPlaceFieldTakeout GMSPlaceFieldDelivery GMSPlaceFieldDineIn GMSPlaceFieldCurbsidePickup GMSPlaceFieldReservable GMSPlaceFieldServesBreakfast GMSPlaceFieldServesLunch GMSPlaceFieldServesDinner GMSPlaceFieldServesBeer GMSPlaceFieldServesWine GMSPlaceFieldServesBrunch GMSPlaceFieldServesVegetarianFood。
	字段遮罩结算示例	以下示例展示了系统如何根据您在字段遮罩中选择的字段来对请求进行计费。 如果您的请求字段掩码仅包含此 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：地点详情 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：查找当前地点

此 SKU 用于按查找当前地点请求收费。

此 SKU 还会触发数据 SKU 的计费：如果您在请求中添加数据字段，系统可能会针对数据 SKU（基本数据、联系人数据和氛围数据）触发额外的计费。 请仅指定您需要的数据字段，以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。

	类别	Pro
	可结算事件	请求
	触发器	此 SKU 会对以下方法的请求进行计费： findCurrentPlace()（Android） findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:（iOS） 此 SKU 还会触发数据 SKU 的计费：如果您在请求中添加数据字段，系统可能会针对数据 SKU（基本数据、联系人数据和氛围数据）触发额外的计费。 请仅指定您需要的数据字段，以免产生不必要的费用。您需要为此 SKU 以及您请求的数据付费。
	示例	以下示例展示了在发出“查找当前地点”请求并指定基本数据、联系人数据和氛围数据 SKU 中的字段时，系统会按哪些 SKU 向您收费。如需查看账单中的 SKU，请按 SKU 查看账单，如按 SKU 分析用量和费用中所述。 您发出 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) 请求，并仅指定 ADDRESS 字段。您的账单中显示了以下 SKU： 查找当前地点 基本数据 您发出 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) 请求，并指定 PHONE_NUMBER 字段。您的账单中显示了以下 SKU： 查找当前地点 联系人数据 您发出 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) 请求，并指定所有三个数据类型范畴的字段。您的账单中显示了以下 SKU： 查找当前地点 基本数据 联系人数据 环境氛围数据
	价格	主要价格表 印度价格表

SKU：Places API 地点详情照片

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

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

其他用量限制

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

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

使用条款限制

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

---