Google Maps Platform API 使用情况详细信息

此页面详细介绍了 Google Maps Platform SKU，包括印度适用的 SKU。

库存单位 (SKU) 是 Google 地图平台中与产品关联的独特项，一个产品可以关联多个 SKU。每个 SKU 都有一个固定价格，您可以在价格列表中查看（价格、价格 - 印度）。当您使用某项服务时，该服务可能会触发一个或多个 SKU，每个 SKU 都会以单独的专列项显示在您的账单中。

SKU 名称

本部分按名称列出了所有 SKU，分为基本版、专业版和企业版。此名称会显示在您的结算单上。

  • 带有粗体下划线的 SKU 的名称已更新。
  • 将指针悬停在上面可查看之前的 SKU 名称，按 Esc 可关闭。

如需了解价格类别，请参阅结算概览指南中的基本功能版、专业版和企业版类别。

基本功能版

地图 路线 地点 环境

动态地图

嵌入1

Maps SDK2

静态地图

静态街景

静态街景元数据

Map Tiles API：2D 地图图块

Map Tiles API：街景图块

Routes：Compute Routes Essentials

Routes：计算路线矩阵基本版

自动补全请求

自动补全会话使用情况

地理编码

地理位置

Places API 地点详情精简版（仅限 ID）

Places API 地点详情精简版

Places API 文本搜索 Essentials（仅限 ID）

Places UI Kit 查询

Places 界面套件 - 自动补全（按会话结算）

时区

空气质量使用情况

Solar API Building Insights

天气使用情况

1“嵌入地图”和“高级嵌入地图”现已合并为一个 SKU：“嵌入地图”。这些服务没有其他变化。

2 移动原生静态地图和移动原生动态地图现已合并为一个 SKU：Maps SDK。 这些服务没有其他变化。

专业版

地图 路线 地点 环境

航拍视图

动态街景

海拔

沉浸式地图

道路 - 最近的道路

道路 - 已行驶路线

道路 - 速度限制

RouteOptimization - SingleVehicleRouting

Routes：Compute Routes Pro

Routes：计算路线矩阵专业版

Address Validation Pro

Places API Nearby Search Pro

Places API 地点详情 Pro

Places API 文本搜索专业版

Places Aggregate API

Pollen 用量

企业

地图 路线 地点 环境

Map Tiles API： 仿真 3D 图块

RouteOptimization - FleetRouting

Routes：Compute Routes Enterprise

Routes：计算路线矩阵企业版

导航请求

Address Validation Enterprise

Places API 附近搜索（企业版）

Places API 附近搜索企业版 + 环境氛围

Places API Place Details Enterprise

Places API 地点详情企业版 + 环境氛围

Places API 地点详情照片

Places API Text Search Enterprise

Places API 文本搜索企业版 + 环境氛围

Solar API 数据层

关于 SKU 表格

以下部分概述了每个 SKU 的详细信息：

类别 相应 SKU 属于基本功能版、专业版还是企业版 SKU 类别。
可结算事件 相应 SKU 的结算事件。
触发器 哪些代码元素会触发可计费事件。
价格 指向相应 SKU 组的价格表的链接。

Google 地图产品 SKU

[ 基础：Google 地图 ]

SKU：动态地图

  类别 基本功能版
  API Maps JavaScript API
  可结算事件 地图加载成功
  触发器
  价格 主要价格表
印度价格表

SKU：嵌入地图

  类别 基本功能版
  API Embed API
  可结算事件 成功请求
  触发器 向 Embed API 发出的请求。
  价格 主要价格表
印度价格表

SKU：Maps SDK

  类别 基本功能版
  API Maps SDK for Android
Maps SDK for iOS
  可结算事件 地图加载
  触发器

用户与地图的互动（包括平移、缩放或切换地图图层）不会产生额外的地图加载。
  价格 主要价格表
印度价格表

SKU：静态地图

  类别 基本功能版
  API Maps Static API
  可结算事件 地图加载
  触发器 向 Maps Static API 成功发送的地图加载请求。
  价格 主要价格表
印度价格表

SKU：静态街景

此 SKU 会针对向 Street View Static API 发出的返回静态街景全景图片的请求收取费用。

  类别 基本功能版
  API Street View Static API
  可结算事件 全景加载
  触发器

向 Street View Static API 成功发出的静态街景全景图片请求。
  备注
  价格 主要价格表
印度价格表

