Places API 用量和结算

Places API 的结算和价格

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

地点（新）产品 SKU

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

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

关于字段掩码

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

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

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

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

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

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

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

SKU：自动补全请求

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

  类别 基本功能版
  可结算事件 请求
  触发器

在以下情况下，系统会触发此 SKU：

  • 您的请求不包含会话令牌。
  • 您的请求包含会话令牌，但您放弃了会话。
  • 您的请求包含会话令牌，但您会在特定情况下终止会话。如需了解“自动补全”会话用量，请参阅会话令牌或自动补全会话用量。
  价格 主要价格表
印度价格表

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

对于包含会话令牌的对 Autocomplete（新）API 的每次请求，您都需要支付此 SKU 的费用。

  类别 基本功能版
  可结算事件 请求
  触发器

当您向包含会话令牌的“自动补全（新）”API 发送请求时，系统会触发此 SKU。

此 SKU 可用作“自动补全（新）”请求 SKU 的封装容器，可让您限制单个自动补全会话期间计费的请求数量。如需了解自动补全会话用量，请参阅会话令牌。

如需了解详情，请参阅自动补全（新）和会话价格。

  价格 主要价格表
印度价格表

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

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

  类别 基本功能版
  可结算事件 使用指定字段掩码的请求。
  触发器

当您请求以下字段时，系统会触发此 SKU：

适用于 Web 服务的字段

attributions
id
name*
photos

* name 字段包含地点资源名称，格式为：places/PLACE_ID。使用 displayName 访问地点的文本名称。
  字段遮罩结算

系统会根据字段掩码中提供的字段对您的请求进行计费。例如：

  • 如果您的字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行计费。
  • 如果您的字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

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

对于检索此 SKU 中字段的“地点详情”API 请求，系统会按此 SKU 进行计费。
  类别 基本功能版
  可结算事件 使用指定字段掩码的请求。
  触发器

当您请求以下位置信息字段时，系统会触发此 SKU：

适用于 Web 服务的字段

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

  字段遮罩结算

系统会根据字段掩码中提供的字段对您的请求进行计费。例如：

  • 如果您的字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行计费。
  • 如果您的字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU：Places API 地点详情 Pro

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

  类别 Pro
  可结算事件 使用指定字段掩码的请求。
  触发器 当您仅请求以下字段或费率较低的字段时，会触发此 SKU：

适用于 Web 服务的字段

accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes

* googleMapsLinks 字段处于正式发布前预览阶段，在预览期间使用不会产生费用，也就是说，结算金额为 0 美元。

  字段遮罩结算

系统会根据字段掩码中提供的字段对您的请求进行计费。例如：

  • 如果您的字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行计费。
  • 如果您的字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU：Places API 地点详情企业版

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

  类别 企业
  可结算事件 包含指定字段掩码的请求。
  触发器 当您请求以下字段时，系统会触发此 SKU：

适用于 Web 服务的字段

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

如果您使用请求 SKU：地点详情 Essentials、Pro、企业版或企业版 + 氛围数据中的任意字段的地点详情调用终止自动补全会话，则该调用的费用将按 SKU：地点详情企业版 + 氛围数据进行结算。如需了解详情，请参阅 SKU：自动补全会话使用情况。
  字段遮罩结算

系统会根据字段掩码中提供的字段对您的请求进行计费。例如：

  • 如果您的字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行计费。
  • 如果您的字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

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

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

  类别 企业
  可结算事件 请求
  触发器

当您请求以下字段时，系统会触发此 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：地点详情 Essentials、Pro、企业版或企业版 + 氛围数据 中的任意字段，则该调用将按 SKU：地点详情企业版 + 氛围数据 进行计费。如需了解详情，请参阅 SKU：自动补全会话使用情况。
  字段遮罩结算示例

系统会根据字段掩码中提供的字段对您的请求进行计费。例如：

  • 如果您的字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行计费。
  • 如果您的字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU：Places API 附近搜索 Pro

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

  类别 Pro
  可结算事件 使用指定字段掩码的请求。
  触发器 当您仅请求以下字段或费率较低的字段时，会触发此 SKU：

适用于 Web 服务的字段

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.postalAddress
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：Places API 附近搜索企业版

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

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器

当您请求以下字段时，系统会触发此 SKU：

适用于 Web 服务的字段

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：Places API 附近搜索企业版 + 氛围

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

  类别 企业
  可结算事件 请求
  触发器

当您请求以下字段时，系统会触发此 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：Places API 文本搜索必备功能（仅 ID）

您需要为仅返回 ID 的 Text Search API 请求支付此 SKU 费用。
  类别 基本功能版
  可结算事件 使用指定字段掩码的请求。
  触发器

当您仅请求以下字段时，会触发此 SKU：

适用于 Web 服务的字段

places.attributions
places.id
places.name*
nextPageToken

* places.name 字段包含地点资源名称，格式为：places/PLACE_ID。使用 places.displayName 访问地点的文本名称。
  字段遮罩结算

