Google Maps Platform 定价

本部分列出了针对 Google Maps Platform 核心产品定义的各种 SKU。核心产品采用随用随付定价模式，您只需为所使用的 SKU 付费。

对于列出的每个 SKU，您会看到以下信息：

  • 显示在结算报告中的 SKU 名称。
  • 触发 SKU 的使用类型详情。
  • 三个用量层级的单次使用价格。
  • 针对具体 SKU 的补充定价说明。

您可以在本文中查找各个产品 SKU，或使用我们的定价和用量计算器来估算用量与每个 API 的总费用。

GMP 产品/SKU 表格

产品SKU
路线 SKU：路线、SKU：高级路线
距离矩阵 SKU：距离矩阵、SKU：高级距离矩阵
海拔 SKU：海拔
地理编码 SKU：地理编码
地理定位 SKU：地理定位
Map Tiles API SKU：2D 地图图块、SKU：街景图块、SKU：仿真 3D 图块
嵌入地图 SKU：嵌入地图、SKU：高级嵌入地图
Maps JavaScript API SKU：动态地图、SKU：动态街景
Maps SDK for Android SKU：移动原生动态地图、SKU：动态街景、SKU：动态地图
Maps SDK for iOS SKU：移动原生动态地图、SKU：动态街景、SKU：动态地图
静态地图 SKU：静态地图
Maps Aerial View API SKU：Aerial View API
Navigation SDK 与我们联系
Navigation SDK for Android 与我们联系
Navigation SDK for iOS 与我们联系
Places API（新） SKU：自动补全请求 SKU：自动补全会话使用情况 SKU：地点详情（仅 ID）、 SKU：地点详情（仅限位置）、 SKU：地点详情（基本）、 SKU：地点详情（高级）、 SKU：地点详情（首选）、 SKU：附近搜索（基本）、 SKU：附近搜索（高级）、 SKU：附近搜索（首选）、 SKU：文本搜索（仅限 ID）、SKU：文本搜索（基本）、 SKU：文本搜索（高级）、SKU：文本搜索（首选）、 SKU：地点照片
Places API SKU：地址验证 SKU：首选地址验证， SKU：氛围数据、SKU：自动补全 - 按请求结算、 SKU：自动补全（包含地点详情）- 按会话结算， SKU：自动补全（不含地点详情）- 按会话结算、 SKU：基本数据、SKU：联系人数据、 SKU：查找地点、SKU：查找地点 - 仅 ID、 SKU：地点 - 附近搜索、SKU：地点 - 文本搜索、 SKU - 地点详情、SKU - 地点详情 - ID 刷新、 SKU：地点照片和 SKU：查询自动补全 - 按请求结算
Places SDK for Android SKU：氛围数据、SKU：自动补全 - 按请求结算、SKU：自动补全（包含地点详情）- 按会话结算、SKU：自动补全（不含地点详情）- 按会话结算、SKU：基本数据、SKU：联系人数据、SKU：查找当前地点，以及 SKU：Place Photo
Places SDK for iOS SKU：氛围数据、SKU：自动补全 - 按请求结算、SKU：自动补全（包含地点详情）- 按会话结算、SKU：自动补全（不含地点详情）- 按会话结算、SKU：基本数据、SKU：联系人数据、SKU：查找当前地点，以及 SKU：Place Photo
道路 SKU：道路 - 最近的道路、SKU：道路 - 已行驶路线、SKU：道路 - 速度限制
路由优化 SKU：路线优化：单一车辆路线、 SKU：路线优化：舰队路线
路线 SKU：路线：计算路线 - 基本、SKU：路线：计算路线 - 高级、SKU：路线：计算路线 - 首选、SKU：路线：计算路线矩阵 - 基本、SKU：路线：计算路线矩阵 - 高级、SKU：路线：计算路线矩阵 - 首选
街景 SKU：静态街景
时区 SKU：时区
空气质量 SKU：空气质量
花粉 SKU：花粉
太阳能 SKU：太阳能建筑数据分析
太阳能 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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
0.00 美元 0.00 美元 0.00 美元

在采用 Maps SDK for Android 或 Maps SDK for iOS 的移动应用中，每次对 Google 地图对象进行实例化时，都会产生一次地图加载：

用户与地图互动（例如平移、缩放或切换地图图层）时不会产生额外的地图加载。采用随用随付定价模式时，街景全景图片的创建不再以移动原生地图加载次数为标准进行收费，而是按动态街景收费。

SKU：嵌入地图和 SKU：高级嵌入地图

所有 Maps Embed API 请求都是免费的，且用量不受限制。

SKU：静态地图

对 Maps Static API 的请求。

每月用量范围
（每次加载地图的价格）
0–100,000 100,001–500,000 超过 500,000
0.002 美元/次
（2.00 美元/千次）		 0.0016 美元/次
（1.60 美元/千次）		 如需了解批量定价，请与销售人员联系

