Places API 用量和结算

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

Places API（新版）和 Places API 采用随用随付定价模式。 Places API（新）和 Places API 请求会生成对多个 SKU 中的任一 SKU 的调用。 除了总的《Google 使用条款》之外，我们还针对 Places API 设置了特定的用量限额。您可以使用 Google Cloud 控制台中提供的工具管理费用和用量。

Places API 的结算方式

Places API（新版）和 Places API 采用随用随付定价模式。 Google Maps Platform API 和 SDK 按 SKU 结算。用量按 SKU 进行跟踪，任何 API 或 SDK 都可能有多个产品 SKU。费用计算方式：

SKU 用量 × 每次使用价格

您可以使用我们的价格和用量计算器估算每个 API 或 SDK 的使用费。对于符合条件的 Google Maps Platform SKU，每个结算账号每月可获得 200 美元的 Google Maps Platform 赠金。该金额会自动抵扣符合条件的 SKU 的费用。

注意 ：Google Maps Platform 每月 200 美元的赠金优惠截止时间为 2025 年 2 月 28 日晚 11:59（当地时间）。自 2025 年 3 月 1 日起，200 美元的赠金将被每个 API 的免费使用额度取代。如需了解详情，请参阅常见问题解答。

Places API（新）的价格

关于字段掩码

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

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

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

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

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

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

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

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

SKU：自动补全请求

对于不包含会话令牌的对“自动补全（新版）”API 的每次请求，您需要支付自动补全请求 SKU 费用。

如果您使用会话令牌，并且满足以下任一条件，系统也会向您收取会话令牌费用：

• 通过向“地点详情（新）”发出单个请求来终止会话，该请求请求 SKU：地点详情（仅位置信息）定义的任何字段。
  • 系统会使用 SKU：自动补全请求按每个“自动补全（新）”请求（最多 12 个请求）计费。
  • 系统会使用 SKU：自动补全会话使用量 对每个后续的“自动补全（新）”请求进行计费。
  注意：如果您在会话令牌过期之前调用了 SKU：首选地址验证，则系统不会对 SKU：地点详情（仅限位置信息）调用收费，并会根据 SKU：自动补全会话使用情况对您的会话进行计费。
• 通过调用 SKU：地点详情（仅 ID）来放弃会话或结束会话。然后，系统会使用 SKU：自动补全请求对所有“自动补全（新）”请求进行计费。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.00283 美元/次 （2.83 美元/千次）	0.00227 美元/次 （2.27 美元/千次）	如需了解批量定价，请与销售人员联系

---

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

对于包含会话令牌的对“自动补全（新版）”API 的每次请求，您需要支付自动补全会话使用情况 SKU 费用。

在以下情况下，系统会收取此 SKU 的费用：

• 自动补全会话因调用 SKU：地点详情（仅限位置信息） 而终止：

  • 系统会使用 SKU：自动补全请求按每个“自动补全（新）”请求（最多 12 个请求）计费。
  • 系统会使用 SKU：自动补全会话使用量 对每个后续的“自动补全（新）”请求进行计费。

• 自动补全会话因调用 SKU：地点详情（基本、高级或首选） 而终止。

  如果地点详情调用请求 SKU：地点详情（基本、高级或首选）中的任意字段，则系统会按 SKU：地点详情（首选）进行结算。

• 自动补全会话通过对 SKU：地址验证首选的调用而终止。

  注意：如果您在会话令牌过期之前先调用 SKU：地点详情（仅位置信息），然后再调用 SKU：首选地址验证，则系统不会对 SKU：地点详情（仅位置信息）调用收费，而只会对 SKU：首选地址验证调用收费。

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

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.00 美元/次 （0.00 美元/千次）	0.00 美元/次 （0.00 美元/千次）	0.00 美元/次 （0.00 美元/千次）

---

SKU：地点详情（仅 ID）

注意：如果您从“地点详情（仅限位置）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“地点详情（基本）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“地点详情（高级）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“地点详情（首选）SKU”中选择任意字段，则我们会按该费率进行结算。

