本部分列出了针对 Google Maps Platform 核心产品定义的各种 SKU。核心产品采用随用随付定价模式,您只需为所使用的 SKU 付费。
对于列出的每个 SKU,您会看到以下信息:
- 显示在结算报告中的 SKU 名称。
- 触发 SKU 的使用类型详情。
- 三个用量层级的单次使用价格。
- 针对具体 SKU 的补充定价说明。
您可以在本文中查找各个产品 SKU,或使用我们的定价和用量计算器来估算用量与每个 API 的总费用。
GMP 产品/SKU 表格
地图产品 SKU
地图产品中的 API 包括:Maps SDK for Android、Maps SDK for iOS、Maps JavaScript API、Maps Static API、Street View Static API 和 Maps Embed API。
SKU:移动原生静态地图
包括采用 Maps SDK for Android 的移动应用中未加载地图 ID 的精简模式 Google 地图对象。
每月用量范围 (每次加载地图的价格) |
||
---|---|---|
0.00 美元 | 0.00 美元 | 0.00 美元 |
在采用 Maps SDK for Android 的移动应用中,每次对精简模式 Google 地图对象进行实例化时,都会产生一次地图加载。地图是使用 MapFragment
、SupportMapFragment
或 MapView
类的实例创建的。每次调用相关的 onCreate()
方法时,系统都会记录一次地图加载。
SKU:移动原生动态地图
采用 Maps SDK for Android 或 Maps SDK for iOS 的移动应用中未加载地图 ID 的 Google 地图对象。
每月用量范围 (每次加载地图的价格) |
||
---|---|---|
0.00 美元 | 0.00 美元 | 0.00 美元 |
在采用 Maps SDK for Android 或 Maps SDK for iOS 的移动应用中,每次对 Google 地图对象进行实例化时,都会产生一次地图加载:
- Android 上的
MapFragment
、SupportMapFragment
或MapView
类之一。每次调用相关的onCreate()
方法时,系统都会记录一次地图加载。 - iOS 上的
GMSMapView
对象。
用户与地图互动(例如平移、缩放或切换地图图层)时不会产生额外的地图加载。采用随用随付定价模式时,街景全景图片的创建不再以移动原生地图加载次数为标准进行收费,而是按动态街景收费。
SKU:嵌入地图和 SKU:高级嵌入地图
所有 Maps Embed API 请求都是免费的,且用量不受限制。
SKU:静态地图
对 Maps Static API 的请求。
每月用量范围 (每次加载地图的价格) |
||
---|---|---|
0.002 美元/次 (2.00 美元/千次) |
0.0016 美元/次 (1.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:动态地图
如果应用使用 Maps JavaScript API,则应用显示的地图会或不会与地图 ID 一起加载;如果应用使用 Maps SDK for Android 或 Maps SDK for iOS,则应用显示的地图会与地图 ID 一起加载。
每月用量范围 (每次加载地图的价格) |
||
---|---|---|
0.007 美元/次 (7.00 美元/千次) |
0.0056 美元/次 (5.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
用户与地图互动(例如平移、缩放或切换地图图层)时不会产生额外的地图加载。
SKU:静态街景
街景全景图片和地图加载现在是分开计费的。对于向 Street View Static API 发出的嵌入静态(非交互式)街景全景图片的每个请求,您都需支付单张静态街景全景图片的费用。使用街景图片元数据端点不会产生费用。
每月用量范围 (每张全景图片的价格) |
||
---|---|---|
0.007 美元/次 (7.00 美元/千次) |
0.0056 美元/次 (5.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:动态街景
街景全景图片和地图加载现在是分开计费的。在采用 Maps JavaScript API、Maps SDK for Android、Maps SDK for iOS 的应用中,对于全景图片对象的每次实例化,您都需支付单张动态街景全景图片的费用。
每月用量范围 (每张全景图片的价格) |
||
---|---|---|
0.014 美元/张 (14.00 美元/千张) |
0.0112 美元/张 (11.20 美元/千张) |
如需了解批量定价,请与销售人员联系 |
执行以下操作时,全景图片对象会进行实例化:
- 在 JavaScript 中,使用
google.maps.StreetViewPanorama()
类或Map.getStreetView()
方法。无论是根据街景小人控件生成的内置街景体验,还是对StreetViewService()
类的使用,都不会产生费用。 - 在 Android 设备上,使用
StreetViewPanoramaFragment
、SupportStreetViewPanoramaFragment
或StreetViewPanoramaView
类之一。每次调用相关的onCreate()
方法时,系统都会计为一张全景图片。 - 在 iOS 设备上,使用
GMSPanoramaView
对象。
SKU:航拍视图
对 Aerial View API 的请求会返回航拍视频网址。
每月用量范围 (每次成功发出 lookupVideo 请求的价格) |
||
---|---|---|
0.016 美元/次 (16.00 美元/千次) |
0.0128 美元/次 (12.80 美元/千次) |
如需了解批量定价,请与销售人员联系 |
只有返回网址的 lookupVideo
调用才会产生费用。单次成功的 lookupVideo
响应可能会返回多个网址,每个网址用于不同的分辨率或屏幕方向,但这仅构成一个计费事件。请注意,价格并不取决于最终用户实际查看这些网址对应的内容的次数。
路线产品 SKU
路线产品中的 API 包括:Directions API、Distance Matrix API 和 Roads API。
SKU:路线
对 Maps JavaScript API 的“路线”服务或 Directions API 的请求(触发高级路线结算 SKU 的请求除外)。
每月用量范围 (每次查询的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:高级路线
对 Maps JavaScript API 的“路线”服务或 Directions API(该 API 使用了路况信息以及超过 10 个航点、航点优化和/或位置修饰符)的请求。
每月用量范围 (每次查询的价格) |
||
---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.008 美元/次 (8.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
对于 Maps JavaScript API 的“路线”服务或使用以下一项或多项内容的 Directions API 请求,您需要支付“高级路线”SKU 费用:
- 路况信息。在满足以下所有条件(在路线响应中收到
duration_in_traffic
字段的必要条件)时会使用路况信息:- travel
mode
参数为driving
或未指定(driving
为默认出行方式)。 - 请求包含有效的
departure_time
参数。departure_time
可设置为当前时间或未来的某个时间,但不能是过去的时间。 - 请求不包含停靠航点。如果请求包含航点,请为每个航点添加
via:
前缀来影响路线,但要避免停靠。例如,&waypoints=via:San Francisco|via:Mountain View|...
- travel
- 超过 10 个航点(介于 11 到 25 之间)。
- 航点优化。航点的
optimize
参数设为true
。例如,&waypoints=optimize:true|San Francisco|Mountain View|...
- 位置修饰符。当您使用以下位置修饰符指引司机应如何抵达特定位置时:
side_of_road
heading
SKU:距离矩阵
对 Distance Matrix API 或 Maps JavaScript API 的“距离矩阵”服务的请求(触发高级距离矩阵结算 SKU 的请求除外)。
每月用量范围 (每个元素的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
发送至 Distance Matrix API 的每个查询都会生成元素,origins
数量与 destinations
数量的乘积便是元素数量。
SKU:高级距离矩阵
对 Distance Matrix API 或使用路况信息和/或位置修饰符的 Maps JavaScript API“距离矩阵”服务的请求。
每月用量范围 (每个元素的价格) |
||
---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.008 美元/次 (8.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
发送至 Distance Matrix API 的每个查询都会生成元素,origins
数量与 destinations
数量的乘积便是元素数量。
对于 Distance Matrix API 或使用以下一项或多项内容的 Maps JavaScript API“距离矩阵”服务请求,您需要支付“高级距离矩阵”SKU 费用:
- 路况信息。在满足以下所有条件(在距离矩阵响应中收到
duration_in_traffic
字段的必要条件)时会使用路况信息:- travel
mode
参数为driving
或未指定(driving
为默认出行方式)。 - 请求包含有效的
departure_time
参数。departure_time
可设置为当前时间或未来的某个时间,但不能是过去的时间。
- travel
- 位置修饰符。当您使用以下位置修饰符指引司机应如何抵达特定位置时:
side_of_road
heading
SKU:道路 - 已行驶路线
对 Roads API 的“沿实际道路”服务的请求。
每月用量范围 (每次查询的价格) |
||
---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.008 美元/次 (8.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:道路 - 最近的道路
对 Roads API 的“最近的道路”服务的请求。
每月用量范围 (每次查询的价格) |
||
---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.008 美元/次 (8.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:道路 - 速度限制
对 Roads API 的“速度限制”服务的请求。每月用量范围 (每个元素的价格) |
||
---|---|---|
0.02 美元/个 (20.00 美元/千个) |
0.016 美元/个 (16.00 美元/千个) |
如需了解批量定价,请与销售人员联系 |
“速度限制”请求的费用按 API 响应中返回的速度限制元素数计算。此数量始终不超过原始请求中传递的数据点的数量。
SKU:路线:计算路线 - 基本
对计算路线服务的请求。
每月用量范围 (每次查询的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:路线:计算路线 - 高级
使用高级地图项的计算路线服务请求。
每月用量范围 (每次查询的价格) |
||
---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.008 美元/次 (8.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
对于使用以下一项或多项地图项的计算路线服务请求,您需要支付高级 SKU 的费用:
- 11 到 25 个中间航点
- 可感知路况的路线或可感知路况的最佳路线。这些路线选项相当于将请求中的
routingPreference
属性设置为TRAFFIC_AWARE
或TRAFFIC_AWARE_OPTIMAL
。 - 位置修饰符。当使用以下选项指引司机应如何抵达特定位置时:
SKU:路线:计算路线 - 首选
对使用首选地图项的计算路线服务的请求。
每月用量范围 (每次查询的价格) |
||
---|---|---|
0.015 美元/个 (15.00 美元/千个) |
0.012 美元/个 (12.00 美元/千个) |
如需了解批量定价,请与销售人员联系 |
对于使用以下一项或多项地图项的计算路线服务请求,您需要支付首选 SKU 的费用:
SKU:路线:计算路线矩阵 - 基本
对计算路线矩阵服务的请求。
每月用量范围 (每个元素的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:路线:计算路线矩阵 - 高级
使用高级地图项的计算路线矩阵服务请求。
每月用量范围 (每个元素的价格) |
||
---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.008 美元/次 (8.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
对于使用以下一项或多项地图项的计算路线矩阵服务请求,您需要支付高级 SKU 的费用:
- 可感知路况的路线或可感知路况的最佳路线。这些路线选项相当于将请求中的
routingPreference
属性设置为TRAFFIC_AWARE
或TRAFFIC_AWARE_OPTIMAL
。 - 位置修饰符。当使用以下选项指引司机应如何抵达特定位置时:
SKU:路线:计算路线矩阵 - 首选
对使用首选地图项的计算路线矩阵服务的请求。
每月用量范围 (每个元素的价格) |
||
---|---|---|
0.015 美元/个 (15.00 美元/千个) |
0.012 美元/个 (12.00 美元/千个) |
如需了解批量定价,请与销售人员联系 |
对于使用以下一项或多项地图项的计算路线矩阵服务请求,您需要支付首选 SKU 的费用:
SKU:路线优化:单车路线
对 的请求 Route Optimization API 仅指定一辆车。
每月用量范围 (每次配送的价格) |
||
---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:路线优化:舰队路线
对 的请求 Route Optimization API 指定多辆车。
每月用量范围 (每次配送的价格) |
||
---|---|---|
0.03 美元/次 (30.00 美元/千次) |
0.014 美元/张 (14.00 美元/千张) |
如需了解批量定价,请与销售人员联系 |
地点(新)产品 SKU
关于字段掩码
在请求中使用字段掩码(也称为字段列表),以指定要在响应中返回的字段列表。然后,我们会按适用于您请求的最高 SKU 进行结算。这意味着,如果您同时选择了“(基本)SKU”和“(高级)SKU”中的字段,我们会根据“(高级)SKU”进行结算。
使用字段掩码是一种有效的设计做法,可确保您不会请求不必要的数据,这有助于避免产生不必要的处理时间和结算费用。
“自动补全(新)”会话简介
一个“自动补全(新)”会话包含一个或多个“自动补全(新)”请求,以及一个 “地点详情(新)”请求或“地址验证”请求。系统会将同一个会话令牌 “自动补全(新)”请求以及后续的“地点详情(新)”请求或地址验证请求 请求。
第一个“自动补全(新)”请求发出时,会话开始。“地点详情(新)”请求或 然后,当用户选择其中一个“自动补全(新)”选项时,系统会发出地址验证请求 建议。如果会话被放弃,则意味着没有“地点详情(新)”请求或 发出地址验证请求后,系统会按照没有会话令牌的情况计费“自动补全(新)”请求 已提供。
在用户选择地点(包括“地点详情(新)”请求或地址验证)后 请求),则必须使用新会话令牌启动新会话。
会话令牌非常适合一个会话,但不能用于多个会话 会话。如果您重复使用某个会话令牌,相应会话会被视为无效,并且系统会按未提供会话令牌的情况为请求计费。
SKU:“自动补全”请求
您需要为向 不包含会话令牌的 Autocomplete(新)API。
如果您使用会话令牌并且符合以下任一条件,那么系统也会向您收取费用:
- 通过向“地点详情”发出单个请求来终止会话(新),
用于请求由 SKU:地点详情(仅限位置)定义的所有字段。
- 每个“自动补全(新)”请求(最多 12 个)按 SKU:自动补全请求。
- 每个后续的“自动补全(新)”请求都按 SKU:自动补全会话使用情况。
- 您可以放弃会话或结束会话,只需调用 SKU:地点详情(仅 ID)。然后,系统会对所有“自动补全(新)”请求进行结算 使用 SKU:自动补全请求。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.00283 美元/次 (2.83 美元/千次) |
0.00227 美元/次 (2.27 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:自动补全会话使用情况
对于向 Google 发送的每个请求,您需要支付自动补全会话使用情况 SKU 费用 包含会话令牌的 Autocomplete(新)API。
此 SKU 在以下情况下收费:
通过调用 SKU:地点详情(仅限位置)来终止“自动补全”会话:
- 每个“自动补全(新)”请求(最多 12 个)按 SKU:自动补全请求。
- 每个后续的“自动补全(新)”请求都按 SKU:自动补全会话使用情况。
“自动补全”会话因调用 SKU:地点详情而终止 (“基本”、“高级”或“首选”)。
“地点详情”调用请求任意字段 SKU:地点详情(基本版、高级版或首选)按照 SKU:地点详情(首选)。
“自动补全”会话因调用 SKU:地址验证而终止 首选。
如需了解详情,请参阅 自动补全(新)和会话定价。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.00 美元/次 (0.00 美元/千次) |
0.00 美元/次 (0.00 美元/千次) |
0.00 美元/次 (0.00 美元/千次) |
SKU:地点详情(仅 ID)
<ph type="x-smartling-placeholder">通过在“地点详情(新)”请求中使用字段掩码或字段列表,您可以限制响应仅包含指定的字段。如果您只 请求以下字段:
Android:Place.Field.ID
、Place.Field.NAME
、Place.Field.PHOTO_METADATAS
Maps JavaScript API 地点库:
id
,
photos
iOS:
GMSPlacePropertyPlaceID
,
GMSPlacePropertyName
,
GMSPlacePropertyPhotos
Web 服务:
attributions
,
id
,
name
*、
photos
* name
字段包含地点的资源名称
格式为:places/PLACE_ID
。使用displayName
来访问地点的文本名称。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.0 美元/次 (0.00 美元/千次) |
0.0 美元/次 (0.00 美元/千次) |
0.0 美元/次 (0.00 美元/千次) |
SKU:地点详情(仅限位置)
通过在“地点详情(新)”请求中使用字段掩码或字段列表,您可以限制响应仅包含指定的字段。当您仅请求以下字段时,会触发此 SKU:
Android:
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.ADDRESS
,
Place.Field.LAT_LNG
,
Place.Field.PLUS_CODE
,
Place.Field.TYPES
,
Place.Field.VIEWPORT
Maps JavaScript API 地点库:
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
types
,
viewport
iOS:
GMSPlacePropertyAddressComponents
,
GMSPlacePropertyFormattedAddress
,
GMSPlacePropertyCoordinate
,
GMSPlacePropertyPlusCode
,
GMSPlacePropertyTypes
,
GMSPlacePropertyViewport
Web 服务:
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
shortFormattedAddress
,
types
,
viewport
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:地点详情(基本)
通过在“地点详情(新)”请求中使用字段掩码或字段列表,您可以限制响应仅包含指定的字段。当您仅请求以下字段时,会触发此 SKU:
Android:
Place.Field.BUSINESS_STATUS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.UTC_OFFSET
,
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Maps JavaScript API 地点库:
accessibilityOptions
,
businessStatus
,
displayName
,
googleMapsUri
,
iconBackgroundColor
,
primaryTypeDisplayName
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
iOS:
GMSPlacePropertyBusinessStatus
,
GMSPlacePropertyIconBackgroundColor
,
GMSPlacePropertyIconImageURL
,
GMSPlacePropertyUTCOffsetMinutes
,
GMSPlacePropertyWheelchairAccessibleEntrance
网络服务:accessibilityOptions
、businessStatus
、displayName
、googleMapsUri
、iconBackgroundColor
、iconMaskBaseUri
、primaryType
、primaryTypeDisplayName
、subDestinations
、utcOffsetMinutes
如果“自动补全”会话因调用“地点详情”而终止 请求任何字段(从 SKU:地点详情(基本、高级或首选),则通话将按以下方式结算: SKU:地点详情(首选)。如需了解详情,请参阅 SKU:自动补全会话使用情况。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.0170 美元/次 (17.00 美元/千次) |
0.0136 美元/次 (13.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:地点详情(高级)
通过在“地点详情(新)”请求中使用字段掩码或字段列表,您可以限制响应仅包含指定的字段。当您仅请求以下字段时,会触发此 SKU:
Android:Place.Field.CURRENT_OPENING_HOURS
、Place.Field.SECONDARY_OPENING_HOURS
、Place.Field.PHONE_NUMBER
、Place.Field.PRICE_LEVEL
、Place.Field.RATING
、Place.Field.OPENING_HOURS
、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
网络服务:currentOpeningHours
、currentSecondaryOpeningHours
、internationalPhoneNumber
、nationalPhoneNumber
、priceLevel
、rating
、regularOpeningHours
、regularSecondaryOpeningHours
、userRatingCount
、websiteUri
如果“自动补全”会话因调用“地点详情”而终止 请求任何字段(从 SKU:地点详情(基本、高级或首选),则通话将按以下方式结算: SKU:地点详情(首选)。如需了解详情,请参阅 SKU:自动补全会话使用情况。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.020 美元/次 (20.00 美元/千次) |
0.016 美元/次 (16.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:地点详情(首选)
通过在“地点详情(新)”请求中使用字段掩码或字段列表,您可以限制响应仅包含指定的字段。当您仅请求以下字段时,会触发此 SKU:
Android:Place.Field.CURBSIDE_PICKUP
、Place.Field.DELIVERY
、Place.Field.DINE_IN
、Place.Field.EDITORIAL_SUMMARY
、Place.Field.RESERVABLE
、Place.Field.REVIEWS
、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
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
iOS:
GMSPlacePropertyCurbsidePickup
,
GMSPlacePropertyDelivery
,
GMSPlacePropertyDineIn
,
GMSPlacePropertyEditorialSummary
,
GMSPlacePropertyReservable
,
GMSPlacePropertyReviews
,
GMSPlacePropertyServesBeer
,
GMSPlacePropertyServesBreakfast
,
GMSPlacePropertyServesBrunch
,
GMSPlacePropertyServesDinner
,
GMSPlacePropertyServesLunch
,
GMSPlacePropertyServesVegetarianFood
,
GMSPlacePropertyServesWine
,
GMSPlacePropertyTakeout
Web 服务:
allowsDogs
,
curbsidePickup
,
delivery
,
dineIn
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
goodForChildren
,
goodForGroups
,
goodForWatchingSports
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
outdoorSeating
,
reservable
,
restroom
,
reviews
,
servesBeer
,
servesBreakfast
,
servesBrunch
,
servesCocktails
,
servesCoffee
,
servesDessert
,
servesDinner
,
servesLunch
,
servesVegetarianFood
,
servesWine
,
takeout
如果“自动补全”会话因调用“地点详情”而终止 请求任何字段(从 SKU:地点详情(基本、高级或首选),则通话将按以下方式结算: SKU:地点详情(首选)。如需了解详情,请参阅 SKU:自动补全会话使用情况。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.025 美元/次 (25.00 美元/千次) |
0.020 美元/次 (20.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:附近搜索(基本)
在“附近搜索(新)”请求中使用字段掩码或字段列表,您可以限制 对指定的字段进行响应。当您仅请求以下字段时,会触发此 SKU:
Android:
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.ADDRESS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.LAT_LNG
,
Place.Field.PHOTO_METADATAS
,
Place.Field.PLUS_CODE
,
Place.Field.ID
,
Place.Field.NAME
,
Place.Field.TYPES
,
Place.Field.UTC_OFFSET
,
Place.Field.VIEWPORT
,
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Maps JavaScript API 地点库:
accessibilityOptions
,
addressComponents
,
adrFormatAddress
,
businessStatus
,
displayName
,
formattedAddress
,
googleMapsUri
,
iconBackgroundColor
,
id
,
location
,
photos
,
plusCode
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
,
viewport
iOS:
GMSPlacePropertyAddressComponents
,
GMSPlacePropertyBusinessStatus
,
GMSPlacePropertyCoordinate
,
GMSPlacePropertyFormattedAddress
,
GMSPlacePropertyName
,
GMSPlacePropertyIconBackgroundColor
,
GMSPlacePropertyIconImageURL
,
GMSPlacePropertyPhotos
,
GMSPlacePropertyPlaceID
,
GMSPlacePropertyPlusCode
,
GMSPlacePropertyTypes
,
GMSPlacePropertyUTCOffsetMinutes
,
GMSPlacePropertyViewport
,
GMSPlacePropertyWheelchairAccessibleEntrance
Web 服务:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.attributions
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.id
,
places.location
,
places.name
*、
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.subDestinations
,
places.types
,
places.utcOffsetMinutes
,
places.viewport
* places.name
字段包含地点资源名称
格式:places/PLACE_ID
。使用places.displayName
来访问地点的文本名称。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.032 美元/次 (32.00 美元/千次) |
0.0256 美元/次 (25.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:附近搜索(高级)
<ph type="x-smartling-placeholder">在“附近搜索(新)”请求中使用字段掩码或字段列表,您可以限制 对指定的字段进行响应。当您仅请求以下字段时,会触发此 SKU:
Android:Place.Field.CURRENT_OPENING_HOURS
、Place.Field.SECONDARY_OPENING_HOURS
、Place.Field.PHONE_NUMBER
、Place.Field.PRICE_LEVEL
、Place.Field.RATING
、Place.Field.OPENING_HOURS
、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
网络服务:places.currentOpeningHours
、places.currentSecondaryOpeningHours
、places.internationalPhoneNumber
、places.nationalPhoneNumber
、places.priceLevel
、places.rating
、places.regularOpeningHours
、places.regularSecondaryOpeningHours
、places.userRatingCount
、places.websiteUri
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.035 美元/次 (35.00 美元/千次) |
0.028 美元/次 (28.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:附近搜索(首选)
在“附近搜索(新)”请求中使用字段掩码或字段列表,您可以限制 对指定的字段进行响应。当您仅请求以下字段时,会触发此 SKU:
Android:Place.Field.CURBSIDE_PICKUP
、Place.Field.DELIVERY
、Place.Field.DINE_IN
、Place.Field.EDITORIAL_SUMMARY
、Place.Field.RESERVABLE
、Place.Field.REVIEWS
、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
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
iOS:
GMSPlacePropertyCurbsidePickup
,
GMSPlacePropertyDelivery
,
GMSPlacePropertyDineIn
,
GMSPlacePropertyEditorialSummary
,
GMSPlacePropertyReservable
,
GMSPlacePropertyReviews
,
GMSPlacePropertyServesBeer
,
GMSPlacePropertyServesBreakfast
,
GMSPlacePropertyServesBrunch
,
GMSPlacePropertyServesDinner
,
GMSPlacePropertyServesLunch
,
GMSPlacePropertyServesVegetarianFood
,
GMSPlacePropertyServesWine
,
GMSPlacePropertyTakeout
Web 服务:
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.servesBeer
,
places.servesBreakfast
,
places.servesBrunch
,
places.servesCocktails
,
places.servesCoffee
,
places.servesDessert
,
places.servesDinner
,
places.servesLunch
,
places.servesVegetarianFood
,
places.servesWine
,
places.takeout
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.040 美元/次 (40.00 美元/千次) |
0.032 美元/次 (32.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:文本搜索(仅 ID)
在“文本搜索(新)”请求中使用字段掩码或字段列表,可以限制 对指定的字段进行响应。当您仅请求以下字段时,会触发此 SKU:
Android:Place.Field.ID
、Place.Field.NAME
iOS:
GMSPlacePropertyPlaceID
,
GMSPlacePropertyName
Maps JavaScript API 地点库:
id
Web 服务:
places.attributions
,
places.id
,
places.name
*、
nextPageToken
* places.name
字段包含地点的资源名称
格式为:places/PLACE_ID
。使用places.displayName
来访问地点的文本名称。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.0 美元/次 (0.00 美元/千次) |
0.0 美元/次 (0.00 美元/千次) |
0.0 美元/次 (0.00 美元/千次) |
SKU:文本搜索(基本)
在“文本搜索(新)”请求中使用字段掩码或字段列表,可以限制 对指定的字段进行响应。当您仅请求以下字段时,会触发此 SKU:
Android:Place.Field.ADDRESS_COMPONENTS
、Place.Field.BUSINESS_STATUS
、Place.Field.ADDRESS
、Place.Field.ICON_BACKGROUND_COLOR
、Place.Field.ICON_URL
、Place.Field.LAT_LNG
、Place.Field.PHOTO_METADATAS
、Place.Field.PLUS_CODE
、Place.Field.TYPES
、Place.Field.UTC_OFFSET
、Place.Field.VIEWPORT
、Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
iOS:
GMSPlacePropertyAddressComponents
,
GMSPlacePropertyBusinessStatus
,
GMSPlacePropertyFormattedAddress
,
GMSPlacePropertyIconBackgroundColor
,
GMSPlacePropertyIconImageURL
,
GMSPlacePropertyCoordinate
,
GMSPlacePropertyPhotos
,
GMSPlacePropertyPlusCode
,
GMSPlacePropertyTypes
,
GMSPlacePropertyUTCOffsetMinutes
,
GMSPlacePropertyViewport
,
GMSPlacePropertyWheelchairAccessibleEntrance
Maps JavaScript API 地点库:
accessibilityOptions
,
addressComponents
,
adrFormatAddress
,
businessStatus
,
displayName
,
formattedAddress
,
googleMapsUri
,
iconBackgroundColor
,
location
,
photos
,
plusCode
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
,
viewport
网络服务:places.accessibilityOptions
、places.addressComponents
、places.adrFormatAddress
、places.businessStatus
、places.displayName
、places.formattedAddress
、places.googleMapsUri
、places.iconBackgroundColor
、places.iconMaskBaseUri
、places.location
、places.photos
、places.plusCode
、places.primaryType
、places.primaryTypeDisplayName
、places.shortFormattedAddress
、places.subDestinations
、places.types
、places.utcOffsetMinutes
、places.viewport
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.032 美元/次 (32.00 美元/千次) |
0.0256 美元/次 (25.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:文本搜索(高级)
在“文本搜索(新)”请求中使用字段掩码或字段列表,可以限制 对指定的字段进行响应。当您仅请求以下字段时,会触发此 SKU:
Android:Place.Field.CURRENT_OPENING_HOURS
、Place.Field.SECONDARY_OPENING_HOURS
、Place.Field.PHONE_NUMBER
、Place.Field.PRICE_LEVEL
、Place.Field.RATING
、Place.Field.OPENING_HOURS
、Place.Field.USER_RATINGS_TOTAL
、Place.Field.WEBSITE_URI
iOS:
GMSPlacePropertyCurrentOpeningHours
,
GMSPlacePropertySecondaryOpeningHours
,
GMSPlacePropertyPhoneNumber
,
GMSPlacePropertyPriceLevel
,
GMSPlacePropertyRating
,
GMSPlacePropertyOpeningHours
,
GMSPlacePropertyUserRatingsTotal
,
GMSPlacePropertyWebsite
网络服务:places.currentOpeningHours
、places.currentSecondaryOpeningHours
、places.internationalPhoneNumber
、places.nationalPhoneNumber
、places.priceLevel
、places.rating
、places.regularOpeningHours
、places.regularSecondaryOpeningHours
、places.userRatingCount
、places.websiteUri
Maps JavaScript API 地点库:
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
userRatingCount
,
websiteUri
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.035 美元/次 (35.00 美元/千次) |
0.028 美元/次 (28.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:文本搜索(首选)
在“文本搜索(新)”请求中使用字段掩码或字段列表,可以限制 对指定的字段进行响应。当您仅请求以下字段时,会触发此 SKU:
Android:Place.Field.CURBSIDE_PICKUP
、Place.Field.DELIVERY
、Place.Field.DINE_IN
、Place.Field.EDITORIAL_SUMMARY
、Place.Field.RESERVABLE
、Place.Field.REVIEWS
、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
iOS:
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 服务:
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.servesBeer
,
places.servesBreakfast
,
places.servesBrunch
,
places.servesCocktails
,
places.servesCoffee
,
places.servesDessert
,
places.servesDinner
,
places.servesLunch
,
places.servesVegetarianFood
,
places.servesWine
,
places.takeout
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.040 美元/次 (40.00 美元/千次) |
0.032 美元/次 (32.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:Place Photo
每次向 API 发出请求都需支付 Place Photo SKU 费用。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.007 美元/次 (7.00 美元/千次) |
0.0056 美元/次 (5.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
地点产品 SKU
地点产品中的 API 包括:Places API、Places SDK for Android、Places SDK for iOS、Maps JavaScript API 地点库、Geocoding API、Geolocation API、Time Zone API 和 Elevation API。
关于“自动补全”会话
“自动补全”会话包含一些“自动补全”请求(用于在用户输入内容时检索建议地点),以及最多一个“地点详情”请求(用于检索与用户所选的地点有关的详细信息)。系统会将同一个会话令牌传递给“自动补全”请求和随后的“地点详情”请求。第一个“自动补全”请求发出时(通常是在用户开始输入时),会话开始。在用户选择其中一条“自动补全”建议后,系统会执行“地点详情”调用。如果用户未选择建议,系统不会执行“地点详情”调用。
在用户选择地点(即系统执行“地点详情”调用)后,您必须使用新的会话令牌启动新会话。
“自动补全”会话可以通过以下 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:基本数据
在“地点详情”请求或“查找地点”请求中使用 fields 参数时,您可以将响应限制为仅包含指定的字段。基本类别中的字段的费用包含在地点请求的基本费用中,它们不会产生任何额外费用。系统会在收到以下任一字段请求时触发基本数据 SKU:
-
Android:
Place.Field.ADDRESS
、Place.Field.ADDRESS_COMPONENTS
、Place.Field.BUSINESS_STATUS
、Place.Field.ICON_BACKGROUND_COLOR
、Place.Field.ICON_URL
、Place.Field.ID
、Place.Field.LAT_LNG
、Place.Field.NAME
、Place.Field.PHOTO_METADATAS
、Place.Field.PLUS_CODE
、Place.Field.TYPES
、Place.Field.VIEWPORT
、Place.Field.UTC_OFFSET
或Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
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.00 美元 |
地点请求费用 + 0.00 美元 |
地点请求费用 + 0.00 美元 |
SKU:联系人数据
在“地点详情”请求或“查找地点”请求中使用 fields 参数时(对于网络服务),或使用 Place.Field
数组时(对于 Android 或 iOS),您可以将响应限制为仅包含指定的字段。联系人类别中的字段会产生额外费用。系统会在收到以下任一字段请求时触发联系人数据 SKU:
-
Android:
Place.Field.CURRENT_OPENING_HOURS
、Place.Field.OPENING_HOURS
、Place.Field.PHONE_NUMBER
、Place.Field.SECONDARY_OPENING_HOURS
或Place.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
、GMSPlaceFieldPhoneNumber
或GMSPlaceFieldWebsite
-
网络服务:
formatted_phone_number
、international_phone_number
、opening_hours
、current_opening_hours
、secondary_opening_hours
或website
每月用量范围 (每次调用的价格) |
||
---|---|---|
地点请求费用 + 0.003 美元/次 (+ 3.00 美元/千次) |
地点请求费用 + 0.0024 美元/次 (+ 2.40 美元/千次) |
如需了解批量定价,请与销售人员联系 |
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_RATINGS_TOTAL
- 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.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.00283 美元/次 (2.83 美元/千次) |
0.00227 美元/次 (2.27 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:自动补全(不含地点详情)- 按会话结算
对于不包含“地点详情”请求的“自动补全”会话,您需要(在会话开始的几分钟内)支付自动补全(不含地点详情)- 按会话结算 SKU 费用。
每月用量范围 (每次会话的价格) |
||
---|---|---|
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 的费用:
- Android:对
fetchPlace()
的调用 - iOS:对
fetchPlaceFromPlaceID:
的调用 - 网络服务:“地点详情”请求
“自动补全”请求是免费的,随后的“地点详情”调用需按常规的地点详情定价支付费用。
“地点详情”请求会生成数据 SKU(基本数据、联系人数据和/或氛围数据),具体取决于请求中指定的字段。
如果您未在“地点详情”请求中指定字段,系统会触发所有数据 SKU(基本数据、联系人数据和氛围数据)。
在“自动补全”会话期间,地点详情 ID 刷新请求(仅指定 place_id
字段的请求)将按 SKU:自动补全(不含地点详情)- 按会话结算计费。
每月用量范围 (每次会话的价格) |
||
---|---|---|
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.00283 美元/次 (2.83 美元/千次) |
0.00227 美元/次 (2.27 美元/千次) |
如需了解批量定价,请与销售人员联系 |
使用“查询自动补全”时,不支持按“自动补全”会话定价。随后的“地点详情”调用需按常规的地点详情定价支付费用。
SKU:地点详情
地点详情调用的计费方式如下:
每月用量范围 (每次调用的价格) |
||
---|---|---|
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,并且您需要支付“地点详情”调用或请求费用以及所有数据的费用。
示例
- 发出以下某项调用或请求:
- 移动设备:在 Android 上调用
fetchPlace()
,或在 iOS 上调用fetchPlaceFromPlaceID:
,且仅指定ADDRESS
字段 - 网络 API 或服务:发出“地点详情”请求,且仅指定“地址”字段:
getPlaceDetails(fields: formatted_address)
- 地点详情(每次会话最低 0.017 美元)
- 基本数据(费用为 0.00 美元)
- 移动设备:在 Android 上调用
- 发出以下某项调用或请求:
- 移动设备:在 Android 上调用
fetchPlace()
,或在 iOS 上调用fetchPlaceFromPlaceID:
,且仅指定PHONE_NUMBER
字段 - 网络 API 或服务:发出“地点详情”请求并指定“电话号码”字段:
getPlaceDetails(fields: formatted_phone_number)
- 地点详情(每次会话最低 0.017 美元)
- 联系人数据(每次请求最低 0.003 美元)
- 移动设备:在 Android 上调用
- 发出以下某项调用或请求:
- 移动设备:在 Android 上调用
fetchPlace()
,或在 iOS 上调用fetchPlaceFromPlaceID:
,并指定所有字段 - 网络 API 或服务:发出“地点详情”请求并指定所有字段(如果您未指定任何字段,系统将默认发出此类请求):
getPlaceDetails()
。
- 地点详情(每次会话最低 0.017 美元)
- 基本数据(费用为 0.00 美元)
- 联系人数据(每次请求最低 0.003 美元)
- 氛围数据(每次请求最低 0.005 美元)
- 移动设备:在 Android 上调用
SKU:地点详情 - ID 刷新
您可以使用“地点详情”请求刷新过时的地点 ID。这些类型的请求是免费的。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.00 美元 | 0.00 美元 | 0.00 美元 |
示例
发出仅指定“地点 ID”字段的“地点详情”请求:getPlaceDetails(fields: place_id)
。您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
- 地点详情 – ID 刷新(费用为 0.00 美元)
SKU:查找地点
您需要为“查找地点”请求支付查找地点 SKU 费用。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.017 美元/次 (17.00 美元/千次) |
0.0136 美元/次 (13.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
“查找地点”请求还会生成数据 SKU(基本数据、联系人数据和/或氛围数据),具体取决于请求中指定的字段。与“地点详情”请求一样,您可以在“查找地点”请求中使用 fields 参数,将响应限制为仅包含指定的字段。您需要为“查找地点”请求和所请求的数据付费。默认情况下,如果未请求任何字段,系统仅会返回地点 ID,因此也就不会产生额外的数据费用。
示例
- 您发出“查找地点”请求并仅指定“地址”字段:
FindPlace(fields: formatted_address)
。您会看到账单中列出了以下 SKU(按 SKU 查看账单时):- 查找地点(每次调用最低 0.017 美元)
- 基本数据(费用为 0.00 美元)
- 您发出“查找地点”请求并指定“电话号码”字段:
FindPlace(fields: formatted_phone_number)
。您会看到账单中列出了以下 SKU(按 SKU 查看账单时):- 查找地点(每次调用最低 0.017 美元)
- 联系人数据(每次请求最低 0.003 美元)
- 您发出“查找地点”请求并指定所有三个数据类型范畴的字段:
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.00 美元 | 0.00 美元 | 0.00 美元 |
示例
您发出“查找地点”请求并仅指定 place_id
字段:FindPlace(fields: place_id)
。您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
- 查找地点 - 仅返回 ID(费用为 0.00 美元)
SKU:查找当前地点
对于 findCurrentPlace()
(Android) 和 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) 的调用,您需要支付查找当前地点 SKU 费用。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.030 美元/次 (30.00 美元/千次) |
0.024 美元/次 (24.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
对 findCurrentPlace()
(Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) 的调用还会生成数据 SKU(基本数据、联系人数据和/或氛围数据),具体取决于调用中指定的字段。指定数据字段,可以将响应限制为仅包含这些字段。您需要为“查找当前地点”调用以及所请求的数据付费。
示例
- 您调用
findCurrentPlace()
(Android) 或findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS),并仅指定ADDRESS
字段。您会看到账单中列出了以下 SKU(按 SKU 查看账单时):- 查找当前地点(每次请求最低 0.030 美元)
- 基本数据(费用为 0.00 美元)
- 您调用
findCurrentPlace()
(Android) 或findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS),并指定PHONE_NUMBER
字段。您会看到账单中列出了以下 SKU(按 SKU 查看账单时):- 查找当前地点(每次请求最低 0.030 美元)
- 联系人数据(每次请求最低 0.003 美元)
- 您调用
findCurrentPlace()
(Android) 或findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS),并指定所有三个数据类型范畴的字段。您会看到账单中列出了以下 SKU(按 SKU 查看账单时):- 查找当前地点(每次请求最低 0.030 美元)
- 基本数据(费用为 0.00 美元)
- 联系人数据(每次请求最低 0.003 美元)
- 氛围数据(每次请求最低 0.005 美元)
SKU:地点 - 附近搜索
对于向 Maps JavaScript API 的“地点附近搜索”服务 (nearbySearch()
) 或 Places API 的“附近搜索”服务发出的请求,您需要支付地点 - 附近搜索费用
每月用量范围 (每次调用的价格) |
||
---|---|---|
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.032 美元/次 (32.00 美元/千次) |
0.0256 美元/次 (25.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
“文本搜索”请求会返回地点列表,但不支持指定返回哪些字段。“文本搜索”请求会返回受支持的数据字段子集。您需要为“文本搜索”请求(每次请求最低 0.032 美元)以及所有数据类型的 SKU(基本数据、联系人数据和氛围数据)付费。
“地点 - 文本搜索”SKU 也由 Maps JavaScript API 的地点搜索框 widget 生成:用户选择地点查询(图标:放大镜)而不是结果(图标:图钉)后调用的 getPlaces()
方法,如下所示:
![地点详情搜索框 widget 查询选择](https://developers.google.cn/static/maps/billing/images/places-details-search-box-widget-query.png?authuser=1&hl=hr)
示例
您发出“文本搜索”请求,例如 TextSearch(123 Main Street)
。您会看到账单中列出了以下 SKU(按 SKU 查看账单时):
- 地点 - 文本搜索(每次调用最低 0.032 美元)
- 基本数据(费用为 0.00 美元)
- 联系人数据(每次请求最低 0.003 美元)
- 氛围数据(每次请求最低 0.005 美元)
SKU:Place Photo
您需要为以下行为支付 Place Photo SKU 费用:
- Android:对
fetchPhoto()
的调用 - iOS:对
loadPlacePhoto:
的调用 - JavaScript:从
PlacePhoto.getUrl()
返回的网址中请求数据以加载图片像素数据时,对于向 Maps JavaScript API 地点库的“Place Photo”服务发出的请求,您需要支付相应费用 - 网络服务:对 Places API Place Photo 服务的请求
对于 JavaScript 服务,在将网址实际用于获取像素数据之前,调用 PlacePhoto.getUrl()
方法不会产生账单费用。
每月用量范围 (每次调用的价格) |
||
---|---|---|
0.007 美元/次 (7.00 美元/千次) |
0.0056 美元/次 (5.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:地理编码
对于向 Maps JavaScript API 的“地理编码”服务或 Geocoding API 发出的请求,您需要支付地理编码 SKU 费用。在 JavaScript 中,Geocoder.geocode()
方法会向地理编码服务发起请求。
每月用量范围 (每次请求的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:地理定位
对于向 Geolocation API 发出的请求,您需要支付地理定位 SKU 费用。
每月用量范围 (每次请求的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:Map Tiles API:2D 地图图块
向 Map Tiles API 发出的检索路线图、卫星或地形图块的请求。请注意,会话令牌和视口信息请求不计费。
每月用量范围 (每次请求的价格) |
|||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 超过 5,000,001 | |||
0.0006 美元/次 (0.60 美元/千次) |
0.00048 美元/次 (0.48 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:Map Tiles API:街景图块
向 Map Tiles API 发出的检索街景图块、街景缩略图或街景全景图 ID 的请求。请注意,会话令牌和街景元数据请求不计费。
每月用量范围 (每次请求的价格) |
|||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 超过 5,000,001 | |||
0.002 美元/次 (2.00 美元/千次) |
0.0016 美元/次 (1.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:Map Tiles API:仿真 3D 图块
向 Map Tiles API 发出的检索 3D 根图块的请求。
每月用量范围 (每次请求的价格) |
|||||
---|---|---|---|---|---|
0.006 美元/次 (6.00 美元/千次) |
0.0051 美元/次 (5.10 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:时区
对于向 Time Zone API 发出的请求,您需要支付时区 SKU 费用。
每月用量范围 (每次请求的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:海拔
对于向 Maps JavaScript API 的“海拔”服务或 Elevation API 发出的请求,您需要支付海拔 SKU 费用。
每月用量范围 (每次请求的价格) |
||
---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:地址验证
对 Address Validation API 的 validateAddress 方法 (REST) 和 ValidateAddress 方法 (gRPC) 的请求。
每月用量范围 (每次请求的价格) |
||
---|---|---|
0.017 美元/次 (17.00 美元/千次) |
0.0136 美元/次 (13.60 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:首选地址验证
首选地址验证服务适用于 自动补全(新) 端点。 调用 Address Validation API。具体而言,使用“自动补全”(新)的会话 并终止对 validateAddress (REST) 或 ValidateAddress (gRPC) 位于此价格模式中。
有关定价和使用包含以下内容的“自动补全(新)”会话的详细信息 Places API,请参阅 请参阅 Places API 中的以下指南 文档:
如果在“自动补全(新)”会话结束时使用地址验证首选选项, 您的结算方式如下:
每月用量范围 (每次请求的价格) |
||
---|---|---|
0.025 美元/次 (25.00 美元/千次) |
0.020 美元/次 (20.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
环境产品 SKU
环境方面的 API 包括:Air Quality API、Pollen API 和 Solar API。
SKU:空气质量
此 SKU 适用于以下端点和方法:
每月用量范围 (每次请求的价格) |
|||||
---|---|---|---|---|---|
0.005 美元/次 (5.00 美元/千次) |
0.004 美元/次 (4.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:花粉
此 SKU 适用于以下端点/方法:
每月用量范围 (每次请求的价格) |
|||||
---|---|---|---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.008 美元/次 (8.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:太阳能建筑数据分析
对 buildingInsights 的请求。
每月用量范围 (每次请求的价格) |
|||||
---|---|---|---|---|---|
0.01 美元/次 (10.00 美元/千次) |
0.005 美元/次 (5.00 美元/千次) |
如需了解批量定价,请与销售人员联系 |
SKU:太阳能数据层
对 dataLayers 的请求。
通过同一请求访问多个图片网址不会产生额外的收费查询。每月用量范围 (每次请求的价格) |
|||||
---|---|---|---|---|---|
0.075 美元/次 (75.00 美元/千次) |
0.0375 美元/次 (37.50 美元/千次) |
如需了解批量定价,请与销售人员联系 |