SKU：静态街景元数据

  类别 基本功能版
  API Street View Static API
  可结算事件 仅涉及元数据的成功请求
  触发器 向 Street View Static API 成功发送的仅元数据请求。如需了解详情，请参阅街景图片元数据。
  价格 主要价格表
印度价格表

[ Pro: Maps ]

SKU：航拍视图

  类别 Pro
  API Aerial View API
  可结算事件 成功请求了专业版数据
  触发器

lookupVideo 方法。

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

SKU：动态街景

  类别 Pro
  API Maps JavaScript API
  可结算事件 全景图加载成功
  触发器
  价格 主要价格表
印度价格表

SKU：海拔

  类别 Pro
  API Maps JavaScript API、
Elevation API
  可结算事件 成功请求
  触发器
  价格 主要价格表
印度价格表

SKU：沉浸式地图

  类别 Pro
  API Maps JavaScript API 中的 3D 地图
  可结算事件 地图加载
  触发器

成功向 Maps JavaScript API 中的 3D 地图发送地图加载请求。
  备注
  价格 主要价格表
印度价格表

地图图块 - 2D 和街景图块

[ 基础知识：地图图块 ]

SKU：Map Tiles API：2D 地图图块

  类别 基本功能版
  API Map Tiles API
  可结算事件 返回 2D 地图图块的请求
  触发器
  价格 主要价格表
印度价格表

SKU：Map Tiles API：街景图块

  类别 基本功能版
  API Map Tiles API
  可结算事件 成功请求街景图块
  触发器
  • 街景图块
  • 街景缩略图
  • 街景 PanoID
  备注
  价格 主要价格表
印度价格表

地图图块 - 3D 图块

[ 企业：地图图块 ]

SKU：Map Tiles API：仿真 3D 图块

  类别 企业版
  API Map Tiles API
  可结算事件 返回 3D 图块的请求
  触发器 3D 图块。
  价格 主要价格表
印度价格表

路线产品 SKU

[ 基础：路线 ]

SKU：Routes: Compute Routes Essentials

  类别 基本功能版
  API Compute Routes
  可结算事件 成功请求，但不包含 Pro 或企业版功能
  触发器 不使用专业版或企业版功能的计算路线服务请求。
  价格 主要价格表
印度价格表

SKU：路线：计算路线矩阵必需项

  类别 基本功能版
  API 计算路线矩阵
  可结算事件 返回的每个元素均不包含 Pro 或 Enterprise 功能
  触发器 不使用专业版或企业版功能的“计算路线矩阵”服务请求。
  价格 主要价格表
印度价格表

[专业版：道路和路线 ]

SKU：道路 - 最近的道路

  类别 Pro
  API Roads API “最近的道路”服务
  可结算事件 成功请求
  触发器 对 Roads API 的“最近的道路”服务的请求。
  价格 主要价格表
印度价格表

SKU：道路 - 已行驶路线

  类别 Pro
  API Roads API
  可结算事件 成功请求
  触发器 “沿实际道路”服务。
  价格 主要价格表
印度价格表

SKU：道路 - 速度限制

  类别 Pro
  API Roads API
  可结算事件

API 响应正文的 speedLimits 数组中的每个速度限制元素。

注意：针对路径沿线的速度限制的单个请求可能会在响应正文中返回多个速度限制元素。
  触发器 “限速”服务 - 访问权限有限
  价格 主要价格表
印度价格表

SKU：路线优化：单辆车路线规划

  类别 Pro
  API Route Optimization API
  可结算事件 成功发货请求，指定了确切的一辆车。
  触发器 指定了确切的一辆车的路线优化货运请求。
  示例

如果您的路线优化请求具有以下特征：

  • 1 辆车
  • 10 个唯一运单（具有 10 个唯一配送地点或提货）

系统会针对“单车路线”SKU 中的 10 批货件触发结算。如果同一请求中包含 5 辆车，则会触发“Route Optimization: Fleet Routing”SKU 的结算。

您无需为以下货件支付费用：

  • 因验证错误（例如语法或数据验证错误）或任何内部服务错误而导致请求失败的货件。
  • VALIDATE_ONLY 解决模式（仅执行验证）下请求中的货件。
  • 在验证时被确定为不可行的货件，或者被明确忽略、从优化中排除或因 InjectedSolutionConstraint 而无法优化的货件。
  价格 主要价格表
印度价格表