通过在“地点详情（新）”请求中使用字段掩码或字段列表，您可以限制响应仅包含指定的字段。当您仅请求以下字段时，会触发此 SKU：

网络服务：attributions、id、name^*、photos

^* name 字段包含以下形式的地点资源名称：places/PLACE_ID。使用 displayName 访问地点的文本名称。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.0 美元/次 （0.00 美元/千次）	0.0 美元/次 （0.00 美元/千次）	0.0 美元/次 （0.00 美元/千次）

---

SKU：地点详情（仅位置信息）

注意：如果您从“地点详情（基本）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“地点详情（高级）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“地点详情（首选）SKU”中选择任意字段，则我们会按该费率进行结算。

通过在“地点详情（新）”请求中使用字段掩码或字段列表，您可以限制响应仅包含指定的字段。当您仅请求以下字段时，会触发此 SKU：

网络服务：addressComponents、adrFormatAddress、formattedAddress、location、plusCode、shortFormattedAddress、types、viewport

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.005 美元/次 （5.00 美元/千次）	0.004 美元/次 （4.00 美元/千次）	如需了解批量定价，请与销售人员联系

---

SKU：地点详情（基本）

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

通过在“地点详情（新）”请求中使用字段掩码或字段列表，您可以限制响应仅包含指定的字段。当您仅请求以下字段时，会触发此 SKU：

网络服务：accessibilityOptions、businessStatus、containingPlaces、displayName、googleMapsLinks^*、googleMapsUri、iconBackgroundColor、iconMaskBaseUri、primaryType、primaryTypeDisplayName、pureServiceAreaBusiness、subDestinations、utcOffsetMinutes

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

如果“自动补全”会话因“地点详情”调用而终止，并且该调用请求了SKU：地点详情（基本、高级或首选）中的任意字段，则该调用将按 SKU：地点详情（首选）进行计费。如需了解详情，请参阅 SKU：自动补全会话使用情况。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.0170 美元/次 （17.00 美元/千次）	0.0136 美元/次 （13.60 美元/千次）	如需了解批量定价，请与销售人员联系

---

SKU：地点详情（高级）

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

通过在“地点详情（新）”请求中使用字段掩码或字段列表，您可以限制响应仅包含指定的字段。当您仅请求以下字段时，会触发此 SKU：

网络服务：currentOpeningHours、currentSecondaryOpeningHours、internationalPhoneNumber、nationalPhoneNumber、priceLevel、priceRange、rating、regularOpeningHours、regularSecondaryOpeningHours、userRatingCount、websiteUri

如果“自动补全”会话因“地点详情”调用而终止，并且该调用请求了SKU：地点详情（基本、高级或首选）中的任意字段，则该调用将按 SKU：地点详情（首选）进行计费。如需了解详情，请参阅 SKU：自动补全会话使用情况。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.020 美元/次 （20.00 美元/千次）	0.016 美元/次 （16.00 美元/千次）	如需了解批量定价，请与销售人员联系

---

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：自动补全会话使用情况。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.025 美元/次 （25.00 美元/千次）	0.020 美元/次 （20.00 美元/千次）	如需了解批量定价，请与销售人员联系

---

SKU：附近搜索（基本）

注意：如果您从“附近搜索（高级）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“附近搜索（首选）SKU”中选择任意字段，则我们会按该费率进行结算。

通过在“附近搜索（新）”请求中使用字段掩码或字段列表，您可以限制响应仅包含指定的字段。当您仅请求以下字段时，会触发此 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 访问地点的文本名称。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.032 美元/次 （32.00 美元/千次）	0.0256 美元/次 （25.60 美元/千次）	如需了解批量定价，请与销售人员联系

---

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

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.035 美元/次 （35.00 美元/千次）	0.028 美元/次 （28.00 美元/千次）	如需了解批量定价，请与销售人员联系

---

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

^* 仅限文本搜索和附近搜索

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.040 美元/次 （40.00 美元/千次）	0.032 美元/次 （32.00 美元/千次）	如需了解批量定价，请与销售人员联系

