Google Maps Platform SKU 详情

本页详细介绍了 Google Maps Platform SKU,包括印度的 SKU。库存单元 (SKU) 是与商品相关联的 Google 地图平台中的一项独特的商品,并且一个商品可以有多个 SKU。每个 SKU 都有一个固定价格,您可以在价格列表中查看(价格价格 - 印度)。当您使用某项服务时,该服务可能会触发一个或多个 SKU,每个 SKU 都会在账单上显示为单独的订单项。

SKU 名称

本部分列出了所有 SKU,分为基本功能版、专业版和企业版。

  • 带粗体下划线的 SKU 已更新名称。
  • 将光标悬停在该区域上可查看之前的 SKU 名称,然后按 Esc 键关闭。

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

必备应用

地图 路线 地点 环境

动态地图

嵌入1

Google 地图 SDK2

静态地图

静态街景

静态街景元数据

Map Tiles API:2D 地图图块

Map Tiles API:街景图块

Routes:计算路线必备知识

路线:计算路线矩阵必备知识

自动补全请求

自动补全会话用量

地理编码

地理位置

Places API 地点详情必备知识(仅限 ID)

Places API 地点详情必备知识

Places API 文本搜索必备知识(仅限 ID)

地点信息界面套件 - 每次查询

地点界面套件 - 按会话自动补全(即将推出)

时区

空气质量使用

Solar API 建筑数据分析

天气使用情形

1“嵌入地图”和“高级嵌入地图”现已合并到一个 SKU 下:“嵌入地图”。除此之外,这些服务没有其他变化。

2 移动原生静态地图和移动原生动态地图现已合并到一个 SKU:Maps SDK 下。 这些服务的其他方面没有任何变化。

专业版

地图 路线 地点 环境

航拍视图

动态街景

海拔

道路 - 最近的道路

道路 - 已行驶路线

道路 - 速度限制

RouteOptimization - SingleVehicleRouting

路线:计算路线 Pro

路线:计算路线矩阵 Pro

Address Validation Pro

Places API Nearby Search Pro

Places API 地点详情 Pro

Places API 文本搜索 Pro

Places Aggregate API Pro

花粉用量

企业

地图 路线 地点 环境

Map Tiles API:仿真 3D 图块

RouteOptimization - FleetRouting

Routes:计算路线企业版

Routes:计算路线矩阵企业版

导航请求

Address Validation Enterprise

Places API 附近搜索企业版

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

Places API 地点详情企业版

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

Places API 地点详情照片

Places API Text Search Enterprise

Places API Text Search Enterprise + Atmosphere

Solar API 数据图层

SKU 表简介

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

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

Google 地图产品 SKU

[ 必备知识:地图 ]

SKU:动态地图

  类别 基本功能版
  API Google 地图 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
  可结算事件 成功请求 Pro 数据
  触发器

lookupVideo 方法。

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

SKU:动态街景

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

SKU:海拔

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

地图图块 - 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:路线:计算路线必备知识

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

SKU:路线:计算路线矩阵必备知识

  类别 基本功能版
  API 计算路线矩阵
  可结算事件 返回的每个元素都没有 Pro 或企业版功能
  触发器 对计算路线矩阵的请求,且未使用专业版或企业版功能。
  价格 主要价格表
印度价格表

[ Pro:道路和路线 ]

SKU:道路 - 最近的道路

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

SKU:道路 - 已行驶路线

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

SKU:道路 - 速度限制

  类别 Pro
  API Roads API
  可结算事件 API 响应中返回的元素。
  触发器 限速服务 - 访问权限受限
  价格 主要价格表
印度价格表

SKU:路线优化:单车辆路线

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

如果您的路线优化请求存在以下情况:

  • 1 辆车
  • 10 个唯一运单(包含 10 个唯一的运单位置或提货)

系统会针对单车配送 SKU 中的 10 个配送订单触发结算。而如果请求包含 5 辆车,则系统会针对“路线优化:车队路线”SKU 触发结算。