SKU：Routes: Compute Routes Pro

  类别 Pro
  API Compute Routes
  可结算事件 使用 Pro 版功能的成功请求
  触发器
  价格 主要价格表
印度价格表

SKU：路线：计算路线矩阵专业版

  类别 Pro
  API 计算路线矩阵
  可结算事件 通过 Pro 功能返回的每个元素
  触发器
  价格 主要价格表
印度价格表

[ 企业：路线优化、路线 ]

SKU：路线优化：车队路线安排

  类别 企业版
  API Route Optimization API
  可结算事件 每项成功的多辆车运输请求。
  触发器 成功为多辆车提交了配送请求。

您无需为以下货件支付费用：

  • 因验证错误（例如语法或数据验证错误）或任何内部服务错误而导致请求失败的货件。
  • VALIDATE_ONLY 解决模式（仅执行验证）下请求中的货件。
  • 在验证时被确定为不可行的货件，或者被明确忽略、从优化中排除或因 InjectedSolutionConstraint 而无法优化的货件。
  示例

如果您的路线优化请求具有以下特征：

  • 5 辆车
  • 10 个唯一运单（具有 10 个唯一配送地点或提货）

系统会针对“Fleet Routing”SKU 中的 10 次配送触发结算。如果同一请求中包含一辆车，则会触发“路线优化：单辆车”SKU 的结算。

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

SKU：Routes：Compute Routes 企业版

  类别 企业版
  API Compute Routes
  可结算事件 成功请求（使用企业版功能）
  触发器
  价格 主要价格表
印度价格表

SKU：路线：计算路线矩阵企业版

  类别 企业版
  API 计算路线矩阵
  可结算事件 通过企业版功能返回的每个元素
  触发器
  价格 主要价格表
印度价格表

[ 企业：导航 ]

Navigation SDK 包括：Navigation SDK for Android 和 Navigation SDK for iOS。

  类别 企业版
  SDK Navigation SDK for Android
Navigation SDK for iOS
  可结算事件 每个目标平台
  触发器

Android SDK

iOS SDK
  示例

每次通话的费用按目的地数量乘以每个 SKU 的价格计算。请注意，单个方法调用最多可包含 25 个目的地。
  价格 主要价格表
印度价格表

地点（新）产品 SKU

[ 必需品：Places、地理编码、地理定位 ]

SKU：自动补全请求

  类别 基本功能版
  API 地点自动补全 (Android)、
地点自动补全 (iOS)、
Maps JavaScript API 地点自动补全 widget、
地点自动补全 (Web)
  可结算事件 请求不含会话令牌，或包含无效或过期的令牌
  触发器

此 SKU 在以下情况下触发：

  • 您的请求未包含会话令牌。
  • 您的请求包含会话令牌，但您放弃了会话。
  • 您的请求包含会话令牌，但您会在特定条件下终止会话。如需了解自动补全会话用量，请参阅会话令牌或自动补全会话用量。
  示例 使用会话来限制单个自动补全会话期间计费的请求数量。如需了解详情，请参阅会话令牌或 SKU：自动补全会话使用情况。
  价格 主要价格表
印度价格表

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

  类别 基本功能版
  API 地点自动补全 (Android)、
地点自动补全 (iOS)、
Maps JavaScript API 地点自动补全 widget、
地点自动补全 (Web)
  可结算事件 使用会话令牌发出请求
  触发器

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

  示例

此 SKU 充当“自动补全（新）”请求 SKU 的封装容器，可让您限制单个自动补全会话期间的计费请求数量。如需了解自动补全会话的使用情况，请参阅会话令牌。
  价格 主要价格表
印度价格表

SKU：地理编码

  类别 基本功能版
  API Maps JavaScript API 地理编码服务、
Geocoding API
  可结算事件 成功请求
  触发器
  价格 主要价格表
印度价格表

SKU：地理定位

  类别 基本功能版
  API Geolocation API
  可结算事件 成功请求
  触发器 向 Geolocation API 发出的请求。
  价格 主要价格表
印度价格表

SKU：Places API 地点详情精简版（仅 ID）

  类别 基本功能版
  API Places API 地点详情
  可结算事件 仅针对 ID 字段的成功请求
  触发器

Fields for Android SDK

Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME

iOS 版 Fields

GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos

Maps JavaScript API 地点库的字段

id
photos

Web 服务的字段

attributions
id
moved_place
moved_place_id
name*
photos