---

SKU：文本搜索（仅 ID）

注意：如果您从“文本搜索（基本）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“文本搜索（高级）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“文本搜索（首选）SKU”中选择任意字段，则我们会按该费率进行结算。

通过在“文本搜索（新）”请求中使用字段掩码或字段列表，您可以限制响应仅包含指定的字段。当您仅请求以下字段时，会触发此 SKU：

网络服务：places.attributions、places.id、places.name^*、nextPageToken

^* places.name 字段包含以下形式的地点资源名称：places/PLACE_ID。使用 places.displayName 访问地点的文本名称。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.0 美元/次 （0.00 美元/千次）	0.0 美元/次 （0.00 美元/千次）	0.0 美元/次 （0.00 美元/千次）

---

SKU：文本搜索（基本）

注意：如果您从“文本搜索（高级）SKU”中选择任意字段，则我们会按该费率进行结算。如果您从“文本搜索（首选）SKU”中选择任意字段，则我们会按该费率进行结算。

通过在“文本搜索（新）”请求中使用字段掩码或字段列表，您可以限制响应仅包含指定的字段。当您仅请求以下字段时，会触发此 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 美元。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.032 美元/次 （32.00 美元/千次）	0.0256 美元/次 （25.60 美元/千次）	如需了解批量定价，请与销售人员联系

---

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

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.035 美元/次 （35.00 美元/千次）	0.028 美元/次 （28.00 美元/千次）	如需了解批量定价，请与销售人员联系

---

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

^* 仅限文本搜索和附近搜索

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.040 美元/次 （40.00 美元/千次）	0.032 美元/次 （32.00 美元/千次）	如需了解批量定价，请与销售人员联系

---

SKU：地点照片

每次向 API 发出请求都需支付 Place Photo SKU 费用。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.007 美元/次 （7.00 美元/千次）	0.0056 美元/次 （5.60 美元/千次）	如需了解批量定价，请与销售人员联系

---

Places API 的价格

以下价格来自 Google Maps Platform 价格页面。如需了解印度的价格，请参阅印度价格页面。

关于“自动补全”会话

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

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

“自动补全”会话可以通过以下 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 的费用。

在“地点详情”请求或“查找地点”请求中使用 fields 参数时，您可以将响应限制为仅包含指定的字段。基本类别中的字段的费用包含在地点请求的基本费用中，它们不会产生任何额外费用。系统会在收到以下任一字段请求时触发基本数据 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

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
地点请求费用 + 0.00 美元	地点请求费用 + 0.00 美元	地点请求费用 + 0.00 美元

---

SKU：联系人数据

注意：此 SKU 属于数据 SKU，对于触发此 SKU 的请求，除了基本 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
注意：Places SDK for Android 4.0 版本已废弃 Place.Field.PHONE_NUMBER 字段。请改用 Place.Field.INTERNATIONAL_PHONE_NUMBER。
• iOS：GMSPlaceFieldOpeningHours、GMSPlaceFieldPhoneNumber 或 GMSPlaceFieldWebsite
• 网络服务：formatted_phone_number、international_phone_number、opening_hours、current_opening_hours、secondary_opening_hours 或 website

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
地点请求费用 + 0.003 美元/次 （+ 3.00 美元/千次）	地点请求费用 + 0.0024 美元/次 （+ 2.40 美元/千次）	如需了解批量定价，请与销售人员联系

---

SKU：氛围数据

注意：此 SKU 属于数据 SKU，对于触发此 SKU 的请求，除了基本 SKU 费用之外，您还需要支付此 SKU 的费用。

在“地点详情”请求或“查找地点”请求中使用 fields 参数时，您可以将响应限制为仅包含指定的字段。氛围类别中的字段会产生额外费用。系统会在收到以下任一字段请求时触发氛围数据 SKU：

• Android： 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
  
  注意：Places SDK for Android 4.0 版本已废弃 Place.Field.USER_RATINGS_TOTAL 字段。请改用 Place.Field.USER_RATING_COUNT。