我们不会针对以下配送订单收取运费:

  • 由于验证错误(例如语法或数据验证错误,或任何内部服务错误)而导致请求失败的提交内容。
  • VALIDATE_ONLY 解题模式(仅执行验证)中的请求中的运输。
  • 在验证时被确定为不可行的发货,或者被明确忽略、从优化中排除或被 InjectedSolutionConstraint 限制无法优化的发货。
  价格 主要价格表
印度价格表

SKU:路线:计算路线 Pro

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

SKU:路线:计算路线矩阵 Pro

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

[ 企业版:路线优化、路线 ]

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

  类别 企业版
  API Route Optimization API
  可结算事件 针对多辆车辆的每项成功发货请求。
  触发器 多辆车辆的装运请求已成功提交。

我们不会针对以下配送订单收取运费:

  • 由于验证错误(例如语法或数据验证错误,或任何内部服务错误)而导致请求失败的提交内容。
  • VALIDATE_ONLY 解题模式(仅执行验证)中的请求中的运输。
  • 在验证时被确定为不可行的发货,或者被明确忽略、从优化中排除或被 InjectedSolutionConstraint 限制无法优化的发货。
  示例

如果您的路线优化请求存在以下情况:

  • 5 辆车
  • 10 个唯一运单(包含 10 个唯一的运单位置或提货)

系统会针对车队配送 SKU 中的 10 个配送订单触发结算。而如果请求中只有一辆车,则系统会针对“路线优化:单车辆”SKU 触发结算。

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

SKU:路线:计算路线企业版

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

SKU:路线:计算路线矩阵(企业版)

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

[ 企业版:导航 ]

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

  类别 企业版
  SDK 适用于 Android 的导航 SDK
适用于 iOS 的导航 SDK
  可结算事件 每个目标平台
  触发器

Android SDK

iOS SDK

  示例

每一次调用的费用计算方式为:目的地数量乘以每个 SKU 的价格。请注意,单个方法调用最多可以包含 25 个目的地。

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

地点(新)产品 SKU

[ 必备知识:地点、地理编码、地理定位 ]

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 字段的成功请求
  触发器

Android SDK 的字段

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

适用于 iOS 的字段

GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos

Maps JavaScript API 地点库的字段

id
photos

适用于 Web 服务的字段

attributions
id
name*
photos

* name 字段包含地点资源名称,格式为:places/PLACE_ID如需获取地点的文本名称,请在 Pro SKU 中请求 displayName 字段。

  字段遮罩结算

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

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

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

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

  触发器

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 的字段

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.name 字段包含地点资源名称,格式为:places/PLACE_ID在 Pro SKU 中,使用 places.displayName 访问地点的文本名称。

  字段遮罩结算

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

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

SKU:Places UI Kit - 按查询

  类别 基本功能版
  API Maps JavaScript API
Maps SDK for Android
Maps SDK for iOS
  可结算事件 请求
  触发器 当针对 地点界面套件中的地点详情元素发出请求时,系统会触发此 SKU。
  价格 主要价格表
印度价格表

SKU:地点界面套件 - 按会话结算的自动补全功能(即将推出)

  类别 基本功能版
  API Maps JavaScript API
Maps SDK for Android
Maps SDK for iOS
  可结算事件 请求
  触发器 此 SKU 由对地点界面 Kit 自动补全 widget 的请求触发。
  价格 主要价格表
印度价格表

SKU:时区

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

[ Pro:地址验证、地点 ]

SKU:Address Validation Pro

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

SKU:Places API 附近搜索 Pro

  类别 Pro
  API 附近搜索(新)
  可结算事件 成功请求 Pro 字段。
  触发器

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.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 地点详情 Pro

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

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 的字段

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

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

  字段遮罩结算

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

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

SKU:Places API 文本搜索 Pro

  类别 Pro
  API 文字形式的搜索广告(新)
  可结算事件 成功请求 Pro 字段。
  触发器

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.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* 地址描述符面向印度境内的客户正式推出,在其他国家/地区处于实验阶段。

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

  字段遮罩结算

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

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

SKU:地点汇总 Pro

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