* name 字段包含地点资源名称，格式为：places/PLACE_ID。如需获取地点的文本名称，请在 Pro SKU 中请求 displayName 字段。
  字段掩码结算数据

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

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

SKU：Places API 地点详情必需项

  类别 基本功能版
  API Places API 地点详情
  可结算事件 仅请求基本字段

的成功请求
  触发器

Fields for Android SDK

Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS*
    * 请使用此属性，而不是 Place.Field.ADDRESS（已弃用）。
Place.Field.LOCATION*
    * 请使用此方法，而不是 Place.Field.LAT_LNG（已弃用）。
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

iOS 版 Fields

GMSPlacePropertyAddressComponents
GMSPlacePropertyFormattedAddress
GMSPlacePropertyCoordinate
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyViewport

Maps JavaScript API 地点库的字段

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
types
viewport

Web 服务的字段

addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

* 地址描述符已面向印度客户正式发布，但在其他地区仍处于实验阶段。
  字段掩码结算数据

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

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

SKU：Places API 文本搜索精简版（仅 ID）

  类别 基本功能版
  API 文本搜索（新）
  可结算事件 仅针对 ID 的成功请求。
  触发器

Android SDK

Place.Field.DISPLAY_NAME*
    * 请使用此属性，而不是 Place.Field.NAME（在版本 4.0 中已弃用）。
Place.Field.ID
Place.Field.RESOURCE_NAME*
    * 包含地点资源名称，格式为：places/PLACE_ID。
     使用 DISPLAY_NAME 访问地点的文本名称。

iOS

GMSPlacePropertyPlaceID

Places Library、Maps JavaScript API

id

Web 服务

places.attributions
places.id
places.name*
nextPageToken
places.movedPlace
places.movedPlaceId

* places.name 字段包含地点资源名称，格式为：places/PLACE_ID。在专业版 SKU 中使用 places.displayName 访问地点的文本名称。
  字段掩码结算数据

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

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

SKU：Places UI Kit - 按请求结算


  类别 基本功能版
  API Places 界面套件 Android、
Places 界面套件 iOS、
Places 界面套件 JavaScript
  可结算事件 请求
  触发器 当请求地点详情和地点搜索元素（来自 Places 界面套件）时，系统会触发此 SKU。用户只需为每个 Places UI Kit 请求支付此 SKU 的费用，无论 UI Kit 中显示哪些字段。

Android

“地点详情”组件
“地点搜索”组件

iOS

“地点详情”组件
“地点搜索”组件

JavaScript

地点详情元素
地点搜索元素

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

SKU：Places UI Kit - 自动补全（按会话结算）

  类别 基本功能版
  API Places 界面套件 Android、
Places 界面套件 iOS、
Places 界面套件 JavaScript
  可结算事件 会话
  触发器 此 SKU 由 Places UI Kit 基本自动补全请求触发：

Android

基本自动补全组件

iOS

基本自动补全组件

JavaScript

基本自动补全元素
  价格 主要价格表
印度价格表

SKU：时区

  类别 基本功能版
  API Time Zone API
  可结算事件 成功请求
  触发器 成功向 Time Zone API 发出的请求。
  价格 主要价格表
印度价格表

[ 专业版：地址验证、Places ]

SKU：Address Validation Pro

  类别 Pro
  API Address Validation API
  可结算事件 成功请求
  触发器
  价格 主要价格表
印度价格表

SKU：Places API 附近搜索专业版

  类别 Pro
  API 附近搜索（新）
  可结算事件 成功请求了专业版字段。
  触发器

Android SDK

Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.ADDRESS
Place.Field.DISPLAY_NAME >*
    * 请使用此标记，而不是已弃用的 Place.Field.NAME。
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
    * 请使用此属性，而不是已弃用的 Place.Field.ICON_URL。
Place.Field.ID
Place.Field.LAT_LNG
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.RESOURCE_NAME
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

iOS SDK

GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyName
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyPhotos
GMSPlacePropertyPlaceID
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance

Places Library、Maps JavaScript API

accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
id
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport

Web 服务

places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
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.movedPlace
places.movedPlaceId
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* 地址描述符已面向印度客户正式推出，但在其他国家/地区仍处于实验阶段。

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

  字段掩码结算数据

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

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

SKU：Places API 地点详情专业版

  类别 Pro
  API Places API 地点详情
  可结算事件 成功请求了专业版字段
  触发器