• iOS：GMSPlaceFieldPriceLevel、GMSPlaceFieldRating、GMSPlaceFieldUserRatingsTotal、GMSPlaceFieldTakeout、GMSPlaceFieldDelivery、GMSPlaceFieldDineIn、GMSPlaceFieldCurbsidePickup、GMSPlaceFieldReservable、GMSPlaceFieldServesBreakfast、GMSPlaceFieldServesLunch、GMSPlaceFieldServesDinner、GMSPlaceFieldServesBeer、GMSPlaceFieldServesWine、GMSPlaceFieldServesBrunch 或 GMSPlaceFieldServesVegetarianFood。
• JavaScript：请参阅字段（地点详情）
• 网络服务：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。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
地点请求费用 + 0.005 美元/次 （+ 5.00 美元/千次）	地点请求费用 + 0.004 美元/次 （+ 4.00 美元/千次）	如需了解批量定价，请与销售人员联系

---

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

您需要为以下任何不包含会话令牌的调用或请求支付自动补全 - 按请求结算 SKU 费用：

• Android：findAutocompletePredictions()
• iOS：findAutocompletePredictionsFromQuery:
• JavaScript：Maps JavaScript API 的地点自动补全服务
• 网络服务：Places API 的“地点自动补全”服务

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

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

每月用量范围 （每次请求的价格）
0–100,000	100,001–500,000	超过 500,000
0.00283 美元/次 （2.83 美元/千次）	0.00227 美元/次 （2.27 美元/千次）	如需了解批量定价，请与销售人员联系

---

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

对于不包含“地点详情”请求的“自动补全”会话，您需要（在会话开始的几分钟内）支付自动补全（不含地点详情）- 按会话结算 SKU 费用。

每月用量范围 （每次会话的价格）
0–100,000	100,001–500,000	超过 500,000
0.017 美元/次 （17.00 美元/千次）	0.0136 美元/次 （13.60 美元/千次）	如需了解批量定价，请与销售人员联系

示例

如果您的应用在单次会话中发出以下两个调用：

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 查看账单时）：

• 自动补全（不含地点详情）- 按会话结算（每次会话最低 0.017 美元）

---

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

注意：此 SKU 会显示在结算报告中，但不会显示在 Google Cloud 控制台的“结算”>“价格”页面。

您需要为包含以下任何一项的“自动补全”会话支付自动补全（包含地点详情）- 按会话结算 SKU 的费用：

• Android：对 fetchPlace() 的调用
• iOS：对 fetchPlaceFromPlaceID: 的调用
• 网络服务：“地点详情”请求

“自动补全”请求是免费的，随后的“地点详情”调用需按常规的地点详情定价支付费用。

“地点详情”请求会生成数据 SKU（基本数据、联系人数据和/或氛围数据），具体取决于请求中指定的字段。

如果您未在“地点详情”请求中指定字段，系统会触发所有数据 SKU（基本数据、联系人数据和氛围数据）。

在“自动补全”会话期间，地点详情 ID 刷新请求（仅指定 place_id 字段的请求）将按 SKU：自动补全（不含地点详情）- 按会话结算计费。

每月用量范围 （每次会话的价格）
0–100,000	100,001–500,000	超过 500,000
0.00 美元	0.00 美元	0.00 美元

示例

如果您的应用在单次会话中发出以下三个调用：

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 查看账单时）：

• 自动补全（包含地点详情）- 按会话结算（费用为 0.00 美元）
• 地点详情（每次会话最低 0.017 美元）
• 基本数据（费用为 0.00 美元）

---

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

您需要为针对以下内容的每次请求支付查询自动补全 - 按请求结算 SKU 费用：

• JavaScript：Maps JavaScript API 的“地点自动补全”服务 (getQueryPredictions())，以及对 Maps JavaScript API 的搜索框 widget 的使用（“查询自动补全”请求在用户输入内容时生成）。
• 网络服务：Places API 的“查询自动补全”服务