系统会根据字段掩码中提供的字段对您的请求进行计费。例如：

  • 如果您的字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行计费。
  • 如果您的字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU：Places API 文本搜索 Pro

此 SKU 属于数据 SKU，系统会根据您在文本搜索 Pro 请求中指定的字段来收费。
  类别 Pro
  可结算事件 使用指定字段掩码的请求。
  触发器 当您仅请求以下字段或费率较低的字段时，会触发此 SKU：

适用于 Web 服务的字段

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.postalAddress
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：Places API 文本搜索企业版

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

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下字段时，系统会触发此 SKU：

适用于 Web 服务的字段

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：Places API 文本搜索企业版 + 氛围

系统会针对包含任何大气字段的文本搜索请求对此 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 用于针对地点详情照片请求进行结算。

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

旧版地点产品 SKU

关于“自动补全”会话

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

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

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

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

使用会话的“自动补全”请求和“地点详情”请求以不同的 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：

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 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU：联系人数据

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

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

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器 系统会在收到以下任一字段请求时触发联系人数据 SKU：

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 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

SKU：氛围数据

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

  类别 企业
  可结算事件 使用指定字段掩码的请求。
  触发器 当您请求以下任一字段时，系统就会触发结算：
  字段遮罩结算示例

系统会根据字段掩码中提供的字段对您的请求进行计费。例如：

  • 如果您的字段掩码仅包含此 SKU 中的字段：系统会按照此 SKU 的费率对请求进行计费。
  • 如果您的字段掩码包含其他 SKU 中的字段：系统会按请求的字段的最高 SKU 费率对请求进行结算。例如，如果您同时包含基本版 SKU 和企业版 SKU 中的字段，则系统会按照企业版 SKU 的费率对该请求进行结算。
  价格 主要价格表
印度价格表

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

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

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

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

  类别 基本功能版
  可结算事件 请求
  触发器 系统会针对以下情况触发结算：
  价格 主要价格表
印度价格表

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

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

  类别 Pro
  可结算事件 会话
  触发器 如果您的应用在单次会话中发出以下两个请求，系统就会触发结算：

按 SKU 查看账单时，您会看到账单中列出了以下 SKU：

  • 自动补全（不含地点详情）- 按会话结算
  价格 主要价格表
印度价格表

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

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

  类别 基本功能版
  可结算事件 会话
  触发器 您需要为请求地点详情的“自动补全”会话支付自动补全（包含地点详情）- 按会话结算 SKU 费用。具体而言：
  • Android：对 fetchPlace() 的调用
  • iOS：对 fetchPlaceFromPlaceID: 的调用
  • 网络服务：“地点详情”请求

请求中的字段：

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

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

如果您在自动补全会话期间仅请求刷新地点详情 ID（您的请求仅指定 place_id 字段），系统会按 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)

  价格 主要价格表
印度价格表

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

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

  类别 基本功能版
  可结算事件 请求
  触发器

当您使用以下服务发出查询自动补全请求时，系统会触发此 SKU：

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

  价格 主要价格表
印度价格表

SKU：地点详情 Pro

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

  类别 Pro
  可结算事件 请求
  触发器 系统会针对以下 API 发出的请求触发结算：

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

此 SKU 还会触发数据 SKU 的计费：如果您在请求中添加数据字段，系统可能会针对数据 SKU（基本数据、联系人数据和氛围数据）触发额外的计费。 请仅指定您需要的数据字段，以免产生不必要的费用。您需要为此 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 查看账单时）：
    • 地点详情
    • 基本数据
    • 联系人数据
    • 环境氛围数据
  价格 主要价格表
印度价格表

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 查看账单。

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

您的账单中显示了以下 SKU：

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

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

您的账单中显示了以下 SKU：

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

您发出包含所有三个数据类型字段的“查找地点”请求：

您的账单中显示了以下 SKU：

  • 查找当前地点
  • 基本数据
  • 联系人数据
  • 环境氛围数据
  价格 主要价格表
印度价格表

SKU：查找地点 - 仅返回 ID

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

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

SKU：地点 - 附近搜索

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

  类别 Pro
  可结算事件 请求
  触发器 当您使用以下任一 API 发出附近搜索请求时，系统会触发此 SKU：

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

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

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

  • 地点
  • 基本数据
  • 联系人数据
  • 环境氛围数据
  价格 主要价格表
印度价格表

SKU：地点 - 文本搜索

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

  类别 Pro
  可结算事件 请求
  触发器 系统会针对对以下服务的请求触发结算：

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

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

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

如果您发出“文本搜索”请求（例如 TextSearch(123 Main Street)），则在按 SKU 查看账单时，账单中会显示以下 SKU：

  • 地点 - 文本搜索
  • 基本数据
  • 联系人数据
  • 环境氛围数据
  价格 主要价格表
印度价格表

SKU：Places API 地点详情照片

此 SKU 用于按使用量计费的旧版地点照片服务。

  类别 企业
  可结算事件 请求
  触发器 系统会针对以下情况触发结算：
  价格 主要价格表
印度价格表

其他用量限制

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

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

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

使用条款限制

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