菜单

产品更新

我们更新了多个 API。详情请见下文。

地图

地图产品没有变化。请参阅 API 结算方式变化

路线

路线产品没有变化。请参阅 API 结算方式变化

地点

可以限制地点详情请求仅返回某些字段

地点详情请求已更新为仅返回您指定的字段。以前,地点详情请求会返回与指定地点有关的所有可用数据。实施本次更改后,响应结果将仅包含使用 fields 参数指定的字段。这些字段与地点详情结果相对应,而且分为三个结算类别:基本、联系方式和环境氛围。每个请求的费用取决于所选的字段;不过,如果未指定任何字段,则会返回与指定地点有关的所有可用数据,产生的费用也最高。

所有地点详情请求均按照基本费率结算。

基本类别不会产生任何其他费用,该类别包括以下字段:

address_componentadr_addressformatted_addressgeometryiconnamepermanently_closedphotoplace_idplus_codetypeurlutc_offsetvicinity

联系方式类别会产生其他费用,该类别包括以下字段:

formatted_phone_numberinternational_phone_numberopening_hourswebsite

环境氛围类别会产生其他费用,该类别包括以下字段:

price_levelratingreview

注意:无论是否发出了提供方数据请求,每次调用都会返回提供方 (html_attributions) 数据。

可以执行的操作:

  • 评估应用,看看目前使用了哪些地点详情数据
  • 更新代码以添加 fields 参数
  • 登录 Google Cloud Platform Console,了解当前的 Places API 使用情况(如需与 Console 有关的帮助,请访问 Google 帐号帮助中心

示例

您可以按照下面的示例(指定了 nameratingformatted_phone_number 字段),使用 fields 参数指定地点详情请求要返回的字段:

Web 服务

https://maps.googleapis.com/maps/api/place/details/json?placeid={PLACE_ID}&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY 

JavaScript

const placeId = 'not_actually_a_place_id';
const request = {
  placeId: placeId,
  fields: ['name', 'rating', 'formatted_phone_number']
};
const service = new google.maps.places.PlacesService(map);
service.getDetails(request, callback); 

Web 服务

我们针对 Web 服务推出了一项新服务:查找地点,该服务会根据文字输入或电话号码返回一个地点。输入的文字可以是任意类型的地点数据,例如名称、地址或电话号码。您必须将 fields 参数与查找地点服务结合使用,才能收到所需的字段。“基本”、“联系方式”或“环境氛围”类别中的字段与地点详情请求采用相同的结算方式。如果未指定任何字段,则会返回相关地点的 PlaceId,而且不会产生费用。

可以执行的操作:

考虑将现有的地点搜索请求改为使用查找地点功能。

JavaScript

我们已推出两种新的适用于 JavaScript 的查找地点 API。通过查询查找地点服务将利用文字查询返回地点。查询可以是任意类型的地点数据,例如名称或地址。通过电话号码查找地点服务将利用输入的电话号码返回地点。您必须将 fields 参数与两种查找地点 API 结合使用,才能收到所需的字段。“基本”、“联系方式”或“环境氛围”类别中的字段与地点详情请求采用相同的结算方式。必须提供 fields 参数,如果未指定任何字段,则请求会产生错误。

可以执行的操作

考虑将现有的文本搜索请求改为使用查找地点功能。

示例

以下示例显示了查找“澳大利亚当代艺术博物馆”的 Places API Web 服务查找地点请求,包含的字段有 photosformatted_addressnameratingopening_hoursgeometry

Web 服务

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

JavaScript

var map;
var service;
var infowindow;

function initMap() {
  var circularquay = new google.maps.LatLng(-33.8617374,151.2021291);

  map = new google.maps.Map(document.getElementById('map'), {
    center: circularquay,
    zoom: 15
  });

  var request = {
    query: 'Museum of Contemporary Art Australia',
    fields: ["photos", "formatted_address", "name", "rating", "opening_hours", "geometry"],
  };

  service = new google.maps.places.PlacesService(map);
  service.findPlaceFromQuery(request, callback);
}

function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    for (var i = 0; i < results.length; i++) {
      var place = results[i];
      createMarker(results[i]);
    }
  }
}

适用于地点产品的移动 SDK

Google 目前正在筹备发布新版 Places SDK for AndroidPlaces SDK for iOS。下文将说明相关变化以及这些变化对您有何影响。

  • 全新 Places SDK for Android 将以独立库的形式提供,不再通过 Google Play 服务提供;此版本无法与当前的 SDK 实现后向兼容
  • 将提供全新 Places SDK for iOS

值得注意的是,我们将会更新多项功能,从整体上反映将会对两大移动平台产生影响的 Places API 的变化:

  • 地点详情(AndroidiOS)请求将包含新的 fields 参数。
  • 自动填充服务将基于会话进行结算。

在未来几个月内,我们会提供更多详情,包括迁移至新版 SDK 的时间安排和相应的提前期。这些新版本将会取代当前的 SDK 版本。我们将按照适当的弃用时间安排弃用当前的 SDK。

Maps Elevation API

Google Maps Platform 推出后,新客户需要与支持团队联系,以使用 Maps Elevation API。如果您目前使用的是此 API,但没有密钥,请务必尽快注册 Google Cloud 帐号,并启用 Maps Elevation API。

配额

新的每秒查询次数 (QPS) 限额和用量上限

我们将取消每日配额上限 (QPD),大部分服务将采用更高的每秒查询次数 (QPS) 限额。所有当前的自助内容客户将自动采用新的 QPS 限额和上限。