每月用量范围 （每次请求的价格）
0–100,000	100,001–500,000	超过 500,000
0.00283 美元/次 （2.83 美元/千次）	0.00227 美元/次 （2.27 美元/千次）	如需了解批量定价，请与销售人员联系

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

---

SKU：地点详情

地点详情调用的计费方式如下：

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.017 美元/次 （17.00 美元/千次）	0.0136 美元/次 （13.60 美元/千次）	如需了解批量定价，请与销售人员联系

地点详情 SKU 通过以下 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，并且您需要支付“地点详情”调用或请求费用以及所有数据的费用。

示例

1. 发出以下某项调用或请求：
   • 移动设备：在 Android 上调用 fetchPlace()，或在 iOS 上调用 fetchPlaceFromPlaceID:，且仅指定 ADDRESS 字段
   • 网络 API 或服务：发出“地点详情”请求，且仅指定“地址”字段：getPlaceDetails(fields: formatted_address)
   您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
   • 地点详情（每次会话最低 0.017 美元）
   • 基本数据（费用为 0.00 美元）
2. 发出以下某项调用或请求：
   • 移动设备：在 Android 上调用 fetchPlace()，或在 iOS 上调用 fetchPlaceFromPlaceID:，且仅指定 PHONE_NUMBER 字段
   • 网络 API 或服务：发出“地点详情”请求并指定“电话号码”字段：getPlaceDetails(fields: formatted_phone_number)
   您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
   • 地点详情（每次会话最低 0.017 美元）
   • 联系人数据（每次请求最低 0.003 美元）
3. 发出以下某项调用或请求：
   • 移动设备：在 Android 上调用 fetchPlace()，或在 iOS 上调用 fetchPlaceFromPlaceID:，并指定所有字段
   • 网络 API 或服务：发出“地点详情”请求并指定所有字段（如果您未指定任何字段，系统将默认发出此类请求）：getPlaceDetails()。
   您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
   • 地点详情（每次会话最低 0.017 美元）
   • 基本数据（费用为 0.00 美元）
   • 联系人数据（每次请求最低 0.003 美元）
   • 氛围数据（每次请求最低 0.005 美元）

---

SKU：地点详情 - ID 刷新

您可以使用“地点详情”请求刷新过时的地点 ID。这些类型的请求是免费的。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.00 美元	0.00 美元	0.00 美元

示例

发出仅指定“地点 ID”字段的“地点详情”请求：getPlaceDetails(fields: place_id)。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：

• 地点详情 – ID 刷新（费用为 0.00 美元）

---

SKU：查找地点

您需要为“查找地点”请求支付查找地点 SKU 费用。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.017 美元/次 （17.00 美元/千次）	0.0136 美元/次 （13.60 美元/千次）	如需了解批量定价，请与销售人员联系

“查找地点”请求还会生成数据 SKU（基本数据、联系人数据和/或氛围数据），具体取决于请求中指定的字段。与“地点详情”请求一样，您可以在“查找地点”请求中使用 fields 参数，将响应限制为仅包含指定的字段。您需要为“查找地点”请求和所请求的数据付费。默认情况下，如果未请求任何字段，系统仅会返回地点 ID，因此也就不会产生额外的数据费用。

示例

1. 您发出“查找地点”请求并仅指定“地址”字段：FindPlace(fields: formatted_address)。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
   • 查找地点（每次调用最低 0.017 美元）
   • 基本数据（费用为 0.00 美元）
2. 您发出“查找地点”请求并指定“电话号码”字段：FindPlace(fields: formatted_phone_number)。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
   • 查找地点（每次调用最低 0.017 美元）
   • 联系人数据（每次请求最低 0.003 美元）
3. 您发出“查找地点”请求并指定所有三个数据类型范畴的字段：FindPlace(fields: formatted_address, opening_hours, price_level)。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
   • 查找地点（每次调用最低 0.017 美元）
   • 基本数据（费用为 0.00 美元）
   • 联系人数据（每次请求最低 0.003 美元）
   • 氛围数据（每次请求最低 0.005 美元）