SKU：动态地图

如果应用使用 Maps JavaScript API，则应用显示的地图会或不会与地图 ID 一起加载；如果应用使用 Maps SDK for Android 或 Maps SDK for iOS，则应用显示的地图会与地图 ID 一起加载。

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

用户与地图互动（例如平移、缩放或切换地图图层）时不会产生额外的地图加载。

SKU：静态街景

街景全景图片和地图加载现在是分开计费的。对于向 Street View Static API 发出的嵌入静态（非交互式）街景全景图片的每个请求，您都需支付单张静态街景全景图片的费用。使用街景图片元数据端点不会产生费用。

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

SKU：动态街景

街景全景图片和地图加载现在是分开计费的。在采用 Maps JavaScript API、Maps SDK for Android、Maps SDK for iOS 的应用中，对于全景图片对象的每次实例化，您都需支付单张动态街景全景图片的费用。

每月用量范围
（每张全景图片的价格）
0–100,000 100,001–500,000 超过 500,000
0.014 美元/张
（14.00 美元/千张）		 0.0112 美元/张
（11.20 美元/千张）		 如需了解批量定价，请与销售人员联系

执行以下操作时，全景图片对象会进行实例化：

SKU：航拍视图

对 Aerial View API 的请求会返回航拍视频网址。

每月用量范围
（每次成功发出 lookupVideo 请求的价格）
0–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
0.005 美元/次
（5.00 美元/千次）		 0.004 美元/次
（4.00 美元/千次）		 如需了解批量定价，请与销售人员联系

SKU：高级路线

对 Maps JavaScript API 的“路线”服务或 Directions API（该 API 使用了路况信息以及超过 10 个航点、航点优化和/或位置修饰符）的请求。

每月用量范围
（每次查询的价格）
0–100,000 100,001–500,000 超过 500,000
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|...
  • 超过 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–100,000 100,001–500,000 超过 500,000
0.005 美元/次
（5.00 美元/千次）		 0.004 美元/次
（4.00 美元/千次）		 如需了解批量定价，请与销售人员联系

发送至 Distance Matrix API 的每个查询都会生成元素，origins 数量与 destinations 数量的乘积便是元素数量。

SKU：高级距离矩阵

对 Distance Matrix API 或使用路况信息和/或位置修饰符的 Maps JavaScript API“距离矩阵”服务的请求。

每月用量范围
（每个元素的价格）
0–100,000 100,001–500,000 超过 500,000
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 可设置为当前时间或未来的某个时间，但不能是过去的时间。
  • 位置修饰符。当您使用以下位置修饰符指引司机应如何抵达特定位置时：
    • side_of_road
    • heading

SKU：道路 - 已行驶路线

对 Roads API 的“沿实际道路”服务的请求。

每月用量范围
（每次查询的价格）
0–100,000 100,001–500,000 超过 500,000
0.01 美元/次
（10.00 美元/千次）		 0.008 美元/次
（8.00 美元/千次）		 如需了解批量定价，请与销售人员联系

SKU：道路 - 最近的道路

对 Roads API 的“最近的道路”服务的请求。

每月用量范围
（每次查询的价格）
0–100,000 100,001–500,000 超过 500,000
0.01 美元/次
（10.00 美元/千次）		 0.008 美元/次
（8.00 美元/千次）		 如需了解批量定价，请与销售人员联系

SKU：道路 - 速度限制

对 Roads API 的“速度限制”服务的请求。
每月用量范围
（每个元素的价格）
0–100,000 100,001–500,000 超过 500,000
0.02 美元/个
（20.00 美元/千个）		 0.016 美元/个
（16.00 美元/千个）		 如需了解批量定价，请与销售人员联系

“速度限制”请求的费用按 API 响应中返回的速度限制元素数计算。此数量始终不超过原始请求中传递的数据点的数量。

SKU：路线：计算路线 - 基本

对计算路线服务的请求。

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

SKU：路线：计算路线 - 高级

使用高级地图项的计算路线服务请求。

每月用量范围
（每次查询的价格）
0–100,000 100,001–500,000 超过 500,000
0.01 美元/次
（10.00 美元/千次）		 0.008 美元/次
（8.00 美元/千次）		 如需了解批量定价，请与销售人员联系

对于使用以下一项或多项地图项的计算路线服务请求，您需要支付高级 SKU 的费用：

SKU：路线：计算路线 - 首选

对使用首选地图项的计算路线服务的请求。

每月用量范围
（每次查询的价格）
0–100,000 100,001–500,000 超过 500,000
0.015 美元/个
（15.00 美元/千个）		 0.012 美元/个
（12.00 美元/千个）		 如需了解批量定价，请与销售人员联系

对于使用以下一项或多项地图项的计算路线服务请求，您需要支付首选 SKU 的费用：