API 当前的默认用量上限 新的默认用量上限

Directions

100000 QPD、50 QPS

50 QPS

Distance Matrix

100000 EPD、100 EPS

1000 EPS

Elevation

100000 QPD、50 QPS

QPS

Geocoding

100000 QPD、50 QPS

50 QPS

Geolocation

100000 QPD、50 QPS

100 QPS

Dynamic Maps

100000 QPD

500 QPS

Static Maps

100000 QPD

500 QPS

Street View Image API

100000 QPD

500 QPS

Time Zone

100000 QPD、50 QPS

500 QPS

Places(JavaScript 和 Web)

150000 QPD

100 QPS

Roads

100000 QPD

500 QPS

*EPS = 每秒元素数,EPD = 每日元素数,QPS = 每秒查询次数,QPD = 每日查询次数

如果您目前是使用之前的默认 API 每日配额来限制您的请求数量的,则可以在 Google Cloud Platform Console 中为项目添加每日配额,沿用这一做法。了解详情

品牌和产品名称变化

品牌和产品名称有何变化?

首先,我们已将品牌名称更改为 Google Maps Platform,涵盖您熟悉和喜爱的 API,并且简化了结算方式,提供了更简单的扩容路径,以便您根据发展需要进行扩容。此外,我们现在还为游戏、拼车和资产跟踪行业提供综合性行业解决方案。我们将继续开放覆盖全球大片区域的 Google 地图基础设施,为 200 多个国家和地区的 10 多亿用户提供服务。

其次,借助 Google Maps Platform,我们的 API 得以简化并已融入以下三个核心产品:地图、路线和地点。每款核心产品都提供多项功能,并由不同的 API 提供支持。要了解不同产品提供的功能和 API,请访问我们的文档页面

第三,我们简化了 API 和结算 SKU 的名称,以便更轻松地查找和使用。以下是新名称列表。如需详细了解如何触发新版 SKU,请参阅理解结算方式指南

API 名称变化

原名称 新名称

Google Maps Android API

Maps SDK for Android

Google Maps Directions API

Directions API

Google Maps Distance Matrix API

Distance Matrix API

Google Maps Geocoding API

Geocoding API

Google Maps Geolocation API

Geolocation API

Google Maps JavaScript API

Maps JavaScript API

Google Maps Roads API

Roads API

Google Maps SDK for iOS

Maps SDK for iOS

Google Maps Time Zone API

Time Zone API

Google Places API for Android

Places SDK for Android

Google Places API for iOS

Places SDK for iOS

Google Places API Web Service

Places API

Google Static Maps API

Maps Static API

Google Street View Image API

Street View API

Places Library in the Maps JavaScript API

Places Library, Maps JavaScript API

结算 SKU 名称变化

产品 结算 SKU:新名称 说明

地图

静态地图

显示静态地图。利用自定义标记、线条、颜色、多边形和图片设置地图风格。

动态地图

显示交互式地图。缩放、旋转、倾斜地图以及通过双指张合查看更多细节,并设置地图风格。

静态街景

显示静态街景、360 度全景图片或缩略图。

动态街景

显示交互式街景、360 度全景图片或缩略图。

路线

路线

获取驾车、步行、骑行和公交路线,并创建最多包含 10 个航点的路线。

高级路线

获取多模式路线、创建最多包含 25 个航点的路线,并获取实时路况。

距离矩阵

提供一个或多个地点的行程时间和距离。

高级距离矩阵

根据实时路况提供一个或多个地点的出行时间和距离。

道路 - 已行驶路线

通过确定已行驶路线、收集路线中多达 100 个 GPS 点来创建行程。

道路 - 最近的道路

使用多达 100 个独立的坐标来确定最近的道路。

地点

基本数据

提供超过 1 亿个地点以及感兴趣地点的名称和地址。

联系方式数据

提供超过 1 亿个地点以及感兴趣地点的名称、地址和联系信息。

环境氛围数据

提供超过 1 亿个地点及感兴趣地点的名称、地址、联系信息,以及评分和环境氛围等丰富细节。

地点照片

为各地点以及感兴趣地点添加高质量照片,有数百万张照片可供选择。

地点 - 文本搜索

根据搜索字符串(例如“鲁菜馆”)返回附近的地点列表。

地点 - 附近搜索

根据用户位置返回附近的地点列表。

查找地点

将电话号码、地址或名称变成地点,并提供地点名称和地址。

自动填充详情

根据地点详情自动填充地点建议。

自动填充 - 按请求结算

当用户输入地址或地点名称时,自动填充地点建议。按输入的字符数结算费用。

自动填充 - 按会话结算

当用户输入地址或地点名称时,自动填充地点建议。按会话结算费用。

地理位置

根据 Wi-Fi 或基站位置返回设备的位置信息和精度半径。

地理编码

将地址转换为地理坐标,或将地理坐标转换为地址。

时区

根据地理坐标和日期,返回任意地点的时区信息。

启用 Google Maps Platform

要启用 API 或设置结算信息,请在我们的引导下完成下列操作:

  1. 在下方选择产品
  2. 选择项目
  3. 设置您的结算信息

提供定制化的地图使用体验,带给用户身临其境的感受。

为用户提供从出发地到目的地的最佳路线。

为用户提供丰富的细节信息,帮助用户探索世界。

您现在已登录。
点击“继续”选择一个项目。
继续 继续 继续 继续 继续 继续 继续