---

SKU：查找地点 - 仅返回 ID

您需要为仅指定返回地点 ID 的“查找地点”请求支付查找地点 - 仅返回 ID SKU 费用。默认情况下，如果未在“查找地点”请求中指定任何字段，则系统仅会返回地点 ID。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.00 美元	0.00 美元	0.00 美元

示例

您发出“查找地点”请求并仅指定 place_id 字段：FindPlace(fields: place_id)。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：

• 查找地点 - 仅 ID（费用为 0.00 美元）

---

SKU：地点 - 附近搜索

对于向 Maps JavaScript API 的“地点附近搜索”服务 (nearbySearch()) 或 Places API 的“附近搜索”服务发出的请求，您需要支付地点 - 附近搜索费用

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.032 美元/次 （32.00 美元/千次）	0.0256 美元/次 （25.60 美元/千次）	如需了解批量定价，请与销售人员联系

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

示例

您发出“附近搜索”请求，例如 NearbySearch (San Francisco, 100 meters)。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：

• 地点 - 附近搜索（每次调用最低 0.032 美元）
• 基本数据（费用为 0.00 美元）
• 联系人数据（每次请求最低 0.003 美元）
• 氛围数据（每次请求最低 0.005 美元）

---

SKU：地点 - 文本搜索

对于向 Maps JavaScript API 的“地点文本搜索”服务 (textSearch()) 或 Places API 的“文本搜索”服务发出的请求，您需要支付地点 - 文本搜索费用。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.032 美元/次 （32.00 美元/千次）	0.0256 美元/次 （25.60 美元/千次）	如需了解批量定价，请与销售人员联系

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

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

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

示例

您发出“文本搜索”请求，例如 TextSearch(123 Main Street)。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：

• 地点 - 文本搜索（每次调用最低 0.032 美元）
• 基本数据（费用为 0.00 美元）
• 联系人数据（每次请求最低 0.003 美元）
• 氛围数据（每次请求最低 0.005 美元）

---

SKU：地点照片

您需要针对以下行为支付地点照片 SKU 费用：

• Android：对 fetchPhoto() 的调用
• iOS：对 loadPlacePhoto: 的调用
• JavaScript：从 PlacePhoto.getUrl() 返回的网址中请求数据以加载图片像素数据时，对于向 Maps JavaScript API 地点库的“Place Photo”服务发出的请求，您需要支付相应费用
• 网络服务：对 Places API Place Photo 服务的请求

对于 JavaScript 服务，在将网址实际用于获取像素数据之前，调用 PlacePhoto.getUrl() 方法不会产生账单费用。

每月用量范围 （每次调用的价格）
0–100,000	100,001–500,000	超过 500,000
0.007 美元/次 （7.00 美元/千次）	0.0056 美元/次 （5.60 美元/千次）	如需了解批量定价，请与销售人员联系

---

其他用量限制

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

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

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

使用条款限制

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

管理使用费

如需管理 Places API 的使用费或满足生产流量的要求，您可以对任何 API 的所有请求设置每日配额上限。每日配额将在太平洋时间午夜重置。

注意：您只能为可结算 API 设置每日可计费配额上限。如果您的项目没有使用任何可结算 API，那么您将无法设置每日上限。

如需查看或更改 Places API 的配额上限，请执行以下操作：

1. 在 Cloud 控制台中，打开 Google Maps Platform 配额页面。
2. 点击“API”下拉列表，然后选择 Places API。
3. 如需查看配额上限，请向下滚动到请求卡片。
   表中列出了配额名称和上限。
4. 如需更改配额上限，请点击相应上限对应的修改图标。
   在显示的对话框中，在配额限制字段中输入首选可结算每日配额上限（最高可设为 Google 指定的配额上限，如适用），然后选择保存。

如果您的 API 用量在任何一天达到了可计费配额上限，那么您的应用在当天剩余时间内将无法访问相应 API。

相关费用管理资源

• Google Maps Platform 结算和价格
• Google Maps Platform 报告和监控

---