[ 企业版:地址验证、地点 ]

SKU:Address Validation Enterprise

  类别 企业版
  API Address Validation API
  可结算事件 在地址验证请求中终止的会话
  触发器
  • ValidateAddress (REST) 方法中终止的自动补全(新)会话。
  • ValidateAddress (gRPC) 方法中终止的自动补全(新)会话。
  价格 主要价格表
印度价格表

如需详细了解价格以及如何将“自动补全(新)”会话与 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
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 地点详情企业版

  类别 企业版
  API Places 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

Maps JavaScript API 地点库的字段

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

适用于 iOS 的字段

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 地点详情
  可结算事件 成功请求使用“企业”和“氛围”字段
  触发器

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:

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
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 Air Quality API
  可结算事件 成功请求空气质量数据
  触发器
  价格 主要价格表
印度价格表

SKU:Solar API 建筑数据分析

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

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

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

SKU:天气使用情况

对于向 Weather API 发出的请求,您需要支付此 SKU 费用。

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

系统会针对以下端点/方法的请求触发结算:

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

[ 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 地点自动补全 widget 的“自动补全”请求可能会被收取“自动补全 - 按请求结算”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 属于数据 SKU,用于按“地点详情”或“查找地点”请求中的基本数据字段进行计费。对于触发此 SKU 的请求,除了基本 SKU 费用之外,您还需要支付此 SKU 的费用。

基本类别中的字段的费用包含在地点请求的基本费用中,它们不会产生任何额外费用。

  类别 基本功能版
  API Places API 基本数据(旧版)
  可结算事件 成功请求基本数据字段
  触发器

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:查找地点 - 仅返回 ID(旧版)

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

SKU:地点详情 - ID 刷新(旧版)

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

SKU:查询自动补全 - 按请求结算(旧版)

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

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

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

[ Pro:地点旧版 ]

SKU:自动补全(不含地点详情)- 按会话结算(旧版)

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

SKU:查找当前地点(旧版)

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

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

  示例

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

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

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

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

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

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

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

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

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

  • 查找当前地点
  • 基本数据
  • 联系人数据
  • 环境氛围数据

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

SKU:查找地点(旧版)

  类别 Pro
  API 地点 Web 服务“查找地点”
  可结算事件 成功请求了 ID 字段以外的字段
  触发器 查找地点请求,其中不仅指定了 ID 字段。

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

  示例

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

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

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

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

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

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

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

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

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

  • 查找当前地点
  • 基本数据
  • 联系人数据
  • 环境氛围数据

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

SKU:地点 - 附近搜索(旧版)

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

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

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

  示例

您发出“附近搜索”请求,例如 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(旧版)

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

使用网络 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:氛围数据(旧版)

一种数据 SKU,用于针对“地点详情”或“查找地点”请求中的氛围数据字段进行结算。对于触发此 SKU 的请求,除了基本 SKU 费用之外,您还需要支付此 SKU 的费用。
  类别 企业版
  API 氛围数据
  可结算事件 成功请求氛围数据字段
  触发器

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

Maps JavaScript API 地点库的字段

请参阅字段(地点详情)
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,用于针对“地点详情”或“查找地点”请求中的联系人数据字段进行结算。对于触发此 SKU 的请求,除了基本 SKU 费用之外,您还需要支付此 SKU 的费用。
  类别 企业版
  API Places API 联系信息(旧版)
查找地点
  可结算事件 成功请求使用“联系人数据”字段
  触发器

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(旧版)
Google 地图 JavaScript API 距离矩阵服务
  可结算事件 不包含 Pro 版或企业版功能的每个元素
  触发器 请求的元素不会触发价格较高的 SKU。
  价格 主要价格表
印度价格表

[ Pro:路线 - 旧版 ]

SKU:高级路线(旧版)

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

SKU:高级距离矩阵(旧版)

  类别 Pro
  API Distance Matrix API(旧版)
Google 地图 JavaScript API 距离矩阵服务
  可结算事件 返回的每个元素都具有 Pro 功能
  触发器
  价格 主要价格表
印度价格表