SKU：路线：计算路线矩阵 - 基本

对计算路线矩阵服务的请求。

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

SKU：路线：计算路线矩阵 - 高级

使用高级地图项的计算路线矩阵服务请求。

每月用量范围
（每个元素的价格）
0–100,000 100,001–500,000 超过 500,000
0.01 美元/次
（10.00 美元/千次）		 0.008 美元/次
（8.00 美元/千次）		 如需了解批量定价，请与销售人员联系

对于使用以下一项或多项地图项的计算路线矩阵服务请求，您需要支付高级 SKU 的费用：

SKU：路线：计算路线矩阵 - 首选

对使用首选地图项的计算路线矩阵服务的请求。

每月用量范围
（每个元素的价格）
0–100,000 100,001–500,000 超过 500,000
0.015 美元/个
（15.00 美元/千个）		 0.012 美元/个
（12.00 美元/千个）		 如需了解批量定价，请与销售人员联系

对于使用以下一项或多项地图项的计算路线矩阵服务请求，您需要支付首选 SKU 的费用：

SKU：路线优化：单车路线

对 的请求 Route Optimization API 仅指定一辆车。

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

SKU：路线优化：舰队路线

对 的请求 Route Optimization API 指定多辆车。

每月用量范围
（每次配送的价格）
0–100,000 100,001–500,000 超过 500,000
0.03 美元/次
（30.00 美元/千次）		 0.014 美元/张
（14.00 美元/千张）		 如需了解批量定价，请与销售人员联系

地点（新）产品 SKU

关于字段掩码

在请求中使用字段掩码（也称为字段列表），以指定要在响应中返回的字段列表。然后，我们会按适用于您请求的最高 SKU 进行结算。这意味着，如果您同时选择了“（基本）SKU”和“（高级）SKU”中的字段，我们会根据“（高级）SKU”进行结算。

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

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

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

第一个“自动补全（新）”请求发出时，会话开始。“地点详情（新）”请求或 然后，当用户选择其中一个“自动补全（新）”选项时，系统会发出地址验证请求 建议。如果会话被放弃，则意味着没有“地点详情（新）”请求或 发出地址验证请求后，系统会按照没有会话令牌的情况计费“自动补全（新）”请求 已提供。

在用户选择地点（包括“地点详情（新）”请求或地址验证）后 请求），则必须使用新会话令牌启动新会话。

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

SKU：“自动补全”请求

您需要为向 不包含会话令牌的 Autocomplete（新）API。

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

  • 通过向“地点详情”发出单个请求来终止会话（新）， 用于请求由 SKU：地点详情（仅限位置）定义的所有字段。
    • 每个“自动补全（新）”请求（最多 12 个）按 SKU：自动补全请求。
    • 每个后续的“自动补全（新）”请求都按 SKU：自动补全会话使用情况。
  • 您可以放弃会话或结束会话，只需调用 SKU：地点详情（仅 ID）。然后，系统会对所有“自动补全（新）”请求进行结算 使用 SKU：自动补全请求。
每月用量范围
（每次调用的价格）
0–100,000 100,001–500,000 超过 500,000
0.00283 美元/次
（2.83 美元/千次）		 0.00227 美元/次
（2.27 美元/千次）		 如需了解批量定价，请与销售人员联系

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

对于向 Google 发送的每个请求，您需要支付自动补全会话使用情况 SKU 费用 包含会话令牌的 Autocomplete（新）API。

此 SKU 在以下情况下收费：

  • 通过调用 SKU：地点详情（仅限位置）来终止“自动补全”会话：

    • 每个“自动补全（新）”请求（最多 12 个）按 SKU：自动补全请求。
    • 每个后续的“自动补全（新）”请求都按 SKU：自动补全会话使用情况。

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

    “地点详情”调用请求任意字段 SKU：地点详情（基本版、高级版或首选）按照 SKU：地点详情（首选）。

  • “自动补全”会话因调用 SKU：地址验证而终止 首选。

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

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

SKU：地点详情（仅 ID）

<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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
0.040 美元/次
（40.00 美元/千次）		 0.032 美元/次
（32.00 美元/千次）		 如需了解批量定价，请与销售人员联系

SKU：Place Photo

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

每月用量范围
（每次调用的价格）
0–100,000 100,001–500,000 超过 500,000
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 生成：

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

使用会话的“自动补全”请求和“地点详情”请求以不同的 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–100,000 100,001–500,000 超过 500,000
地点请求费用
+ 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–100,000 100,001–500,000 超过 500,000
地点请求费用
+ 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–100,000 100,001–500,000 超过 500,000
地点请求费用
+ 0.005 美元/次
（+ 5.00 美元/千次）		 地点请求费用
+ 0.004 美元/次
（+ 4.00 美元/千次）		 如需了解批量定价，请与销售人员联系

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

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

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

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

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

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

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

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