Fields for Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
    * 请使用此方法，而不是 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE（已弃用）。
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
    * 请使用此属性，而不是已弃用的 Place.Field.NAME。
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
    * 请使用此属性，而不是 Place.Field.ICON_URL（已弃用）。
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

iOS 版 Fields

GMSPlacePropertyBusinessStatus
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyWheelchairAccessibleEntrance

Maps JavaScript API 地点库的字段

accessibilityOptions
businessStatus
displayName
googleMapsUri
iconBackgroundColor
primaryTypeDisplayName
svgIconMaskURI
types
utcOffsetMinutes

Web 服务的字段

accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes
  字段掩码结算数据

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

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

SKU：Places API 文本搜索专业版

  类别 Pro
  API 文本搜索（新）
  可结算事件 成功请求了专业版字段。
  触发器

Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
    请使用此属性，而不是 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE（已弃用）。
Place.Field.ADDRESS_COMPONENTS
Place.Field.ADR_FORMAT_ADDRESS
Place.Field.BUSINESS_STATUS
Place.Field.FORMATTED_ADDRESS*
    请使用此属性，而不是 Place.Field.ADDRESS（已弃用）。
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL *
    请使用此方法，而不是 Place.Field.ICON_URL（已弃用）。
Place.Field.LOCATION*
    请使用此属性，而不是 Place.Field.LAT_LNG（已弃用）。
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.SUB_DESTINATIONS
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT

iOS

GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyPhotos
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance

Places Library、Maps JavaScript API

accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport

Web 服务

places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
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.searchUri
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* 地址描述符已面向印度客户正式发布，但在其他国家/地区仍处于实验阶段。
  字段掩码结算数据

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

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

SKU：Places Aggregate API

  类别 Pro
  API Places Aggregate API
  可结算事件 成功申请 Pro 版功能
  触发器
  价格 主要价格表
印度价格表

[ 企业：地址验证、地点 ]

SKU：Address Validation Enterprise

  类别 企业版
  API Address Validation API
  可结算事件 在地址验证请求中终止的会话
  触发器
  价格 主要价格表
印度价格表

如需详细了解定价以及如何将自动补全（新）会话与 Places API 搭配使用，请参阅 Places API 文档中的以下指南：

SKU：Places API 附近搜索企业版

  类别 企业版
  API 附近搜索（新）
  可结算事件 成功请求了企业字段。
  触发器

Android SDK

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

iOS

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

Places Library、Maps JavaScript API

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

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

  类别 企业版
  API 附近搜索（新）
  可结算事件 成功请求了氛围字段。
  触发器

Android SDK

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

iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Places Library、Maps JavaScript API

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

Web 服务

places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
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 地点详情企业版

  类别 企业版
  API Places API 地点详情
  可结算事件 成功请求企业字段
  触发器

Fields for Android SDK

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

Maps JavaScript API 地点库的字段

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

iOS 版 Fields

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

Web 服务的字段

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri
  字段掩码结算数据

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

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

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

  类别 企业版
  API Places API 地点详情
  可结算事件 成功请求了 Enterprise + Atmosphere 字段
  触发器

Fields for Android SDK

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

iOS SDK 的字段

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Maps JavaScript API 地点库的字段

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

Web 服务的字段

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 的费率计费。
  • 如果您的字段掩码包含其他 SKU 中的字段：系统会按所请求字段的最高 SKU 费率对相应请求进行结算。例如，如果您同时包含基本功能版 SKU 和企业版 SKU 中的字段，则相应请求将按企业版 SKU 的费率结算。
  价格 主要价格表
印度价格表

SKU：地点详情照片

  类别 企业版
  API Places API 地点详情照片
  可结算事件 成功请求照片
  触发器 请求照片。
  价格 主要价格表
印度价格表

SKU：Places API 文本搜索企业版

  类别 企业版
  API 文本搜索（新）
  可结算事件 成功请求了企业字段。
  触发器 当您请求以下字段时，会触发此 SKU：

Fields for Android SDK

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

iOS SDK 的字段

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

Maps JavaScript API 地点库的字段

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

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

  类别 企业版
  API 文本搜索（新）
  可结算事件 成功请求了企业数据和环境氛围数据字段。
  触发器

Android SDK

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

iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Places Library、Maps JavaScript API

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

Web 服务

places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
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 Air Quality API
  可结算事件 成功请求空气质量数据
  触发器
  价格 主要价格表
