本页面提供了 Google Maps Platform Places (New)、Places UI Kit、Places Aggregate API、Address Validation API、Geocoding API、Geolocation API、Time Zone API 和 Maps Experience Agent Tools 的 SKU 详情、SKU ID、可计费事件和结算触发器。如需了解旧版 Places SKU,请参阅旧版 Places 和 Routes SKU 详情。 如需查看所有商品类别的目录,请参阅 API 使用情况详情概览。如需了解 SKU 价格,请参阅全球和印度价格表。
关于 SKU 表
以下部分概述了每个 SKU 的详细信息:
| 类别 | SKU 是否属于基本功能版、专业版或企业版 SKU 类别。 |
| 可结算事件 | 针对 SKU 计费的事件。 |
| 触发器 | 哪些代码元素会触发计费事件。 |
| 价格 | 指向该 SKU 组的价格表的链接。 |
字段掩码结算
对于“地点详情(新)”“附近搜索(新)”和“文本搜索(新)”,系统会根据字段掩码中提供的字段对请求进行结算:
- 如果您的字段掩码仅包含单个 SKU 中的字段:请求将按该 SKU 的费率计费。
- 如果您的字段掩码包含来自多个 SKU 的字段:系统会按所请求字段中的最高 SKU 费率对请求进行结算。例如,如果您同时添加了 Essentials SKU 和 Enterprise SKU 中的字段,则系统会按 Enterprise SKU 费率对请求进行结算。
如需查看各平台字段及其关联 SKU 的完整列表,请参阅:
- Android SDK: 地点数据字段(新版)
- iOS SDK: 地点数据字段(新版)
- Maps JavaScript API 地点库: Place 类数据字段
- 网络服务: 地点数据字段(新版)
Places(新版)产品 SKU
[ 必备之选:地点、地理编码、地理定位 ] |
|---|
SKU:自动补全请求
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
4EF4-B17C-B31A(全球) F155-0371-DCAE(印度) |
|
| API | 地点自动补全 Android、 地点自动补全 iOS、 Maps JavaScript API 地点自动补全微件、 地点自动补全 Web |
|
| 可结算事件 | 请求不含会话令牌,或包含无效或过期的令牌 | |
| 触发器 |
此 SKU 会在以下情况下触发:
|
|
| 示例 | 使用会话可限制在单个自动补全会话期间计费的请求数量。如需了解详情,请参阅会话令牌或 SKU:自动补全会话用量。 | |
| 价格 |
价格表(全球)
价格表(印度) |
SKU:自动补全会话用量
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
EEA3-417B-DBA1(全球) 4764-9FA0-0FC0(印度) |
|
| API | 地点自动补全 Android、 地点自动补全 iOS、 Maps JavaScript API 地点自动补全微件、 地点自动补全 Web |
|
| 可结算事件 | 使用会话令牌发出请求 | |
| 触发器 |
如需了解详情,请参阅自动补全(新版)和会话价格。 |
|
| 示例 |
此 SKU 充当 Autocomplete (New) requests SKU 的封装容器,可让您限制在单个自动补全会话期间计费的请求数量。如需了解自动补全会话的使用情况,请参阅会话令牌。 |
|
| 价格 | 价格表(全球) 价格表(印度) |
SKU:地理编码
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
BAC8-4E68-E261(全球) AB12-DA89-B523(印度) |
|
| API | Maps JavaScript API 地理编码服务、 Geocoding API |
|
| 可结算事件 | 请求成功 | |
| 触发器 |
|
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:地理定位
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
51AF-D64F-9ABD(全球) 8D4A-1891-61DA(印度) |
|
| API | Geolocation API | |
| 可结算事件 | 请求成功 | |
| 触发器 | 向 Geolocation API 发出请求 | |
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Maps Grounding Essentials
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
8CD0-1602-5324(全球) E1E0-C20B-1C60(印度) |
|
| API | Maps Experience Agent Tools | |
| 可结算事件 | 向 Maps Experience Agent Tools 发出的请求 | |
| 触发器 |
向 Maps Experience Agent Tools 发出的请求未使用任何专业版选项,或来自未启用专业版的项目。 对 Resolution API( |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places API 地点详情基本功能版(仅 ID)
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
5C36-E272-E88F(全球) FAA1-1118-93BE(印度) |
|
| API | Places API 地点详情 | |
| 可结算事件 | 仅请求 ID 字段的成功请求 | |
| 触发器 |
Android SDK 的字段
适用于 iOS 的字段
Maps JavaScript API 地点库的字段
Web 服务字段
* |
|
| 字段掩码结算 | 如果您指定了字段掩码,则系统会按适用于所请求字段的最高 SKU 对请求进行结算。如需了解详情、示例和平台数据字段指南,请参阅字段掩码结算。 |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places API 地点详情基本功能版
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
6E05-E1C3-8D85(全球) 8036-9499-4AF9(印度) |
|
| API | 地点详情(新版) | |
| 可结算事件 | 仅请求基本信息字段的成功请求 |
|
| 触发器 |
Android SDK 的字段
适用于 iOS 的字段
Maps JavaScript API 地点库的字段
Web 服务字段
|
|
| 字段掩码结算 | 如果您指定了字段掩码,则系统会按适用于所请求字段的最高 SKU 对请求进行结算。如需了解详情、示例和平台数据字段指南,请参阅字段掩码结算。 |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places API 文本搜索基本功能版(仅 ID)
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
635D-A9DD-C520(全球) 9C44-5A2D-4E06(印度) |
|
| API |
文本搜索(新版) Maps Grounding Lite Resolution API |
|
| 可结算事件 | 仅请求 ID 成功 | |
| 触发器 |
Android SDK
iOS
Places Library、Maps JavaScript API
Web 服务
* Maps Grounding Lite 对 Resolution API |
|
| 字段掩码结算 | 如果您指定了字段掩码,则系统会按适用于所请求字段的最高 SKU 对请求进行结算。如需了解详情、示例和平台数据字段指南,请参阅字段掩码结算。 |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places UI Kit 查询
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
0678-4F72-DA7C(全球) B10D-0B66-6EAD(印度) |
|
| API | Places UI Kit Android、 Places UI Kit iOS、 Places UI Kit JavaScript |
|
| 可结算事件 | 使用 Places UI Kit 请求地点详情或地点搜索元素 | |
| 触发器 | 此 SKU 由 Places UI Kit 中对“地点详情”和“地点搜索”元素的请求触发。无论界面套件中显示哪些字段,用户都只需为每个 Places UI Kit 请求支付此 SKU 的费用。 Android iOS JavaScript |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places UI Kit - 自动补全(按会话结算)
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
924B-2797-26F1(全球) 1EC3-B6E6-F9B9(印度) |
|
| API | Places UI Kit Android、 Places UI Kit iOS、 Places UI Kit JavaScript |
|
| 可结算事件 | 会话 | |
| 触发器 |
此 SKU 由 Places UI Kit 基本自动补全请求触发: Android iOS JavaScript |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:时区
| 类别 | 基本功能版 | |
|---|---|---|
| SKU ID |
91DF-9B59-4BBD(全球) 0301-2887-FE47(印度) |
|
| API | Time Zone API | |
| 可结算事件 | 向 Time Zone API 发出的成功请求 | |
| 触发器 | 向 时区 API 发出请求。 | |
| 价格 |
价格表(全球) 价格表(印度) |
[ Pro:地址验证、地点 ] |
|---|
SKU:地址验证专业版
| 类别 | Pro | |
|---|---|---|
| SKU ID |
A2E0-53FF-0BE3(全球) 4EB5-381D-BD8E(印度) |
|
| API | Address Validation API | |
| 可结算事件 | 对 Address Validation API 的成功请求 | |
| 触发器 |
|
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places API 附近搜索专业版
| 类别 | Pro | |
|---|---|---|
| SKU ID |
99F9-A108-83A6(全球) 33DE-5C83-8354(印度) |
|
| API | 附近搜索(新版) | |
| 可结算事件 | 成功请求 Pro 字段 | |
| 触发器 |
Android SDK
iOS SDK
Places Library、Maps JavaScript API
Web 服务
|
|
| 字段掩码结算 | 如果您指定了字段掩码,则系统会按适用于所请求字段的最高 SKU 对请求进行结算。如需了解详情、示例和平台数据字段指南,请参阅字段掩码结算。 |
|
| 价格 | 价格表(全球) 价格表(印度) |
SKU:Places API 地点详情专业版
| 类别 | Pro | |
|---|---|---|
| SKU ID |
4ED6-464A-2AFC(全球) 1F70-206B-61DF(印度) |
|
| API | Places API 地点详情 | |
| 可结算事件 | 成功请求 Pro 字段 | |
| 触发器 |
Android SDK 的字段
适用于 iOS 的字段
Maps JavaScript API 地点库的字段
Web 服务字段
|
|
| 字段掩码结算 | 如果您指定了字段掩码,则系统会按适用于所请求字段的最高 SKU 对请求进行结算。如需了解详情、示例和平台数据字段指南,请参阅字段掩码结算。 |
|
| 价格 | 价格表(全球) 价格表(印度) |
SKU:Places API 文本搜索专业版
| 类别 | Pro | |
|---|---|---|
| SKU ID |
4FDA-34B1-A910(全球) 2DB9-E41E-AC2A(印度) |
|
| API | 文本搜索(新版) | |
| 可结算事件 | 成功请求 Pro 字段 | |
| 触发器 |
Android SDK
iOS
Places Library、Maps JavaScript API
Web 服务
|
|
| 字段掩码结算 | 如果您指定了字段掩码,则系统会按适用于所请求字段的最高 SKU 对请求进行结算。如需了解详情、示例和平台数据字段指南,请参阅字段掩码结算。 |
|
| 价格 | 价格表(全球) 价格表(印度) |
SKU:地点汇总 API
| 类别 | Pro | |
|---|---|---|
| SKU ID |
546C-66B2-E5A6(全球) CA83-2F48-1131(印度) |
|
| API | Places Aggregate API | |
| 可结算事件 | Pro 版功能申请成功 | |
| 触发器 | ||
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places UI Kit Pro(高级)
| 类别 | Pro | |
|---|---|---|
| SKU ID |
42AB-1FB3-B56A(全球) EA84-C46A-0634(印度) |
|
| API |
Places UI Kit Android Places UI Kit iOS Places UI Kit JavaScript |
|
| 可结算事件 | 使用 Places UI Kit 请求高级地点详情、高级地点列表、高级地点搜索或地点标记 | |
| 触发器 | 来自 Places UI Kit 的高级地点详情、高级地点搜索、高级地点列表和地点标记请求会触发此 SKU。对于每个 Places UI Kit 请求,无论 UI Kit 显示哪些字段,您都只需为此 SKU 付费。
iOS
高级地点详情组件 Android
高级地点详情组件 JavaScript |
|
| 价格 |
价格表(全球) 价格表(印度) |
[ 企业版:地址验证、地点 ] |
|---|
Shared Enterprise 和 Enterprise + Atmosphere 触发器字段
在所有平台上,“附近搜索(新)”“地点详情(新)”和“文本搜索(新)”的企业版和企业版 + 氛围数据 SKU 具有相同的触发字段。在“附近搜索(新版)”和“文本搜索(新版)”的网络服务请求中,为每个字段名称添加前缀 places.(例如 places.rating),routingSummaries 除外。
Places Enterprise 触发器字段
| Android SDK | iOS SDK | Maps JavaScript API 地点库 | 网络服务 |
|---|---|---|---|
Place.Field.CURRENT_OPENING_HOURS Place.Field.CURRENT_SECONDARY_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER* * 请使用此属性,而不是已弃用的 Place.Field.PHONE_NUMBER。Place.Field.NATIONAL_PHONE_NUMBER Place.Field.OPENING_HOURS Place.Field.PRICE_LEVEL Place.Field.RATING Place.Field.SECONDARY_OPENING_HOURS Place.Field.USER_RATING_COUNT* * 用于替代已弃用的 Place.Field.USER_RATINGS_TOTAL。Place.Field.WEBSITE_URI
|
GMSPlacePropertyCurrentOpeningHours GMSPlacePropertySecondaryOpeningHours GMSPlacePropertyPhoneNumber GMSPlacePropertyPriceLevel GMSPlacePropertyRating GMSPlacePropertyOpeningHours GMSPlacePropertyUserRatingsTotal GMSPlacePropertyWebsite
|
internationalPhoneNumber nationalPhoneNumber priceLevel rating regularOpeningHours userRatingCount websiteUri
|
currentOpeningHours currentSecondaryOpeningHours internationalPhoneNumber nationalPhoneNumber priceLevel priceRange rating regularOpeningHours regularSecondaryOpeningHours transitStation userRatingCount websiteUri
|
Places Enterprise + 氛围触发器字段
| Android SDK | iOS SDK | Maps JavaScript API 地点库 | 网络服务 |
|---|---|---|---|
Place.Field.ALLOWS_DOGS Place.Field.CURBSIDE_PICKUP Place.Field.DELIVERY Place.Field.DINE_IN Place.Field.EDITORIAL_SUMMARY Place.Field.EV_CHARGE_OPTIONS Place.Field.FUEL_OPTIONS Place.Field.GOOD_FOR_CHILDREN Place.Field.GOOD_FOR_GROUPS Place.Field.GOOD_FOR_WATCHING_SPORTS Place.Field.LIVE_MUSIC Place.Field.MENU_FOR_CHILDREN Place.Field.OUTDOOR_SEATING Place.Field.PARKING_OPTIONS Place.Field.PAYMENT_OPTIONS Place.Field.RESERVABLE Place.Field.RESTROOM Place.Field.REVIEWS Place.Field.SERVES_BEER Place.Field.SERVES_BREAKFAST Place.Field.SERVES_BRUNCH Place.Field.SERVES_COCKTAILS Place.Field.SERVES_COFFEE Place.Field.SERVES_DESSERT Place.Field.SERVES_DINNER Place.Field.SERVES_LUNCH Place.Field.SERVES_VEGETARIAN_FOOD Place.Field.SERVES_WINE Place.Field.TAKEOUT
|
GMSPlacePropertyCurbsidePickup GMSPlacePropertyDelivery GMSPlacePropertyDineIn GMSPlacePropertyEditorialSummary GMSPlacePropertyReservable GMSPlacePropertyReviews GMSPlacePropertyServesBeer GMSPlacePropertyServesBreakfast GMSPlacePropertyServesBrunch GMSPlacePropertyServesDinner GMSPlacePropertyServesLunch GMSPlacePropertyServesVegetarianFood GMSPlacePropertyServesWine GMSPlacePropertyTakeout
|
allowsDogs editorialSummary evChargeOptions fuelOptions hasCurbsidePickup hasDelivery hasDineIn hasLiveMusic hasMenuForChildren hasOutdoorSeating hasRestroom hasTakeout hasWifi isGoodForChildren isGoodForGroups isGoodForWatchingSports isReservable parkingOptions paymentOptions reviews servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine |
allowsDogs curbsidePickup delivery dineIn editorialSummary evChargeAmenitySummary evChargeOptions fuelOptions generativeSummary goodForChildren goodForGroups goodForWatchingSports liveMusic menuForChildren neighborhoodSummary parkingOptions paymentOptions outdoorSeating reservable restroom reviews reviewSummary routingSummaries*servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine takeout* 仅限文本搜索和附近搜索 |
SKU:地址验证企业版
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
10F3-119A-C6EC(全球) D73D-9896-24CF(印度) |
|
| API | Address Validation API | |
| 可结算事件 | 以地址验证请求结束的会话 | |
| 触发器 |
|
|
| 价格 |
价格表(全球) 价格表(印度) |
如需详细了解价格以及如何将 Autocomplete (New) 会话与 Places API 搭配使用,请参阅 Places API 文档中的以下指南:
SKU:Places API 附近搜索企业版
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
772E-9975-BE34(全球) B049-A814-B2A8(印度) |
|
| API | 附近搜索(新版) | |
| 可结算事件 | 成功请求 Enterprise 字段 | |
| 触发器 |
当您的请求包含任何 Places Enterprise 触发字段(适用于 Android SDK、iOS SDK、Maps JavaScript API 中的 Places Library 或 Web 服务)时,系统会触发此 SKU。 |
|
| 字段掩码结算 |
按所请求字段中的最高 SKU 费率结算。请参阅字段掩码结算。 |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places API 附近搜索企业版 + 氛围
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
F20E-7034-0EF7(全球) 1DC0-87A6-65E7(印度) |
|
| API | 附近搜索(新版) | |
| 可结算事件 | 成功请求氛围字段 | |
| 触发器 |
当您的请求包含任何地点企业版 + 氛围触发字段(适用于 Android SDK、iOS SDK、Maps JavaScript API 中的地点库或网络服务)时,系统会触发此 SKU。 |
|
| 字段掩码结算 | 按所请求字段中的最高 SKU 费率结算。请参阅字段掩码结算。 |
|
| 价格 | 价格表(全球) 价格表(印度) |
SKU:Places API 地点详情企业版
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
2D9A-3DE0-3766(全球) 448A-2967-E6BF(印度) |
|
| API | Places API 地点详情 | |
| 可结算事件 | 成功请求 Enterprise 字段 | |
| 触发器 |
当您的请求包含任何地点企业版触发字段(适用于 Android SDK、iOS SDK、Maps JavaScript API 中的地点库或 Web 服务)时,系统会触发此 SKU。 |
|
| 字段掩码结算 |
按所请求字段中的最高 SKU 费率结算。请参阅字段掩码结算。 |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places API 地点详情企业版 + 氛围
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
EB23-5ECC-F753(全球) 586E-FEBE-4FD2(印度) |
|
| API | Places API 地点详情 | |
| 可结算事件 | 成功请求 Enterprise + Atmosphere 字段 | |
| 触发器 |
如果请求包含任何 Places Enterprise + 氛围字段,则会触发此 SKU: |
|
| 字段掩码结算 | 如果您指定了字段掩码,则系统会按适用于所请求字段的最高 SKU 对请求进行结算。如需了解详情、示例和平台数据字段指南,请参阅字段掩码结算。 |
|
| 价格 | 价格表(全球) 价格表(印度) |
SKU:Places API 地点详情照片
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
DCD1-FE97-8C71(全球) 0AF7-8463-1BC9(印度) |
|
| API | 地点照片(新) | |
| 可结算事件 | 成功请求照片 | |
| 触发器 | 向 Place Photos(新版)发出请求 | |
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places API 文本搜索企业版
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
E967-44BC-B44D(全球) D112-1B19-2E0B(印度) |
|
| API | 文本搜索(新版) | |
| 可结算事件 | 成功请求 Enterprise 字段 | |
| 触发器 |
当您的请求包含任何 Places Enterprise 触发字段(适用于 Android SDK、iOS SDK、Maps JavaScript API 中的 Places Library 或 Web 服务)时,系统会触发此 SKU。 |
|
| 字段掩码结算 | 按所请求字段中的最高 SKU 费率结算。请参阅字段掩码结算。 |
|
| 价格 |
价格表(全球) 价格表(印度) |
SKU:Places API 文本搜索企业版 + 氛围
| 类别 | 企业版 | |
|---|---|---|
| SKU ID |
120C-BEC3-B48F(全球) 0FD0-B42B-DFDA(印度) |
|
| API | 文本搜索(新版) | |
| 可结算事件 | 成功请求 Enterprise + Atmosphere 字段 | |
| 触发器 |
当您的请求包含任何地点企业版 + 氛围触发字段(适用于 Android SDK、iOS SDK、Maps JavaScript API 中的地点库或网络服务)时,系统会触发此 SKU。 |
|
| 字段掩码结算 | 按所请求字段中的最高 SKU 费率结算。请参阅字段掩码结算。 |
|
| 价格 | 价格表(全球) 价格表(印度) |
相关 SKU 详情页面
- API 使用情况详情概览:按基本功能版、专业版、企业版和旧版层级整理的完整 SKU 目录。
- 地图 SKU 详情:Maps SDK for Android、Maps SDK for iOS、Maps JavaScript API、Maps Embed API、Maps Static API、街景 Static API、Elevation API、Aerial View API 和 Map Tiles API SKU。
- 路线 SKU 详情:Routes API、Route Optimization API、Roads API 和 Navigation SDK SKU。
- 环境 SKU 详情:Air Quality API、Pollen API、Solar API 和 Weather API SKU。
- 旧版 Places 和 Routes SKU 详情:旧版 Places API、Directions API 和 Distance Matrix API SKU。
- Google Maps Platform 价格和印度价格:每月用量层级和每次事件费率。