示例

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

Android

iOS

网络服务

您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：

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

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

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

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

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

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

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

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

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

示例

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

Android

iOS

网络服务

您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：

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

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

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

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

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

SKU：地点详情

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

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

地点详情 SKU 通过以下 API 生成：

使用网络 API 和服务时，无论是否提供会话令牌，都会收取“地点详情”SKU 费用。

“地点详情”调用或请求还会生成数据 SKU（基本数据、联系人数据和/或氛围数据），具体取决于调用或请求中指定的字段。如果“地点详情”调用或请求中未指定字段，则会触发所有数据 SKU，并且您需要支付“地点详情”调用或请求费用以及所有数据的费用。

示例

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

SKU：地点详情 - ID 刷新

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

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

示例

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

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

SKU：查找地点

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

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

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

示例

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

SKU：查找地点 - 仅返回 ID

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

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

示例

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

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

SKU：查找当前地点

对于 findCurrentPlace() (Android) 和 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) 的调用，您需要支付查找当前地点 SKU 费用。

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

对 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) 的调用还会生成数据 SKU（基本数据、联系人数据和/或氛围数据），具体取决于调用中指定的字段。指定数据字段，可以将响应限制为仅包含这些字段。您需要为“查找当前地点”调用以及所请求的数据付费。

示例

  1. 您调用 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS)，并仅指定 ADDRESS 字段。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
    • 查找当前地点（每次请求最低 0.030 美元）
    • 基本数据（费用为 0.00 美元）
  2. 您调用 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS)，并指定 PHONE_NUMBER 字段。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
    • 查找当前地点（每次请求最低 0.030 美元）
    • 联系人数据（每次请求最低 0.003 美元）
  3. 您调用 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS)，并指定所有三个数据类型范畴的字段。您会看到账单中列出了以下 SKU（按 SKU 查看账单时）：
    • 查找当前地点（每次请求最低 0.030 美元）
    • 基本数据（费用为 0.00 美元）
    • 联系人数据（每次请求最低 0.003 美元）
    • 氛围数据（每次请求最低 0.005 美元）

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

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

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

示例

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

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

SKU：地点 - 文本搜索

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

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

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

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

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

示例

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

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

SKU：Place Photo

您需要为以下行为支付 Place Photo SKU 费用：

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

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

SKU：地理编码

对于向 Maps JavaScript API 的“地理编码”服务或 Geocoding API 发出的请求，您需要支付地理编码 SKU 费用。在 JavaScript 中，Geocoder.geocode() 方法会向地理编码服务发起请求。

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

SKU：地理定位

对于向 Geolocation API 发出的请求，您需要支付地理定位 SKU 费用。

每月用量范围
（每次请求的价格）
0–100,000 100,001–500,000 超过 500,000
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–100,000 100,001–500,000 超过 500,000
0.006 美元/次
（6.00 美元/千次）		 0.0051 美元/次
（5.10 美元/千次）		 如需了解批量定价，请与销售人员联系

SKU：时区

对于向 Time Zone API 发出的请求，您需要支付时区 SKU 费用。

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

SKU：海拔

对于向 Maps JavaScript API 的“海拔”服务或 Elevation API 发出的请求，您需要支付海拔 SKU 费用。

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

SKU：地址验证

对 Address Validation API 的 validateAddress 方法 (REST) 和 ValidateAddress 方法 (gRPC) 的请求。

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

SKU：首选地址验证

首选地址验证服务适用于 自动补全（新） 端点。 调用 Address Validation API。具体而言，使用“自动补全”（新）的会话 并终止对 validateAddress (REST) 或 ValidateAddress (gRPC) 位于此价格模式中。

有关定价和使用包含以下内容的“自动补全（新）”会话的详细信息 Places API，请参阅 请参阅 Places API 中的以下指南 文档：

如果在“自动补全（新）”会话结束时使用地址验证首选选项， 您的结算方式如下：

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

环境产品 SKU

环境方面的 API 包括：Air Quality API、Pollen API 和 Solar API。

SKU：空气质量

此 SKU 适用于以下端点和方法：

  • currentConditions
  • history（每页）
  • heatmapTiles
  • 预测数据（每页）

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

    SKU：花粉

    此 SKU 适用于以下端点/方法：

  • forecast
  • heatmapTiles

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

    SKU：太阳能建筑数据分析

    对 buildingInsights 的请求。

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

    SKU：太阳能数据层

    对 dataLayers 的请求。

    通过同一请求访问多个图片网址不会产生额外的收费查询。
    每月用量范围
    （每次请求的价格）
    0–100,000 100,001–500,000 超过 500,000
    0.075 美元/次
    （75.00 美元/千次）    		 0.0375 美元/次
    （37.50 美元/千次）    		 如需了解批量定价，请与销售人员联系