印度价格表

SKU：Solar API 建筑数据分析

  类别 基本功能版
  API Solar API
  可结算事件 成功请求
  触发器 对 Solar API buildingInsights 资源的请求。

当您向 Solar API buildingInsights 资源发出请求时，系统会触发此 SKU。

  示例
  价格 主要价格表
印度价格表

SKU：天气用量

此 SKU 会针对向 Weather API 发出的请求收取费用。

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

对以下端点/方法的请求会触发结算：
  价格 主要价格表
印度价格表

[ Pro: Environment ]

SKU：花粉使用情况

  类别 Pro
  API Pollen API
  可结算事件 成功请求
  触发器
  价格 主要价格表
印度价格表

[ 企业：环境 ]

SKU：Solar API 数据层

  类别 企业版
  API Solar API
  可结算事件 成功请求
  触发器 对 Solar API dataLayers 资源的请求。
  备注

通过同一请求访问多个图片网址不会产生额外的费用。
  价格 主要价格表
印度价格表

旧版地点产品 SKU

如需了解最新版本，请参阅地点产品 SKU。

关于地点数据 SKU

一共有三个地点数据 SKU，包括：基本数据、联系人数据和氛围数据。

系统会针对以下情况触发一个或多个数据 SKU：

  • Android：对 fetchPlace() 或 findCurrentPlace() 的每次请求
  • iOS：对 fetchPlaceFromPlaceID: 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 的每次调用
  • 网络服务：每个地点请求，具体取决于请求中指定的字段

对于触发数据 SKU 的请求，除了基本 SKU 费用之外，您还始终需要支付相应的数据 SKU 费用。例如，对于包含“基本数据”字段的“地点详情”请求，您需要同时支付“基本数据”SKU 费用和“地点详情”SKU 费用。

对于 Web 服务，以下 Places API 请求允许您指定要返回的数据字段：

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

[ 基础：地点旧版 ]

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

  类别 基本功能版
  API 地点自动补全（旧版）- Android,
地点自动补全（旧版）- iOS,
地点自动补全（旧版）- Web
  可结算事件 不包含会话令牌的请求
  触发器
  示例

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

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

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

  类别 基本功能版
  API 地点自动补全（旧版）- Android,
地点自动补全（旧版）- iOS,
地点自动补全（旧版）- Web
  可结算事件 会话
  触发器
  • Android：对 fetchPlace() 的调用
  • iOS：对 fetchPlaceFromPlaceID: 的调用
  • 网络服务：“地点详情”请求

请求中的字段：

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

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

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

自动补全请求是免费的。当您根据常规的地点详情定价请求后续地点详情时，系统会按此旧版 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)

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

关于“自动补全”会话

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

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

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

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

使用会话的“自动补全”请求和“地点详情”请求以不同的 SKU 计费。

SKU：基本数据

一种数据 SKU，用于结算地点详情或查找地点请求中的基本数据字段。

  类别 基本功能版
  API 地点详情（旧版） （包含基本字段）
查找地点（旧版） （包含基本字段）
  可结算事件 成功请求基本数据字段
  触发器

Fields for 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 版 Fields

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：查找地点 - 仅返回 ID

  类别 基本功能版
  API Places Web Service 的“查找地点”
  可结算事件 仅针对 place_id 的成功请求
  触发器 未指定任何字段或仅指定 place_id 字段的查找地点请求：FindPlace(fields: place_id)。
  价格 主要价格表
印度价格表

SKU：地点详情 - ID 刷新

  类别 基本功能版
  API 地点详情（旧版）
  可结算事件 仅针对 ID 字段的成功请求
  触发器 仅包含“地点 ID”字段的请求： getPlaceDetails(fields: place_id)。
  价格 主要价格表
印度价格表

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

  类别 基本功能版
  API 查询自动补全服务
  可结算事件 成功请求
  触发器

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

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

[ Pro：Places Legacy ]

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

  类别 Pro
  API 地点自动补全（旧版）- Android,
地点自动补全（旧版）- iOS,
地点自动补全（旧版）- Web
  可结算事件 会话
  触发器
  价格 主要价格表
印度价格表

SKU：查找当前地点

  类别 Pro
  API Places SDK for Android、
Places SDK for iOS
  可结算事件 成功请求
  触发器
  示例

以下示例展示了在发出“查找当前地点”请求并指定基本数据、联系人数据和氛围数据 SKU 中的字段时，您需要支付哪些 SKU 的费用。如需查看账单中的 SKU，请按 SKU 查看账单，如按 SKU 分析用量和费用中所述。

您发出“查找当前地点”请求，且仅指定 ADDRESS 字段：

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

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

您发出“查找当前地点”请求，且仅指定 PHONE_NUMBER 字段：

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

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

您发出“查找当前地点”请求并指定所有三个数据类型字段：

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

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

SKU：查找地点

  类别 Pro
  API Places Web Service 的“查找地点”
  可结算事件 成功请求了除 ID 字段之外的其他字段
  触发器 指定了除 ID 字段之外的其他字段的查找地点请求。
  示例

以下示例展示了在发出“查找当前地点”请求并指定基本数据、联系人数据和氛围数据 SKU 中的字段时，您需要支付哪些 SKU 的费用。如需查看账单中的 SKU，请按 SKU 查看账单，如按 SKU 分析用量和费用中所述。

您发出“查找地点”请求，且仅指定 ADDRESS 字段：

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

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

您发出“查找地点”请求，且仅指定 PHONE_NUMBER 字段：

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

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

您发出“查找地点”请求并指定所有三个数据类型字段：

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

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

SKU：地点 - 附近搜索

  类别 Pro
  API 附近搜索
  可结算事件 成功申请 Pro 版功能
  触发器

此请求不支持指定要返回的字段。响应会返回一个地点列表以及受支持的数据字段子集。
  示例

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

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

SKU：地点 - 文本搜索

  类别 Pro
  API 文本搜索（旧版）
  可结算事件 成功请求
  触发器

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

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

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

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

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

SKU：地点详情

  类别 Pro
  API 地点详情（旧版）
  可结算事件 成功申请 Pro 版功能
  触发器

使用网络 API 和服务时，无论是否提供会话令牌，都会收取“地点详情”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 查看账单时）：
    • 地点详情
    • 基本数据
    • 联系人数据
    • 环境氛围数据
  价格 主要价格表
印度价格表

[ 企业版：Google 商家信息旧版 ]

SKU：氛围数据

一种数据 SKU，用于结算地点详情或查找地点请求中的氛围数据字段。

  类别 企业版
  API 地点详情（旧版） （包含氛围字段）
查找地点（旧版） （包含氛围字段）
  可结算事件 成功请求了氛围数据字段
  触发器

Fields for Android SDK

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，该属性已弃用

iOS SDK 的字段

GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood。

Web 服务的字段

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，用于结算地点详情或查找地点请求中的联系人数据字段。

  类别 企业版
  API 地点详情（旧版） （包含联系信息字段）
查找地点（旧版） （包含联系信息字段）
  可结算事件 成功请求了联系人数据字段
  触发器

Fields for 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：地点照片

  类别 企业版
  API 地点照片（旧版）
  可结算事件 成功请求照片
  触发器
  • Android：对 fetchPhoto() 的请求
  • iOS：对 loadPlacePhoto: 的请求
  • JavaScript：向 PlacePhoto.getUrl() 发出的用于加载图片像素数据的请求。
  • 网络服务：对 Places API 的“地点照片”服务的请求。
  价格 主要价格表
印度价格表

旧版 Routes API SKU

[ 基础：路线（旧版）]

SKU：路线

  类别 基本功能版
  API Maps JavaScript API 的路线服务、
Directions API（旧版）
  可结算事件 成功请求，但不包含 Pro 或企业版功能
  触发器 不会触发更高等级 SKU 的查询。
  价格 主要价格表
印度价格表

SKU：距离矩阵

  类别 基本功能版
  API Distance Matrix API（旧版）、
Maps JavaScript API 距离矩阵服务
  可结算事件 不包含专业版或企业版功能的每个元素
  触发器 对不会触发更高价格 SKU 的元素的请求。
  价格 主要价格表
印度价格表

[ 专业版：路线旧版 ]

SKU：高级路线

  类别 Pro
  API Maps JavaScript API 的路线服务、
Directions API（旧版）
  可结算事件 使用 Pro 版功能的成功请求
  触发器
  价格 主要价格表
印度价格表

SKU：高级距离矩阵

  类别 Pro
  API Distance Matrix API（旧版）、
Maps JavaScript API 距离矩阵服务
  可结算事件 每个返回的元素都包含 Pro 版功能
  触发器
  价格 主要价格表
印度价格表