Maps JavaScript API 版本说明

订阅以下版本说明。

Maps JavaScript API 团队会定期更新 API，以加入新功能、修复 bug 并提升性能。您可以在 Maps JavaScript API 引导加载程序请求的 v 参数中指定具体的版本号，从而指示要在应用中加载哪个版本的 API。详细了解版本控制。

此更新日志按日期和版本号列出了版本，以及相关的更改。

如需接收有关新版 Maps API 的最新动态，请订阅 google-maps-js-api-v3-notify 组。

3.58.11a

2024 年 10 月 31 日

变更：

• [Beta 版渠道] 修复了导致无法在 Web 组件地图上使用街景小人的 bug。
• 当滚动消息隐藏在 Embed API 地图中时，阻止了屏幕阅读器聚焦于该消息。

3.58.10

2024 年 10 月 24 日

变更：

• 解决了访问会话存储时导致异常的问题。

3.58.9（已回滚）

2024 年 10 月 17 日

变更：

• [alpha 通道] 现在，您可以将自定义图片和 SVG 用于在 3D 地图上呈现的标记。

3.58.8

2024 年 10 月 10 日

变更：

• 移除了错误的 WebGLOverlayView 控制台警告。
• 过去，当 Chrome 是页面上与指针或鼠标互动的第一个元素时，Chrome 会在地图上错误地显示蓝色焦点线。
• 为 Mobility Services JavaScript 车队跟踪添加了 ODRD 车辆和车队位置信息提供程序。

3.58.7

2024 年 10 月 3 日

没有面向公众的更改。

3.58.6

2024 年 9 月 25 日

变更：

• [Alpha 通道] 从 Polyline3DElement 和 Polygon3DElement 中移除了 *Opacity 属性。您可以在相应的 *Color 属性中使用 #rgba、#rrggbbaa、rgba(r, g, b, a) 或 rgb(r g b / a) 颜色格式指定 alpha 值。
• [Alpha 渠道] 现在，实验性版本中的 3D 地图可以使用默认界面控件、标记、3D 模型和预设的相机动画功能。
• 修复了导致自定义地图类型无法在矢量地图上相互切换的 bug。
• 针对像素密度较高的设备使用高 DPI 卫星图像。

3.58.5a

2024 年 9 月 19 日

没有面向公众的更改。

3.58.4a

2024 年 9 月 12 日

没有面向公众的更改。

3.58.3

2024 年 9 月 5 日

没有面向公众的更改。

3.58.2

2024 年 8 月 29 日

变更：

• PinElement 的文本字形现在随 PinElement 缩放，其默认颜色与 PinElement 的默认 glyphColor 一致。

3.58.1a

2024 年 8 月 22 日

变更：

• [Beta 版渠道] 默认情况下，将缩放控件替换为相机控件。镜头控件同时具有缩放和平移控件。
• 将 cameraControl 和 cameraControlOptions 属性发布到 MapOptions。
• 允许在地图实例化时设置配色方案（浅色或深色）。
• 更新了地图类型控件，以便在地图宽度过小时换行
• 集成了用于渲染矢量地图标签的新标记器。
• 对于未使用地图 ID 的开发者，新的基本地图颜色现在是 v=weekly 渠道中的默认颜色。如需了解详情，请访问 https://developers.google.com/maps/new-basemap-style-opt-in。

3.57.13

2024 年 8 月 8 日

变更：

• [Beta 版渠道] 为反向地理编码、正向地理编码和地点 ID 查找的地理编码响应添加了地址描述符。

3.57.12

2024 年 8 月 1 日

变更：

• [Beta 版渠道] 为反向地理编码、正向地理编码和地点 ID 查找的地理编码响应添加了地址描述符。
• [Beta 渠道] 允许在地图实例化时设置配色方案（浅色或深色）。
• 缩短在矢量地图中点击地图项时的 IconMouseEvent 延迟时间

3.57.10

2024 年 7 月 25 日

变更：

• [Beta 版渠道] 为反向地理编码、正向地理编码和地点 ID 查找的地理编码响应添加了地址描述符。
• 向地点类添加了多个主要类型和显示名称属性。

3.57.9

2024 年 7 月 18 日

变更：

• 改进了街景小人控件的无障碍功能。

3.57.8b

2024 年 7 月 11 日

没有面向公众的更改。

3.57.7

2024 年 7 月 4 日

变更：

• 向地点类属性添加了电动汽车选项和燃料选项。为 Place.searchByText 启用电动汽车搜索选项。

3.57.6a

2024 年 6 月 27 日

没有面向公众的更改。

3.57.5

2024 年 6 月 20 日

没有面向公众的更改。

3.57.4

2024 年 6 月 13 日

变更：

• [Beta 版渠道] 集成了用于渲染矢量地图标签的新标签器。
• InfoWindow 新增了 isOpen 属性，用于指明它是在 Google 地图还是在街景中打开的。
• 修复了地点自动补全 PlacePrediction 类的参考文档不正确的问题。

3.57.3a

2024 年 6 月 6 日

• [Beta 版渠道] 为反向地理编码、正向地理编码和地点 ID 查找的地理编码响应添加了地址描述符。

3.57.2

2024 年 5 月 28 日

变更：

• 修复了以下 bug：Web 组件中的地图类型控件无法打开菜单。
• 修复了导致 AdvancedMarkerElement 的拖动指示器缺失的 bug。
• 为新的 Place API 添加自动补全功能。
• 地图光栅图块现在以 WebP 图片格式提供。
• 更新了 Place.searchByText 和 Place.searchNearby 的文档，以指向正确的字段列表。
• 每周频道现已推出新的 InfoWindow 关闭按钮和可选标题。

3.57.0

2024 年 5 月 24 日

没有面向公众的更改。

3.56.12a

2024 年 5 月 9 日

变更：

• 修复了导致 AdvancedMarkerElement 的拖动指示器缺失的 bug。

3.56.11

2024 年 5 月 2 日

变更：

• [Beta 版渠道] 现在，如果设置了地图 ID，但未在地图 ID（例如 DEMO_MAP_ID）上设置明确的渲染类型，<gmp-map> 也会默认采用矢量模式。

3.56.10

2024 年 4 月 25 日

变更：

• [Beta 版渠道] PlaceAutocompleteElement 的 gmp-placeselect 事件现在会上报。
• [Beta 版渠道] 现在提供新的 InfoWindow 关闭按钮和可选标题。
• [Beta 版渠道] 改进了街景小人控件的键盘和单指无障碍功能。
• 修复了移除高级标记导致的内存泄漏问题。
• 修复了圆形无法绘制平滑周长的问题。
• 添加了 API，用于在 google.maps.Map 实例化期间设置矢量模式（不需要 mapId）。

3.56.8

2024 年 4 月 11 日

变更：

• 修复了使用 AdvancedMarkerElement 时出现的内存泄漏问题。

3.56.7

2024 年 4 月 4 日

变更：

• 向新的 Place 类添加 searchNearby 函数。

3.56.6

2024 年 3 月 28 日

变更：

• [Beta 版渠道] 地图光栅图块现在以 WebP 图片格式提供。
• 修复了矢量地图上地图注点的信息窗口锚点定位。
• 修复了显示未设置位置的 AdvancedMarkerElement 的 bug。
• 向 InfoWindow API 添加了“close”事件。

3.56.5

2024 年 3 月 21 日

变更：

• [Beta 版渠道] 现在，对于不使用地图 ID 的开发者，新的基本地图颜色是默认颜色。如需了解详情，请访问 https://developers.google.com/maps/new-basemap-style-opt-in。
• 修复了矢量地图标签和图标的信息窗口基本位置。

3.56.4

2024 年 3 月 14 日

没有面向公众的更改。

3.56.3

2024 年 3 月 7 日

没有面向公众的更改。

3.56.1

2024 年 2 月 22 日

变更：

• 修复了 Place.searchByText 的“fields”参数中的文档错误。
• [Beta 版渠道] 在 <gmp-map> 中创建默认槽位，并允许创建自定义元素来封装 Maps JavaScript API Web 组件。
• 向新的 Place 类 API 添加停车选项。
• 弃用了 google.maps.Marker。请改为使用 google.maps.marker.AdvancedMarkerElement。目前，我们并未计划停用 google.maps.Marker，但我们建议您使用 google.maps.marker.AdvancedMarkerElement，而不是 google.maps.Marker。尽管 google.maps.Marker 会继续收到所有重大回归问题的修复，但 google.maps.Marker 中的现有 bug 将无法解决。我们若计划停止支持，会提前至少 12 个月发出通知。如需了解弃用详情，请访问 https://developers.google.com/maps/deprecations。
• 向新的地点类 API 添加了其他属性。
• 向新的地点类 API 添加了付款选项。

3.55.11a

2024 年 2 月 15 日

变更：

• 防止用户在点击地图后自动滚动进入视图。

3.55.11

2024 年 2 月 8 日

变更：

• [Alpha 渠道] 从 PlaceAutocompleteElement 中移除了 inputElement 属性。
• [Alpha 渠道] 为地点自动补全元素添加 CSS 部分
• [Beta 渠道] PlaceAutocompleteElement 现已在预览版中推出 (v=beta)
• 向 Places V2 API 添加了无障碍功能选项。

3.55.10

2024 年 2 月 1 日

变更：

• [Beta 版渠道] 废弃了 SearchByTextRequest.rankBy。请改用 SearchByTextRequest.rankPreference。
• [Beta 版渠道] Place.findPlaceFromQuery 和 Place.findPlaceFromPhoneNumber 已不再可用；请改用 Place.searchByText。
• 修复了按渠道跟踪用量的问题。
• 在 JavaScript 行程共享中，为行程和车辆位置信息提供程序启用感知交通状况的多段线。
• 新的地点类现在已在每周渠道中推出。
• 废弃了 Place.openingHours。请改用 regularOpeningHours。

3.55.9

2024 年 1 月 25 日

变更：

• [Beta 渠道] 修复了在 MapElement 上按 Esc 键时无法关闭键盘快捷键对话框的问题。
• 向引导加载程序网址添加了新的网址参数 loading=async，以便直接加载脚本。这表示 Maps JavaScript API 尚未同步加载，并且脚本的 load 事件未触发任何 JavaScript 代码。强烈建议您尽可能将此值设为 async，以提升性能。

3.55.8

2024 年 1 月 18 日

变更：

• [Alpha 渠道] 现在，会在 PlaceAutocompleteElement 请求中发送会话令牌。
• [Beta 版渠道] 在 AdvancedMarkerElement 中引入了新属性 gmpClickable。对于在 Beta 版渠道中使用 addEventListener() 注册 gmp-click 事件的用户，这是一个破坏性更改。若要在点击时接收 gmp-click 事件，请将 gmpClickable 属性设置为 true 或向 网络组件添加 gmp-clickable 属性。对于使用 addListener() 注册 gmp-click 事件的用户，目前无需进行任何更改。

3.55.7

2024 年 1 月 11 日

变更：

• [Beta 版渠道] AdvancedMarkerElement 的 element 属性现在指向 AdvancedMarkerElement 的实例。
• [测试版渠道] 现在，高级标记可以使用子节点自定义其内容。
• 修复了在点击地图后平移和缩放键盘快捷键不起作用的 bug。
• 为 JavaScript 历程共享启用多段线自定义。
• [alpha 渠道] 向 PlaceAutocomplete 添加类型、 requestedLanguage、 requestedRegion 和 name 属性
• [Beta 版频道] 修复了导致在调用 document.createElement('gmp-advanced-marker') 时无法创建高级标记元素的 bug。

3.55.3

2023 年 11 月 30 日

没有面向公众的更改。

3.55.2

2023 年 11 月 23 日

变更：

• 修复了导致街景中出现样式相关 CSP 错误的 bug

3.55.1

2023 年 11 月 16 日

没有面向公众的更改。

3.54.12a

2023 年 11 月 8 日

变更：

• 修复了导致 WebGLOverlayView 在某些情况下无法呈现的 bug。

3.54.12

2023 年 11 月 2 日

变更：

• [Alpha 渠道] 将地点自动补全更新为 Web 组件。这是一项重大变更。如需了解更新后的使用信息，请参阅 https://developers.google.com/maps/documentation/javascript/reference/places-widget#PlaceAutocompleteElement。
• [Alpha 渠道] 更新了地点自动补全元素的焦点管理
• [Beta 渠道] 在 MapElements 中公开了 gmp-zoomchange 事件
• 启用 MapTypeControl HORIZONTAL_BAR 以自动处理 RTL 布局上下文。

3.54.11

2023 年 10 月 26 日

变更：

• 修复了在地图上设置控件时可能会抛出错误的问题。
• 通过 StreetViewLocationRequest 和 StreetViewControlOptions 添加相关功能，将街景图像限制为仅显示官方 Google 来源的图像。

3.54.10

2023 年 10 月 18 日

变更：

• [Beta 渠道] 现在，MapElement 会根据计算出的 direction 样式自动调整其控件布局，方向为从左到右或从右到左。您还可以使用槽添加自定义控件。ControlPosition 现在支持逻辑值，以支持 LTR/RTL 布局。现在，Maps Embed API 还可以根据语言自动调整控件布局，调整方向是从左到右或从右到左。
• [Beta 版渠道] MapElement 现在已启用 delegatesFocus

3.54.9

2023 年 10 月 12 日

• [Beta 版渠道] 向地点 v2 API 添加了编辑摘要。

3.54.7a

2023 年 9 月 28 日

变更：

• 在行程共享 JavaScript 中添加了对多个位置信息提供程序的支持。

3.54.6

2023 年 9 月 21 日

变更：

• google.maps.FeatureLayer 会响应 mousemove 事件。
• 添加了 google.maps.FeatureType.SCHOOL_DISTRICT，以便数据驱动型样式支持学区。

3.54.5

2023 年 9 月 14 日

变更：

• [测试版] 修复了导致 AdvancedMarkerElement 的 addEventListener() 不可用的错误。

3.54.4

2023 年 9 月 7 日

变更：

• Google 徽标与 Google 地图上的版权信息重叠的频率将降低。

3.54.2

2023 年 8 月 24 日

变更：

• 修复了 DirectionsRenderer 中的 bug：如果未在渲染 DirectionsResult 之前设置缩放和中心，地图将无法加载。

3.54.1

2023 年 8 月 18 日

变更：

• 将 Maps JavaScript API 升级为原生支持 ECMAScript 2020。
• 高级标记现在的呈现效果更加清晰。
• 当使用不支持可迭代对象的实现替换 Array.from 时，映射将被停用。
• 修复了在限制级别停用缩放按钮时焦点丢失的问题。

3.53.13

2023 年 7 月 27 日

变更：

• [Beta 版渠道] 重构了新地点类中的归因。PhotoAttribution 现为 AuthorAttribution。author 现为 displayName。authorURI 现为 uri。photoURI {?string} 现已在 AuthorAttribution 上推出。Photo.attributions 现为 Photo.authorAttributions。Review.authorAttribution {?AuthorAttribution} 取代了 Photo.author/authorURI/authorPhotoURI。
• [Beta 版渠道] 在地点类 searchByText() 方法中添加了必需字段 textQuery 并废弃了 query。
• 调整了光栅地图标签和图标的信息窗口锚点偏移。

3.53.12

2023 年 7 月 20 日

变更：

• [Beta 版渠道] 为 JavaScript 历程共享 - 车队跟踪添加了 ODRD 车辆和车队位置信息提供程序。
• 更新了忽略传递给 LatLng() 构造函数的参数时的警告消息。
• 废弃了 Marker.collisionBehavior，取而代之的是 AdvancedMarkerElement.collisionBehavior。

3.53.11

2023 年 7 月 13 日

变更：

• 现在，如果指定点足够靠近多段线的起点或边缘，函数 isLocationOnEdge() 会返回 true。
• 添加了错误日志，以便开发者了解矢量地图何时无法加载并回退为光栅地图。

3.53.7

2023 年 6 月 15 日

变更：

• [alpha 渠道] 更新了地点自动补全元素，以更好地支持屏幕阅读器和其他辅助技术。

3.53.5

2023 年 6 月 1 日

变更：

• 允许将节点元素传递给高级标记的 content 属性。
• 改进了高级标记碰撞行为的性能。
• 在 JavaScript 历程共享中，为 DeliveryVehicleStop 添加了一个新字段。

3.53.4a

2023 年 5 月 24 日

bug 修复：

• 修复了矢量地图上出现的闪烁问题。
• 修复了在 getNextOpeningTime() 地点方法中考虑不同时区时计算错误的日期。
• 更正了行程分享的 VehicleJourneySegment 中的错误类型。

3.53.3

2023 年 5 月 18 日

变更：

• [Alpha 版] 修复了以下 bug：如果您使用箭头键突出显示某个预测结果，然后点击“Escape”键，地点自动补全元素将不会恢复原始文本。
• [Alpha 渠道] 更新了地点自动补全预测样式，以确保在文本溢出时显示省略号。
• [Beta 版渠道] Local Context 现在会显示一条通知，告知 Local Context 地图上地点的情境信息即将停用。
• 修复了以下 bug：除非街景小人先返回到底部至少一次，否则不会显示拖动悬停预览。
• 已弃用地点自动补全服务的边界、位置和半径。请改为使用 locationBias 和 locationRestriction。

3.53.2

2023 年 5 月 4 日

变更：

• [Beta 渠道] 推出数据集的数据驱动型样式
• [Beta 版渠道] <gmp-map> 和 <gmp-advanced-marker> Web 组件现已推出。
• 在 JavaScript 历程共享中，将 TimeWindow 添加为 Task 和 TaskTrackingInfo 中的字段。
• AdvancedMarkerElement 和 PinElement 已发布到每周渠道。
• 边界的数据驱动型样式已发布到每周渠道。
• 将 getMapCapabilities 和 mapcapabilities_changed 事件发布到每周渠道。

3.53.1a

2023 年 4 月 27 日

变更：

• 更新了地点自动补全服务，以支持 locationBias 和 locationRestriction
• [Beta 渠道] 发布了关于 Place v2 toJSON 方法的文档。
• [Beta 版渠道] 修复了地图换行时拖动高级标记时出现的问题。
• [Beta 版渠道] 数据驱动型样式设置：PlaceFeature.fetchPlace 的显示名称将采用最终用户的语言。
• [Beta 版] AdvancedMarkerView 和 PinView 已重命名为 AdvancedMarkerElement 和 PinElement。
• [beta 渠道] 修复了以下问题：AdvancedMarkers 和 Pins 有时无需明确加载即可使用。请务必先加载“标记”库，然后再访问这些类。
• [Beta 版渠道] AdvancedMarker position 现已规范化为 LatLngAltitude。
• [beta 渠道] 停用了高级标记 draggable 属性，取而代之的是 gmpDraggable。

3.52.9

2023 年 4 月 13 日

变更：

• [Beta 渠道] 将地点属性“priceLevel”的值从数字更改为字符串。现在，“priceLevel”的可能值有：“FREE”、“INEXPENSIVE”、“MODERATE”、“EXPENSIVE”、“VERY_EXPENSIVE”。
• [Beta 版渠道] 弃用 AdvancedMarkerView.draggable，改用 gmpDraggable。
• [Beta 版渠道] 从地点类中移除了“icon”属性和字段名称。建议开发者改用“svgIconMaskURI”。
• [Beta 版渠道] AdvancedMarkerView 的 title 属性现在仅接受字符串。可以使用空字符串移除影视内容。
• [Beta 渠道] 添加了“svgIconMaskURI”作为 Place.fromPlaceFrom 方法支持的字段名称。
• [Beta 版渠道] 将地点类属性从 userRatingsCount 更改为 userRatingCount
• 改进了登录控制台时输出错误的方式。

bug 修复：

• 修复了关闭信息窗口导致错误的 bug。

3.52.8

2023 年 4 月 6 日

变更：

• 在 JavaScript 历程共享中，将 pollingIntervalMillis 添加为轮询位置信息提供程序的公共字段。
• [Beta 版渠道] 将地点类 JSON 响应从 snake_case 更改为 lowerCamelCase。

bug 修复：

• 修复了地点评价的 publishTime 显示错误日期的 bug。
• 修复了创建自定义元素的全局破坏问题。
• [Beta 版渠道] 修复了导致高级标记在地图换行时消失的 bug。

3.52.6

2023 年 3 月 23 日

变更：

• [Alpha 渠道] 发布了地点自动补全微件（新）实验性版本。
• 向每周渠道发布 JavaScript 历程分享。

3.52.5

2023 年 3 月 16 日

变更：

• [Beta 版渠道] 数据驱动型样式：移除了 NEIGHBORHOOD、ADMINISTRATIVE_AREA_LEVEL_3、ADMINISTRATIVE_AREA_LEVEL_4 和 SUBLOCALITY_LEVEL_1 FeatureType。

bug 修复：

• 修复了 importLibrary() 使用的库的 TypeScript 接口为空的 bug。

3.52.4

2023 年 3 月 9 日

变更：

• [Beta 渠道] 在用户拖动标记时，抑制高级标记的点击事件。

3.52.3

2023 年 3 月 2 日

变更：

• [Beta 版渠道] 为 JavaScript 转化历程分享添加了 TaskTrackingInfo 实体。
• [Beta 渠道] 升级了 Maps JavaScript API，以原生支持 ECMAScript 2020。

bug 修复：

• 修复了向/从地图添加和移除标记时可能会发生的内存泄露问题。
• 修复了以下 bug：在触摸设备上，当可点击的高级标记位于下方时，交互式元素变为可点击状态。

3.52.2

2023 年 2 月 23 日

变更：

• [Beta 渠道] 数据驱动型样式：移除 PlaceFeature.displayName 属性。
• [Beta 版渠道] 修复了调用 setMap(null) 时 WebGLOverlayView 无法正确移除的问题
• 修复了会报出 search 库未知的 bug。
• 修复了以下 bug：InfoWindow 关闭按钮在阴影根目录中不可见。
• 为了改进核心网页指标并减少不必要的数据传输，Maps JS 现在会延迟加载地图图块，直到地图接近视口为止。在网页的初始视口中创建的地图应该没有任何差异。

3.52.1

2023 年 2 月 16 日

变更：

• 添加了 importLibrary() 函数，可在运行时动态加载库。
• [Beta 版渠道] 在高级标记上打开信息窗口时，启用信息窗口的自动平移功能。
• [Beta 版渠道] 将旅程分享库数据对象中的某些字段设为非 null 值
• [Beta 渠道] 数据驱动型样式：废弃了 NEIGHBORHOOD、ADMINISTRATIVE_AREA_LEVEL_3、ADMINISTRATIVE_AREA_LEVEL_4 和 SUBLOCALITY_LEVEL_1 FeatureType。这些指标将于 2023 年 3 月移除。

3.51.8

2023 年 2 月 2 日

变更：

• Beta 渠道：支持在自定义地图类型上渲染高级标记。
• 现在，内嵌引导加载程序加载器的最新副本将重复使用在文档其他位置找到的 CSP nonces。

3.51.7

2023 年 1 月 26 日

变更：

• Beta 渠道：数据驱动型样式：添加了 fetchPlace 方法，用于获取 PlaceFeature 的显示名称。PlaceFeature.displayName 属性将被弃用，并于 2023 年 2 月移除。

3.51.6

2023 年 1 月 19 日

bug 修复：

• 修复了高级标记存在的问题，即从地图中移除存在碰撞的标记有时会导致 DOM 中留下幽灵标记元素。

3.51.5

2023 年 1 月 12 日

变更：

• 将 AdvancedMarkerView、PinView 和 LocalContextMapView 上的 element 类型从 Element 更正为 HTMLElement | SVGElement，以更准确地表示所需的元素类型。

bug 修复：

• 修复了在将高级标记与信息窗口搭配使用时出现的 bug，即在使用键盘拖动标记后，信息窗口可能无法打开。

3.51.4

2023 年 1 月 5 日

变更：

• Beta 渠道：向地点类添加新属性
• Beta 版渠道：如果点击事件下有多个地图项，则数据驱动型样式的 FeatureMouseEvent.features 数组可能会包含多个地图项，并且系统会触发点击事件下的所有 FeatureLayer 点击监听器。
• Beta 版渠道：如果 google.maps.Map.getFeatureLayer 的参数无效，则会抛出错误。
• 更正全屏地图上高级标记的像素位置。
• 更改了地图鼠标事件，现在会忽略在另一个鼠标按钮已被按下时发生的鼠标按钮点击。
• 修复了导致高级标记在放大地图时消失的 bug。
• 改进了在包含许多高级标记的地图中放大时的性能。
• 更新了 StreetViewPanoramaOptions 文档，以说明 clickToGo 不适用于自定义全景。
• 改进了创建 LatLngBounds（包括通过 Map.getBounds()）时的性能。
• 更新了 onAdd 和 onRemove 的 WebGLOverlayView 引用。
• 为行程分享添加了固定标记样式自定义功能。

3.51.3

2022 年 12 月 8 日

变更：

• 修复了导致标记在地图视口外时不放弃键盘焦点的 bug。
• Beta 版渠道：引入了 Place 类，这是一个更简单的新 API，支持 promise 等新型使用模式。Place 类包含一些新的数据字段。
• Beta 版渠道：修复了以下 bug：在传递封装在代理中的地图时，高级标记无法呈现。
• Beta 渠道：为 JavaScript 旅程分享添加了行程位置信息提供程序标记自定义功能。

3.51.2

2022 年 12 月 1 日

变更：

• Beta 版渠道：google.maps.importLibrary() API 现已发布。
• Beta 渠道：已弃用：Local Context 已弃用，不再推荐用于新网站。此功能将继续正常运行，在停止支持之前，我们会提前 12 个月发出通知。如果您有兴趣自行打造类似于 Local Context 的体验，建议您在快速构建器中查看“街区探索”解决方案或使用 Maps JavaScript API 的地点库。 地点库的代码示例和 Codelab 可以为您提供帮助。
• Beta 渠道：为了改进 Core Web Vitals 并减少不必要的数据传输，Maps JS 现在会将地图图块的加载推迟到地图靠近视口为止。在网页的初始视口中创建的地图应该没有任何差异。
• Beta 渠道：针对旅程分享位置信息提供程序添加了用于轮询状态更改事件的事件。
• Beta 版渠道：为行程分享添加了样式自定义功能。弃用了旧版设置方法。
• 在路线面板的路段中添加了键盘无障碍功能。现在，您可以使用 Tab 键浏览路线，也可以使用空格键或 Enter 键选择。
• google.maps.geometry.spherical.computeArea() 现在接受 LatLngBounds 和 Circle。现在可以使用 LatLngBoundsLiteral 构造 LatLngBounds。
• 在 DirectionRenderer 的建议路线面板中为图片添加 alt 文本。

3.51.1

2022 年 11 月 17 日

变更：

• Beta 版渠道：发布了 Places 库中的 Place 类。
• Beta 版渠道：为行程分享添加了样式自定义功能。旧版设置方法已废弃。
• Maps Embed API 中的 Internet Explorer 11 现已停用。
• 使用混合地图或卫星地图类型时，Maps Embed API 中的 Google 徽标会更改样式，以提高可见度
• 改进了高级标记的加载性能。
• 使绘图“撤消”按钮可供访问且支持屏幕阅读器。
• 使路线渲染程序的标记支持键盘操作且支持屏幕阅读器。
• 向地图比例控件添加 ARIA 说明。
• 为地图的比例控件启用键盘焦点和互动。
• 向 Geocoder JS API 引入了语言参数。如果未明确指定 US，Maps JS API 将不再将其视为 Geocoder 中的默认区域。
• 向 Directions JS API 引入了语言参数。
• 向 Distance Matrix JS API 引入了语言参数。

bug 修复：

• 修复了以下 bug：在打开信息窗口时，键盘焦点会重定向到标记。
• 修复了导致标记无法聚焦的 bug。

3.51

2022 年 11 月 16 日

变更：

• 每周渠道已更新至版本 3.51。
• 季度渠道已更新至版本 3.50。
• 您仍然可以通过编号请求版本 3.49 和 3.48。

3.50.12a

2022 年 11 月 7 日

变更：

• 修复了 google.maps.event.addListenerOnce 和 google.maps.event.addDomListenerOnce 具有不正确的 this 绑定的问题。

3.50.12

2022 年 11 月 3 日

变更：

• Beta 版渠道：高级标记现在支持在倾斜地图上使用时显示海拔高度。

3.50.11

2022 年 10 月 27 日

变更：

• Beta 版渠道：当数据驱动型地图项图层不可用时，现在会记录错误。
• Beta 版渠道：改进了默认高级标记的加载性能。

3.50.10

2022 年 10 月 20 日

bug 修复：

• 修复了 iOS 上的信息窗口右侧和底部内边距。

3.50.9

2022 年 10 月 13 日

变更：

• 现在，所选步骤会在路线面板中突出显示。
• 修复了 PinView 构造函数的 TypeScript 类型。
• 修复了 LagLngAltitude 构造函数的 TypeScript 类型问题。
• 更新了 DirectionsRenderer 中的默认标记图标图片。

3.50.8

2022 年 10 月 6 日

变更：

• Beta 版渠道：发布了高级标记预览版。
• Beta 渠道：引入了有关 getMapCapabilities() 返回对象的 isAdvancedMarkersAvailable 的文档。
• 向 LocalContextMapView 的 API 说明和 LocalContextMapViewOption 的 element 属性添加了“此字段为只读字段”

bug 修复：

• JSON 自定义样式中的颜色现在使用默认样式的不透明度，而非强制的 100% 不透明度。

3.50.7

2022 年 9 月 29 日

变更：

• 现在，屏幕阅读器会读出有关如何与地图和街景互动的说明。
• 向键盘快捷键对话框添加倾斜和旋转键盘快捷键。

3.50.6

2022 年 9 月 22 日

bug 修复：

• 修复了以下 bug：iOS 上的语音朗读功能可以浏览键盘快捷键对话框下方的元素。
• 为静态地图图片添加替代文本。

变更：

• 现在，调用 map.getMapCapabilities() 时，控制台会记录错误。

3.50.5

2022 年 9 月 15 日

变更：

• 为 LatLngBounds 添加了 MAX_BOUNDS 常量，用于指示地图的最大 LatLng 边界
• 允许屏幕阅读器对默认标记执行点击操作。

3.50.3

2022 年 9 月 1 日

变更：

• Beta 版渠道：更新了 JavaScript 历程共享的 DeliveryVehicle 类，以添加自定义属性。
• 修复了以下 bug：在倾斜地图后，事件中的 LatLng 不正确。

3.50.2

2022 年 8 月 25 日

变更：

• Beta 版渠道：将 FleetEngineDeliveryFleetLocationProvider 更改为接受字符串传送车辆过滤条件。
• 更新了默认标记图标图片。

3.50.1

2022 年 8 月 18 日

变更：

• Beta 渠道：在 Beta 渠道中引入了地图功能 API（getMapCapabilities 和 mapcapabilities_changed 事件）。
• Beta 渠道：为 google.maps.Geocoder 引入了 language 参数。
• Beta 版渠道：向 google.maps.DistanceMatrixService 引入了 language 参数。
• Beta 渠道：为 google.maps.DirectionsService 引入了 language 参数。
• 修复了多个 Places JS API 中忽略地区代码的 bug。向各种 Place JS API 引入了语言和地区参数。
• 移除了 Maps JavaScript API 街景中对内容安全政策设置中不含 googleapis.com 网域的网站的支持。如需了解详情，请参阅内容安全政策指南。

3.49.12

2022 年 8 月 4 日

变更：

• 添加了 DEMO_MAP_ID，这是一个地图 ID，可用于需要地图 ID 的代码示例。此地图 ID 不适用于生产应用，也不能用于需要云端配置的功能（例如云端地图样式）。
• 明确说明需要 FleetEngineDeliverFleetLocationProvider.locationRestriction 才能开始跟踪。

3.49.11

2022 年 7 月 28 日

变更：

• 现在可以将 google.maps.VehicleType 作为运行时枚举引用。

3.49.10

2022 年 7 月 21 日

变更：

• 在验证标记图标大小、标记图标放大大小或信息窗口大小时，系统会拒绝宽度或高度的 NaN 值。
• 修复了以下 bug：在 iOS 设备上，街景中的动作跟踪控件不可见。
• 修复了 Embed API 中 RTL 语言的路线悬停文本被截断的 bug。
• 使公交信息窗口更易于访问，更易于屏幕阅读器使用。

3.49.9

2022 年 7 月 14 日

变更：

• 阐明了“历程共享”位置信息提供程序中 ID 字段的用法。

3.49.8

2022 年 7 月 7 日

变更：

• 使街景导航链接可通过键盘访问且支持屏幕阅读器。
• 在 StreetViewPanorama 上引入了新的 focus 方法。

3.49

2022 年 6 月 23 日

变更：

• Beta 渠道：发布了 Google 边界的数据驱动型样式。

bug 修复：

• 使 BusinessStatus 枚举可通过 google.maps.places.BusinessStatus 访问。

3.49.5

2022 年 6 月 16 日

变更：

• 向街景添加了键盘快捷键控件和对话框，提高了键盘快捷键的可检测性。

bug 修复：

• 修复了关闭街景时导致表单提交的错误。

3.49.4

2022 年 6 月 9 日

变更：

• 将 WebGLOverlayView、CameraParams、LatLngAltitude、moveCamera、小数缩放和 getVisibleRegion 移到了每周渠道。
• Map 的默认街景全景图片现在会在打开时自动管理焦点。这是新的默认行为。
• 现在，街景全景图片会在关闭（如果可能）时自动恢复焦点。
• 现在，您可以按 ESC 键关闭街景（前提是关闭按钮处于启用状态）。
• geometry.spherical.computeSignedArea() 和 geometry.spherical.computeArea() 经过优化，提高了稳健性和准确性。

3.49.3a

2022 年 6 月 2 日

变更：

• 改进了 Google 街景动作跟踪控件的颜色对比度。
• 使街景中的动作跟踪控件支持键盘操作，并支持屏幕阅读器。
• MapsNetworkError、MapsRequestError 和 MapsServerError 类现已公开提供并记录在案。

3.49.2

2022 年 5 月 26 日

变更：

• 改进了 Google 街景动作跟踪控件的颜色对比度。
• 使街景键盘中的动作跟踪控件易于访问且支持屏幕阅读器。
• MapsNetworkError、MapsRequestError 和 MapsServerError 类现已公开并记录在案。

3.49.1

2022 年 5 月 19 日

变更：

• Beta 渠道：修复了多个 Places JS API 中区域代码被忽略的 bug。向各种 Place JS API 引入了语言和地区参数。
• 提高了深色模式下全屏和罗盘控件的色彩对比度。
• 使街景罗盘控件、关闭按钮和地址链接控件可供屏幕阅读器使用且符合无障碍设计。

3.49

2022 年 5 月 12 日

变更：

• 每周渠道会更新到版本 3.49。
• 季度渠道更新为版本 3.48。
• 您仍然可以通过编号请求版本 3.47 和 3.46。
• 版本 3.45 已被删除，无法再使用。

3.48.11

2022 年 4 月 28 日

变更：

• 地点自动补全功能现在可以接受更多类型。 了解详情。
• “isFractionalZoom”已移至每周渠道。

3.48.9

2022 年 4 月 14 日

变更：

• Beta 版：为 WebGLOverlayView 启用 WebGL 2.0。
• Beta 渠道：将 JourneySharing 库纳入到 Maps JavaScript API TypeScript 类型、外部函数和参考文档中。
• 函数 google.maps.event.addDomListener() 和 google.maps.event.addDomListenerOnce() 已废弃，不应继续使用。请改用标准 addEventListener() 方法。这些方法仍继续有效，并且我们不打算停用它们。
• 向街景标记图标添加了 title 和 aria-label。
• 为 Fullscreen 控件添加 aria-pressed 属性。
• 改进了地图类型控件的下拉菜单的间距。
• 更新了地图类型下拉菜单控件的 ARIA 标签。

bug 修复：

• 从默认地图类型控件中移除不允许的 aria-expanded 属性。

3.48.8

2022 年 4 月 7 日

变更：

• 改进了 Maps JS API 和 Embed API Google 徽标的颜色对比度。

3.48.7a

2022 年 3 月 31 日

变更：

• Beta 渠道：移除了已废弃的 WebGL Overlay View API。
• 为 Maps JavaScript API 客户启用更新后的基本地图。更新后的基本地图已在消费者 Google 地图上使用，可提供更丰富、更详细的基本地图，尤其是与大陆自然特征相关的地图。

bug 修复：

• 还原了 map.fitBounds() 的之前的修复（缩短视口转换距离），正在等待分析。
• 修复了高对比度模式下地图类型控件上的颜色对比度问题。
• 将地图类型控件复选框的可访问名称与相应的视觉标签相匹配。
• 修复了高色彩对比度模式下信息窗口的颜色对比度问题。

3.48.6

2022 年 3 月 24 日

变更：

• 修复了 map.fitBounds()，以简化短距离的视口过渡。

3.48.5

2022 年 3 月 17 日

变更：

• 仅限 Safari：确保关闭按钮和内容容器在 open 上自动聚焦。

bug 修复：

• 修复了 InfoWindow 上“在 Google 地图上查看”链接的色彩对比度问题。
• 修复了 StreetViewPanorama 地址控件上的“在 Google 地图上查看”链接的颜色对比度问题。

3.48.4

2022 年 3 月 10 日

变更：

• 为 InfoWindow 引入了新的 visible 事件。
• 在 InfoWindow 上引入了新的 focus 方法。

3.48.3

2022 年 3 月 3 日

变更：

• Beta 版渠道：在 Maps JavaScript API 街景服务中启用新的服务调用样式。您可能需要更新内容安全政策，以确保这些调用不会在浏览器级别被屏蔽。
• 为 InfoWindow 引入了新的 ariaLabel 属性。

3.48.1

2022 年 2 月 17 日

变更：

• Beta 版渠道：添加了对设置全局体验 ID 的支持。请点击此处查看 API 参考文档。
• 测试版渠道：现在，fromLatLngAltitude的第一个和第二个参数将合并为一个LatLngAltitude，而非LatLng和number。
• 将 LatLng 的 noWrap 参数重命名为 noClampNoWrap。
• 现在，当标记获得焦点时，屏幕阅读器会读出有关如何浏览标记的说明。
• Maps JavaScript API 现在会报告遥测信息。您可能需要更新内容安全政策，以确保这些调用不会在浏览器级别被阻止。有关详情，请参阅常见问题解答。
• 此版本不支持 Internet Explorer。如需继续支持 Internet Explorer 11，请指定 v=3.47，该版本将在 2022 年 11 月之前提供。

3.48

2022 年 2 月 10 日

变更：

• 每周渠道已更新至版本 3.48。
• 季度渠道已更新至版本 3.47。
• 您仍然可以通过编号请求版本 3.46 和 3.45。

3.47.6

2022 年 1 月 20 日

bug 修复：

• 修复了键盘快捷键控件获得焦点时页面滚动到顶部的问题。

3.47.4

2022 年 1 月 6 日

变更：

• 测试版渠道：针对测试版的 WebGLOverlayView API 更新 - 弃用名称中带有“gl”的所有类和方法，代之以名称中带有“GL”的新类和方法，弃用 WebglCameraParams，取而代之的是新的 CameraParams 类（其子类是 CameraOptions）。
• 更新了 PlaceOpeningHours 方法文档，指出在计算时未使用特殊营业时间。

3.47.3

2021 年 12 月 9 日

变更：

• LatLng、LatLngBounds 和 Circle 现在在构造函数中接受同一类的实例。

3.47.2

2021 年 12 月 2 日

变更：

• 现在，在允许使用 LatLng 的任何位置，都可以使用 LatLngLiteral 作为投影参数。

bug 修复：

• 修复了使用较小缩放值（小于 1.0）时可能发生的一些渲染问题。

3.47.1

2021 年 11 月 18 日

变更：

• 现在，在几何图形库中允许使用 LatLng 的任何位置都允许使用 LatLngLiteral 作为参数。
• 在 Maps JavaScript API 中添加了新的 onGIStateUpdateRequest API，以支持 WebGL。
• 修复了错误屏幕上的颜色对比度。
• Internet Explorer 11 现已在 v=beta 中弃用。支持 Internet Explorer 11 的最后一版 Maps JavaScript API 是 v3.47。我们将于 2022 年 11 月完全停止对 Internet Explorer 11 的支持。
• 将 keyboardShortcuts 地图选项设为 false 后，Google 地图不再获得标签页焦点。
• 现在，当达到相应的最大或最小缩放级别时，“放大”和“缩小”按钮会停用。
• 将 MapType 控件转换成了使用语义元素，以改进 Maps Embed API 中的无障碍功能和屏幕阅读器体验。
• 为错误页面上的图标添加了替代文本。
• 各种常规代码运行状况改进。

bug 修复：

• 将不符合 WCAG 要求的 controlHeight 和 controlWidth 属性替换为符合 WCAG 要求的 data-* 属性。

3.47

2021 年 11 月 11 日

变更：

• 每周渠道已更新至版本 3.47。
• 季度渠道已更新至版本 3.46。
• 在收到号码请求时，版本 3.45 仍然可用。
• 版本 3.44 已被删除，不能再使用。

3.46.12

2021 年 11 月 4 日

bug 修复：

• 更新了“地图类型”菜单栏，添加了更准确的 ARIA 标签。
• Embed API：向多个链接添加了 ARIA 标签，以改善屏幕阅读器体验。
• Embed API：修复了某些文本项的颜色对比度问题。
• 修复了 externs 中的 google.maps.Marker.MAX_ZINDEX 类型。

3.46.11

2021 年 10 月 28 日

变更：

• 将 getter 和 setter 转换为使用 goog.a11y.aria。这有助于防止拼写错误。

3.46.8

2021 年 10 月 7 日

变更：

• 本地情境：从本地情境信息窗口照片中移除了归属链接。

3.46.6

2021 年 9 月 23 日

变更：

• 修复了以下 bug：当地图不可拖动时，地图光标会显示手形。

3.46.5

2021 年 9 月 16 日

bug 修复：

• 修复了地点自动补全微件中的色彩对比度 bug。

3.46.3

2021 年 9 月 2 日

变更：

• 滚动说明现在显示在打开的 InfoWindow 和 CustomOverlay 上方。

3.46.2

2021 年 8 月 26 日

变更：

• Beta 版：现在可报告遥测信息。您可能需要更新内容安全政策，以确保这些调用不会在浏览器级别被阻止。有关详情，请参阅常见问题解答。

3.46

2021 年 8 月 18 日

Maps JavaScript API 3.46 版现已发布。 请参阅版本控制指南。

变更：

• 向 PlaceResult、icon_mask_base_uri 和 icon_background_color 添加了两个新字段。
• 每周渠道已更新至版本 3.46。
• 季度渠道已更新至版本 3.45。
• 您仍然可以通过编号请求版本 3.44。
• 版本 3.43 已被删除，不能再使用。

弃用：

• 我们即将弃用对 Internet Explorer 的支持。从 2021 年 8 月开始，使用 Maps JavaScript API v3.46 的 Internet Explorer 11 用户会在地图顶部看到一条警告消息。支持 Internet Explorer 11 的最后一版 Maps JavaScript API 是 v3.47。我们将于 2022 年 11 月完全停止对 Internet Explorer 11 的支持。

bug 修复：

• 修复了在某些缩放级别下多边形的顶点会发生偏移的 bug。
• 修复了多个信息窗口的内容相互重叠的 bug。

3.45.8

2021 年 7 月 29 日

变更：

• Embed API：在嵌入式地图中，重定向到路线页面后，缩放级别会保留。

3.45.7

2021 年 7 月 22 日

变更：

• 弃用了对 IE11 的支持。IE11 中的 Google 地图现在会在 Beta 版渠道中显示横幅。
• 更新了嵌入式地图中的“查询路线”链接，使之更加准确。

bug 修复：

• 修复了 getFeatureById() 方法无法检索 ID 为 0 的地图项的问题。
• 修复了以下问题：如果 ComponentRestriction 值未定义或为 null，则会抛出 UNKNOWN ERROR/SERVICE BACKGROUND ERROR。

3.45.6a

2021 年 7 月 15 日

变更：

• 打开后，当第一个可聚焦控件不在信息窗口视口中时或当 disableAutoPan=true 时，焦点会由 InfoWindow 容器管理。

bug 修复：

• 修复了以下 bug：移除绘制管理器并将其重新添加到地图后，未完成的多边形绘制会自动完成。
• 修复了在某些语言的“嵌入地图”弹出式窗口中字符串“Directions”被截断的 bug。

3.45.5

2021 年 7 月 1 日

变更：

• 更新了类型和 JS API 中 Maps Studio 的网址。

bug 修复：

• 修复了提供回调时未处理的 Promise 拒绝问题。

3.45.4

2021 年 6 月 24 日

变更：

• 修复了导致在提交表单时打开键盘快捷键对话框的错误。
• 修复了“键盘快捷键”按钮不对齐的错误。
• 移除了意外添加到 window 的对象（Spherical、多段线 Codec、PolyGeometry）。应改为在其完全限定的命名空间中访问这些对象。

3.45.3

2021 年 6 月 16 日

bug 修复：

• 更新了 InfoWindow，以便在与地图实例化相同的运行循环内调用 open() 时，焦点不会移动。

变更：

• 更新了 InfoWindowOpenOptions API 参考部分，在其中添加了更多详细信息。
• 修复了在 Safari 中使用键盘导航（Tab + Option）时出现的焦点圈问题。

3.45.2

2021 年 6 月 10 日

bug 修复：

• 修复了地图类型控件在 Embed API 中无法正确叠加到键盘快捷键对话框的背景的问题。
• 修复了在加载字体 CSS 样式时可能会导致错误的问题。
• 修复了在信息窗口处于打开状态时平移地图时可能会发生闪烁的错误。

变更：

• 添加了 InfoWindowOpenOptions.map 属性。

3.45.1

2021 年 6 月 3 日

变更：

• 向 Data.StyleOptions 接口添加了有关动画、图标、标签和不透明度属性的文档。
• 重新设计了版权对话框，以提供更好的可访问性支持。
• InfoWindows 现在会在打开时自动管理焦点。这是新的默认行为。
• 添加了InfoWindowOpenOptions API，可让开发者在打开信息窗口时控制焦点的管理方式。
• 现在，您可以通过按下 Esc 键关闭 InfoWindows。
• 现在，当用户使用屏幕阅读器时，信息窗口会读出为“对话框”。
• 现在已启用 polyfill 隔离；此更改可防止在托管页面上安装 Maps API 内部 polyfill。

bug 修复：

• 修复了切换浏览器标签页时会显示地图焦点圈的问题。
• 修复了以下问题：在某些浏览器中，地图控件、标记元素和地图类型控件子菜单项的焦点圈在鼠标互动时显示不正确。

新功能：

• 在路线、距离矩阵、海拔、地理编码器、最大缩放图像、街景和 AutcompleteService.getPlacePredictions() 服务中启用了对Promise 的支持。
• 在地图上添加了键盘快捷键控件和对话框，以提高键盘快捷键的可检测性。
• 矢量地图现已在每周渠道中提供（仅限基本功能；WebGL 功能仅在 Beta 渠道中提供）。

3.44.14

2021 年 5 月 13 日

变更：

• 现在，如果调用 InfoWindow.open() 时没有关联的地图或街景实例，系统会将警告记录到控制台。

3.44.12

2021 年 4 月 28 日

bug 修复：

• 修复了以下问题：在更改为新地图类型后，移除或隐藏的优化标记会重新添加到地图中。

Local Context：

• 添加了对未将 @@iterator 方法定义为有效 placeTypePreferences 值的数组的支持。

3.44.11a

2021 年 4 月 20 日

变更：

• 改进了使用 Icon 对象创建自定义标记的性能。
• 阻止焦点在悬停在按钮上时移至地图类型下拉菜单。

bug 修复：

• 修复了在初始化基本地图之前加载静态标记时可能会出错的 bug。

3.44.9

2021 年 4 月 8 日

bug 修复：

• 修复了启用街景时可通过键盘访问地图控件的错误。

3.44.8

2021 年 4 月 1 日

变更：

• Local Context Library：将地点详情视图中的 Google 徽标移至内容底部。

3.44.7

2021 年 3 月 25 日

变更：

• 现在，关闭信息窗口后，键盘焦点会返回到相应的元素。

3.44.4

2021 年 3 月 4 日

变更：

• 45° 角航拍图像现在在更广泛的缩放级别中可用，旋转控件现在包含顺时针和逆时针按钮。

bug 修复：

• 修复了反复渲染地图时可能会发生的内存泄露问题。
• 修复了在地图上添加或移除圆形或矩形时可能发生的内存泄漏问题。

3.44.2

2021 年 2 月 25 日

变更：

• 修复了以下 bug：地点自动补全 getPlacePredictions 函数调用在 Beta 版渠道中错误地指向错误的端点。

3.44.1

2021 年 2 月 18 日

变更：

• 现在，重新加载显示的地点时，LocalContext 地点选择器按钮会被停用。
• 非优化标记现在可聚焦，并且可通过键盘访问。
• Beta 版渠道：移除了意外添加到 window 的对象 (Spherical、PolylineCodec、PolyGeometry)。应改为通过其完全限定命名空间访问这些对象。
• 已在 Beta 渠道中开启 Polyfill 隔离功能。这意味着 Maps JavaScript API 不会再将 polyfill 安装到托管网页中。

3.43.8a

2021 年 2 月 25 日

只有季度渠道更新了。变更：

• 修复了多次渲染地图时出现的内存泄漏问题

3.43.8

2021 年 2 月 5 日

变更：

• 在 AutocompleteService.getPlacePredictions() 中添加了对Promise 的 Beta 版支持。

bug 修复：

• 修复了带有标签的 Markers 拦截点击事件的问题，即使 clickable 设置为 false 也是如此。

3.43.7a

2021 年 1 月 28 日

bug 修复：

• 修复了与多段线的绘制有关的各种问题。

3.43.6

2021 年 1 月 21 日

bug 修复：

• 修复了有时会填充 GeoJSON 多边形洞的 bug。
• 修复了在地图和街景之间切换时导致叠加层消失的错误。

3.43.5

2021 年 1 月 14 日

变更：

• 更改了菜单中的复选框，以便屏幕阅读器更易于访问。
• 增大了室内街景全景图的楼层按钮的大小。
• 修复了街景中移动设备动作跟踪控件的显示位置。

bug 修复：

• 键盘菜单按钮现在会触发 contextmenu 事件。
• 修复了在某些情况下，在地图和街景之间切换时全屏控件无法正常工作的 bug。
• 修复了屏幕阅读器无法导航到地图中的标记的问题。
• 修复了导致 LocalContext 的地点标记中地点图标消失的 bug。

3.43.3

2020 年 12 月 9 日

变更：

• 将 google.maps.MouseEvent 接口重命名为 google.maps.MapMouseEvent，并添加了 domEvent 属性，以便从 DOM 直接访问底层事件。
• 改进了多边形叠加层的内存行为。
• 现在，系统会明确释放画布内存，以避免 Safari 内存问题。

bug 修复：

• 修复了在某些情况下，在全屏模式和街景模式之间切换时全屏控件停止工作的问题。
• 修复了控制台中针对标记的 click 事件记录错误的问题。
• 修复了标记的可点击区域尺寸绘制得过大的 bug。
• 修复了一个 polyfill 冲突错误，该错误会影响 IE11 上的符号。

3.43.2

2020 年 12 月 1 日

变更：

• 添加了 contextmenu 事件，作为 rightclick 事件的更好替代方案。 contextmenu 事件添加了在 macOS 上响应 Ctrl 点击的功能。
• 在提供 title 或 label 时，向未优化的标记添加无障碍功能属性。
• 为 MapType 控件添加了更多 ARIA 标签和角色，以提升屏幕阅读器体验。
• 改进了对 MapType 控件的屏幕阅读器支持。当用户离开控件时，下拉菜单会自动关闭。
• 更正了屏幕阅读器在下拉菜单中报告的项数量；这可防止将行分隔符计为列表项。
• 在 map 元素中添加焦点环，以指示通过键盘互动获得焦点时键盘焦点。
• 向 MapType 控件添加了额外的键盘控件。 现在，当控件失去焦点时，下拉菜单选项会自动关闭。向上键和向下键可打开下拉菜单，Esc 按钮可关闭下拉菜单。 Home 键和 End 键分别可移动到下拉菜单中的第一个和最后一个项目。

bug 修复：

• 修复了以下 bug：在某些情况下，取消标记动画可能会导致该特定标记提前终止未来的动画。

3.43.1a

2020 年 11 月 20 日

变更：

• 向 MarkerLabel 接口添加 className 属性，以设置 label 元素的 CSS 类。
• 在图像最大缩放级别服务中添加了对Promise 的 Beta 版支持。
• 在 StreetView 服务中添加了对Promise 的 Beta 版支持。
• 在提供 title 或 label 时，为未优化的标记添加了无障碍功能文本。
• 从 MapType 控件下拉菜单按钮中移除了 aria-pressed 标签，以提高无障碍功能。
• 已将 DropdownMenu 和 DropdownMenuItem 转换为语义元素，以改进无障碍功能。
• 更改了版权元素文本，使其符合颜色对比度标准。
• 现在，您可以使用 Enter 键或空格键打开和关闭下拉菜单。
• 下拉菜单项现在可以聚焦。
• Local Context Library：轮播控件按钮现在处于无效状态时会被停用，并且不会再与列表中的第一项或最后一项重叠。

bug 修复：

• 修复了 GroundOverlays 越过 180 度经线时可能会发生的 bug。
• 当 disableDefaultUI 设为 true 时，默认情况下不再停用键盘快捷键。
• 修复了地图切换按钮的屏幕阅读器文本不正确的 bug。
• 向 Map 添加了无障碍功能名称和类型。
• 修复了接口文档，它错误地将某些可选属性显示为必需属性。
• 修复了在传递 LatLngLiteral 时 noWrap LatLng 构造函数参数会被忽略的 bug。

3.43

2020 年 11 月 18 日

Maps JavaScript API 3.43 版现已发布。 请参阅版本控制指南。

• 每周渠道已更新至版本 3.43。
• 季度渠道已更新至版本 3.42。
• 在收到号码请求时，版本 3.41 仍然可用。
• 版本 3.40 已被删除，不能再使用。

3.42.9

2020 年 10 月 15 日

变更：

• 修复了屏幕阅读器传达错误复选框状态的 bug。
• 修复了 Tab/Shift+Tab 键顺序错误的地图控件问题。
• 将地图按钮从 div 转换为原生按钮，以提高无障碍功能。
• 现在，倾斜度受限于 WebGL 地图的缩放级别。
• 修复了当 controlSize 低于 27 时，全屏按钮在 Internet Explorer 上部分消失的问题。

3.42.8

2020 年 10 月 7 日

变更：

• 在路线服务中添加了对 promise 的 Beta 版支持。
• 地理编码器 componentRestrictions 现在会对空字符串执行验证检查。
• 修复了 Safari 上的标记标签被自定义标记符号覆盖的 bug。

支持更新的地点图标

2020 年 10 月 1 日

通过“地点详情”和“地点搜索”请求返回的图标已更新为使用新的图标字形。您无需执行任何操作，系统会自动显示新字形。

3.42.7

2020 年 9 月 29 日

变更：

• 修复了以下 bug：对于“报告地图错误”控件提示，RTL（从右到左）语言的词序不正确。
• RTL 文本方向的居中标记标签。

3.42.6

2020 年 9 月 21 日

变更：

• 在距离矩阵服务中添加了对promise 的 Beta 版支持。

3.42.5

2020 年 9 月 16 日

变更：

• 更新了 LatLngBounds.union 方法，以处理两个边界超过 180 度的情况。

3.42.4

2020 年 9 月 8 日

变更：

• 现在，当检测到无效的 Date.now() 实现时，控制台中会记录错误。
• 在海拔服务方法中添加了对 Promise 的 Beta 版支持。
• 引入了新的 InfoWindow.minWidth 属性，用于指定 InfoWindow 的最小宽度。
• 修复了更改目的地后导航路线变得模糊不清的 bug。

3.42

2020 年 8 月 19 日

Maps JavaScript API 3.42 版现已发布。请参阅版本控制指南。

变更：

• InfoWindow 的默认最大宽度现在为 648 像素，您可以通过设置 InfoWindow maxWidth 属性来覆盖此值。InfoWindow 的宽度现在可以超过 648 像素，但仍会受到地图宽度的限制。（之前，信息窗口的宽度始终限制为 648 像素或地图宽度中的较小者。）
• 在渲染大型 GeoJson 数据集时，防止默认样式的渲染闪烁。

• 每周渠道已更新至版本 3.42。
• 季度渠道已更新至版本 3.41。
• 应号码请求，版本 3.40 仍然可用。
• 版本 3.39 已被删除，无法再使用。

3.41.7

2020 年 7 月 22 日

修复了以下问题：

• 修复了以下 bug：使用 Cloud Styling 时，将 clickableIcons 属性设置为 false 没有任何效果。

3.41.5

2020 年 7 月 6 日

变更：

• 修复了可信类型违规问题。

3.41.2

2020 年 5 月 27 日

变更：

• Maps JavaScript API 地点库中的“地点”字段 permanently_closed 已弃用。

3.41

2020 年 5 月 20 日

Maps JavaScript API 3.41 版现已发布。 请参阅版本控制指南。

• 每周渠道已更新至版本 3.41。
• 季度渠道已更新至版本 3.40。
• 您仍可以通过编号请求版本 3.39。
• 版本 3.38 已被删除，无法再使用。

3.40.11

2020 年 4 月 28 日

变更：

• 向地点搜索结果和地点详情结果中添加了新字段 business_status。请使用此字段而不是 permanently_closed。
• 修复了请求（新）PlaceResult.utc_offset_minutes 时出现的错误控制台警告；现在，系统会针对已废弃的 PlaceResult.utc_offset 返回警告。

3.40.9

2020 年 4 月 14 日

变更：

• 现在，如果传递的 mapDiv 不是元素，Map 会抛出更易于诊断的 InvalidValueError。
• Chrome 浏览器将不再向服务器发出自动填充地址到 google.maps.places.Autocomplete 的自动补全请求（这将避免产生费用）。
• 提高了 maxWidth 属性的准确性。在此变更之前，如果您将 InfoWindow 的 maxWidth 指定为 100，则 InfoWindow 的实际最大宽度将为 94 像素。 此更改生效后，实际宽度上限将为 100 像素。
• 修复了使用标记和地图边界时绘制请求构建器的内存泄漏问题。

3.40.6

2020 年 3 月 24 日

变更：

• 已修复 IE11 行程时间字段中的文本截断问题。

3.40.4

2020 年 3 月 10 日

变更：

• 修复了调用 setTilt() 两次会导致地图偏斜的 bug。

3.40.2

2020 年 2 月 23 日

变更：

• 已从标签页导航中移除地图中隐藏的 iframe。

3.40.1

2020 年 2 月 18 日

变更：

• 不针对 v=beta 的 InvalidVersion 发出警告。
• 修复了显示街景时滚动时出现的问题。

3.40

2020 年 2 月 11 日

Maps JavaScript API 3.40 版现已发布。请参阅版本控制指南。

• 每周渠道已更新至版本 3.40。
• 季度渠道已更新至版本 3.39。
• 您仍可以通过编号请求版本 3.38。
• 版本 3.37 已被删除，不能再使用。

3.39.6

2020 年 1 月 8 日

Maps JavaScript API 3.39.6 版现已发布。 请参阅版本控制指南。

修复了以下问题：

• 对于路线请求，ZERO_RESULTS 现在会记录到控制台，而不会再导致错误日志。

3.39

2019 年 11 月 20 日

Maps JavaScript API 3.39 版现已发布。请参阅版本控制指南。

变更：

• 我们已不再支持 Internet Explorer 10（3.38 版是支持该浏览器的最后一个版本）。
• AutocompletePrediction 现在会返回从指定的原点纬度/经度到所选地点的直线距离。

弃用：

• “地点”字段 open_now 和 utc_offset 自 2019 年 11 月 20 日起弃用，自 2021 年 2 月 20 日起停用。如需了解详情，请参阅“地点”字段迁移。

• 每周渠道已更新至版本 3.39。
• 季度渠道已更新至版本 3.38。
• 您仍可通过编号请求版本 3.37。
• 版本 3.36 已被删除，无法再使用。

3.38

2019 年 8 月 20 日

Maps JavaScript API 3.38 版现已发布。请参阅版本控制指南。

• 每周渠道已更新至版本 3.38。
• 季度渠道已更新至版本 3.37。
• 您仍可通过编号请求版本 3.36。
• 版本 3.35 已被删除，无法再使用。
• 无法再使用 Fusion Tables（3.37 版是上一个支持该表的版本）。
• 我们现已弃用对 Internet Explorer 10 的支持，并将于 2019 年 11 月至 2020 年 5 月之间停止支持，具体取决于您使用的发布渠道或版本号。

3.37

2019 年 5 月 15 日

Maps JavaScript API 3.37 版现已发布。 请参阅版本控制指南。

• 每周渠道已更新至版本 3.37。
• 季度渠道已更新至版本 3.36。
• 您仍可通过电话请求版本 3.35。
• 版本 3.34 已被删除，无法再使用。
• Internet Explorer 9 已无法再使用（上次支持 Internet Explorer 3.34 的版本）。

3.36

2019 年 2 月 14 日

Maps JavaScript API 3.36 版现已发布。 请参阅版本控制指南。

变更：

• 添加了以下新功能：
• 您现在可以使用 MapOption.controlSize 更改地图控件的大小。
• 您现在可以使用 MapOptions.restriction 限制地图边界。
• 改善了信息窗口。
• 每周渠道已更新至版本 3.36。
• 季度渠道已更新至版本 3.35。
• 您仍然可以通过编号请求版本 3.34。
• 版本 3.33 已被删除，不能再使用。

3.35

2019 年 1 月 29 日

变更：

• 该 API 现在可以返回每个地点的评价总数。
• 添加了对Plus 代码的支持。Plus 代码是一种短代码，可为世界各地的每个地点提供地址，即使在没有传统街道地址的地区也是如此。
• Internet Explorer 9 已不再受支持。

弃用：

• Autocomplete 的 placeIdOnly 参数已弃用。
• Maps JavaScript API 中的 Fusion Tables 图层自 2018 年 12 月 3 日起弃用。 Fusion Tables 图层将于 2019 年 12 月 3 日彻底停用，届时将无法再使用。 了解详情。

2018 年 11 月 13 日

Maps JavaScript API 3.35 版现已发布。请参阅版本控制指南。

变更：

• 每周渠道已更新至版本 3.35。
• 季度渠道已更新至版本 3.34。
• 通过编号请求时，您仍可以使用版本 3.33。
• 版本 3.32 已被删除，无法再使用。

3.34

2018 年 8 月 14 日

Maps JavaScript API 3.34 版现已发布。 请参阅版本控制指南。

变更：

• 已实现新的版本名称。 您现在可以指定发布渠道或版本号：
  • 每周渠道已更新至版本 3.34。
  • 季度渠道已更新至版本 3.33。
  • 版本 3.32 仍可供使用。
  • 版本 3.31 已被删除，无法再使用。 如果客户指定 3.0 到 3.31 之间的版本，则系统会改为采用其默认渠道（每周渠道或季度渠道，请参阅版本控制指南）。
• 现在，系统启用了更大的控件界面。 随着各种设备上的触控操作越来越多，我们调整了控件界面，使其适用于手指轻触和鼠标点击。 （您可以通过使用 v=quarterly、v=3.33 或 v=3.32 加载该 API 来选择停用此功能。）

3.33

2018 年 6 月 11 日

变更：

• 地点详情请求现在支持使用字段指定要返回的地点数据类型。
• 现在，我们推出了两项新的“查找地点”请求：
  • 通过查询查找地点
  • 通过电话号码查找地点
• 地点自动补全功能现已支持基于会话的结算方式。

2018 年 5 月 16 日

Maps JavaScript API 3.33 版现已作为实验版本发布。请参阅 API 版本控制指南。

变更：

• 新版渲染程序现已成为默认渲染程序。
• 新的基本地图现已成为默认地图。

3.32

2018 年 2 月 13 日

变更：

• 现已推出新的实验性渲染程序。
• 新的实验性基础地图现已推出。

3.31

2018 年 2 月 13 日

变更：

• 默认情况下，将前 256 个标记设为 DOM 标记，然后将后续标记设为功能块标记。当前默认值为所有功能块标记。
• 在高缩放级别（放大）下拖动街景小人时，首选 NEAREST，而不是 Google 选择的 BEST 全景图。
• 现在，在 mousedown 处理程序内更改时，gestureHandling: none 的工作方式与 draggable: false 相同（现在会在 mousedown 上生效）。

2017 年 11 月 21 日

Maps JavaScript API 3.31 版现已作为实验版提供。 请参阅 API 版本控制指南。

变更：

• 现在，“地点详情”请求会返回 region 字段。

3.30

2017 年 8 月 16 日

Maps JavaScript API 3.30 版现已作为实验版提供。 请参阅 API 版本控制指南。

变更：

• 现在，桌面设备上的全屏按钮默认处于启用状态。
• 此版本为桌面应用引入了 gestureHandling 属性，以便用户使用鼠标滚轮或触控板进行互动。如需控制用户与地图的互动方式，建议您使用 gestureHandling 属性，而不是 scrollwheel、disableDoubleClickZoom 和 draggable 属性。

3.29

2017 年 5 月 16 日

Maps JavaScript API 3.29 版现已作为实验版提供。请参阅有关 API 版本控制的指南。

变更：

• 由于底层基础架构更新，用户生成的（自定义）街景全景图片全景图片 ID 的格式发生了变化。这会略微增加可用的全景图数量。
• 在 Maps JavaScript API 中使用旧全景图 ID 请求用户生成的（自定义）全景图仍然有效。如果您尝试使用 StreetViewPanoramaOptions 对象的 position 属性查找全景图，结果将包含新的全景图 ID。无需映射旧全景图 ID 和新全景图 ID，因为这两个 ID 都将保持有效。
• 如果您需要依赖全景图片 ID 解析和/或验证逻辑，请注意全景图片 ID 的格式可能会发生变化。
• 您可以使用问题跟踪器报告任何问题。
• 更新了 google.maps.Map 类的 fitBounds 方法。
• 如需在地图处于隐藏状态时更改视口，您现在可以将地图设置为 visibility: hidden，从而确保地图 div 具有实际大小。

3.28

2017 年 4 月 18 日

MapOptions 对象的 draggable 属性已废弃。如需在桌面设备上停用地图拖动功能，请使用 gestureHandling 属性并将其设置为 none。

2017 年 2 月 15 日

Maps JavaScript API 3.28 版现已作为实验版提供。请参阅有关 API 版本控制的指南。

变更：

• Maps JavaScript API 3.28 及更高版本不再支持已登录地图。

3.27

2017 年 2 月 2 日

修复了以下问题：

• 问题 11331：无法选择 InfoWindow 中的文本

2017 年 1 月 10 日

现在，您可以将自动补全功能的预测结果限制为仅显示来自多个国家/地区的结果。为此，您可以在 AutocompleteOptions 的 componentRestrictions 字段中指定最多 5 个国家/地区。

2016 年 11 月 15 日

Maps JavaScript API 3.27 版现已作为实验版本发布。（请参阅 API 版本控制指南。）

变更：

• MapOptions 对象中新增的 gestureHandling 选项可帮助您优化用户在移动设备上与地图互动时的体验。可用的值包括：
  • greedy：当用户在屏幕上滑动（拖动）时，地图始终平移（向上或向下、向左或向右）。换言之，单指滑动和双指滑动都会使地图平移。
  • cooperative：用户必须单指滑动来滚动页面，双指滑动来平移地图。如果用户单指滑动地图，地图上会出现一个叠加项，其中包含的提示会指示用户使用双指来移动地图。请在移动设备上查看上面的示例，了解 cooperative 模式的实际应用。
  • none：无法对地图执行平移或双指张合操作。
  • auto（默认）：行为为 cooperative 或 greedy，具体取决于页面是否可滚动。

  如需了解更多详情和示例，请参阅开发者指南。

• 默认情况下，全屏控件在移动设备上处于可见状态，这是为了便于用户放大地图。当地图处于全屏模式时，用户可以使用单指或双指平移地图。注意：iOS 不支持全屏功能。因此，全屏控件在 iOS 设备上不可见。

已登录地图已废弃

2016 年 10 月 6 日

已登录功能已弃用。 Maps JavaScript API 3.27 及以下版本仍支持已登录地图功能。未来版本将不再支持已登录用户的地图，但会继续支持使用信息窗口或 SaveWidget 将地点保存到 Google 地图的功能。 详细了解已登录状态下的 Google 地图。

路线服务响应中的经停点发生变化

2016 年 8 月 29 日

路线服务响应中的 via_waypoints 字段包含原始请求中未指定的一系列路点。via_waypoints 字段将继续显示在可拖动式路线响应中，但已在备选路线响应中废弃。版本 3.27 将是最后一版可在备选路线中支持 via_waypoints 的 API。

建议的方法是请求备选路线，然后将所有路线显示为不可拖动，并将主路线显示为可拖动。用户可以拖动主路线，直到它与备选路线一致为止。via_waypoints 字段可用于生成的路线（由用户拖动）。

3.26

2016 年 8 月 18 日

Maps JavaScript API 3.26 版现已作为实验版提供。（请参阅 API 版本控制指南。）

变更：

• 新版街景渲染程序改进了渲染，包括更流畅的过渡和动画效果、改进的对象建模、更好地支持移动设备，以及更清晰的控件。如需了解详情，请参阅 Google Geo 开发者博客。
• 现在，该 API 在街景中支持设备屏幕方向事件，因此移动设备上的用户可通过移动手机环顾四周。作为开发者，您可以启用或停用此功能。如需了解详情，请参阅开发者指南。

3.25

2016 年 5 月 25 日

Maps JavaScript API 3.25 版现已作为实验版提供。（请参阅有关 API 版本控制的指南。）

Internet Explorer 9 支持即将结束

2016 年 5 月 2 日

自 2016 年 4 月 30 日起，Maps JavaScript API 不再对 Internet Explorer 9 提供正式支持。请参阅支持的浏览器列表。

3.24

2016 年 4 月 14 日

变更：

• 现在，您可以停用地图图标的可点击性。地图图标表示地图注点（也称为地图注点）。请参阅 google.maps.Map 上的 setClickableIcons 方法。

2016 年 3 月 31 日

修复了以下问题：

• 问题 9507：街景中的链接现在可以在 Safari 中正常使用。

2016 年 3 月 28 日

已修复：

• 问题 9394：当用户为底图图标打开信息窗口时，信息窗口会自动关闭，反之亦然。
• 如果使用地图上的 styles 属性为基本地图设置样式，则显示白色的 Google 徽标（以前，仅当使用 StyledMapType 应用样式时，徽标才会变为白色）。

2016 年 3 月 18 日

修复了以下问题：

• 问题 9424：new LatLng({lat: 0, lng: 0})
• 修复了使用新版街景渲染器（使用 google.maps.streetViewViewer = 'photosphere'）的鼠标平移问题。

2016 年 2 月 15 日

变更：

• 移除了使用 google.maps.controlStyle = 'azteca' 停用新控件的功能。

3.23

2016 年 1 月 18 日

变更：

• 此版本为地图新增了全屏控制功能。用户可以点击该控件以最大化地图，使其占据整个屏幕。 默认情况下，此控件处于关闭状态。您可以在 MapOptions 中启用它，并使用 FullscreenControlOptions 对其进行配置。其默认位置为 RIGHT_TOP。
• 街景的全屏控制功能默认处于启用状态。您可以通过 StreetViewPanoramaOptions 停用此功能，并使用 FullscreenControlOptions 对其进行配置。其默认位置现在为 RIGHT_TOP。

2016 年 1 月 4 日

修复了以下问题：

• 问题 9009：从触摸合成鼠标事件时，请使用左键而不是中间按钮，以便与 jQuery 兼容。
• 问题 4201：该 API 不再使用 eval()。 因此，您现在可以在不使用 unsafe-eval 内容安全政策指令的情况下使用该 API。

2015 年 12 月 21 日

变更：

• 地图选项，用于停用已登录地图的登录按钮（系统会显示已登录用户的头像，仍允许通过已登录操作（例如收藏）登录，但设置此选项后，地图上将不再显示登录按钮）。
• 文本搜索请求的界面已更改。types 参数自 2016 年 3 月 1 日起弃用，替换为新的 type 参数，此参数针对每个搜索请求仅支持一个类型。此外，不再支持将 establishment、food 和 grocery_or_supermarket 类型用作搜索参数（但搜索结果中仍然会返回这些类型）。我们会在 2017 年 3 月 1 日之前支持使用旧版 types 参数的请求，在此之后，所有文本搜索必须使用新实现方法。

2015 年 12 月 2 日

变更：

• Autocomplete 构造函数会验证是否已为其提供了输入元素。
• 在未登录模式下，基础地图地图注点信息窗口显示的内容与在登录模式下显示的内容相同。
• 适用于 Closure Compiler 的 Google Maps API externs 现在会为枚举指定类型（数字或字符串）。

2015 年 11 月 25 日

变更：

• 向 LatLng 和 LatLngBounds 对象添加了 .toJSON() 方法。这些方法旨在通过 JSON.stringify() 使用。

2015 年 11 月 19 日

变更：

• 适用于样式地图的白色 Google 徽标

修复了以下问题：

• 问题 8674：错误：防范 img { max-width: 100%; }

3.22

2016 年 1 月 7 日

修复了以下问题：

• 问题 9009：从触摸事件合成鼠标事件时，请使用左按钮，而不是中按钮，以便与 jQuery 兼容。

2015 年 11 月 10 日

变更：

• 现在，当出行方式为驾车时，路线服务和距离矩阵服务会返回交通状况下的预计时间（在响应字段 duration_in_traffic 中）。如需接收预测的旅行时间，请在请求中添加 drivingOptions 对象字面量，指定当前或未来的 departureTime。您还可以指定乐观、悲观或最佳估算（默认）的 trafficModel，以影响计算行程时间时所用的假设。如需了解详情，请参阅路线服务和距离矩阵服务的开发者指南。注意：duration_in_traffic 仅适用于 Google Maps Platform 高级计划客户。

已弃用：

• durationInTraffic 请求字段现已废弃。以前，建议采用 Google Maps Platform 专业版方案的客户通过这种方法来指定结果中是否应包含将当前路况信息考虑在内的时长。现在，您应改用 drivingOptions 字段。

2015 年 11 月 5 日

已弃用：

• AdSense 库自 2015 年 5 月起已废弃，不再在实验版 Maps JavaScript API 中提供。该库很快将从 API 的发布版本和冻结版本中移除。其替代解决方案是 Google AdSense。请参阅创建 AdSense 广告单元指南。

2015 年 9 月 22 日

变更：

• 在发出路线和距离矩阵请求时添加了对地点 ID 的支持：DirectionsRequest.origin、DirectionsRequest.destination 和 DirectionsWaypoint.location 现在接受 Place 对象，DistanceMatrixRequest.origins 和 DistanceMatrixRequest.destinations 现在接受 Place 对象的数组。

2015 年 9 月 15 日

变更：

• 地图和街景全景图片上的许多控件的默认位置和外观已发生变化。现在，无论地图是使用已登录模式还是未使用，用户体验都是一致的，并且与 Google 地图网站的体验更加一致。如果您想继续使用前面的一组控件，可以在 v3.22 中设置 google.maps.controlStyle = 'azteca'。
• 街景中新增的全屏控件允许用户以全屏模式打开街景全景图片。

已弃用：

• “概览地图”控件已不再可用。
• 地图上的平移控件已不再可用。如需平移视图，用户可以点击并拖动或滑动地图。（请注意，街景中的平移控件仍可用。）
• 缩放控件只有一种样式，因此 google.maps.ZoomControlStyle 不再可用。

2015 年 9 月 1 日

变更：

• 添加了 LatLngBounds 字面量
• 修复了过于宽泛的 CSS 类存在的问题
• 改进了调整地图大小后的图块加载

停止对 Internet Explorer 8 提供支持

2015 年 8 月 31 日

自 2015 年 8 月 31 日起，Maps JavaScript API 不再对 Internet Explorer 8 提供正式支持。请查看支持的浏览器列表。如需了解 Microsoft 的浏览器支持政策，请参阅 IEBlog 2014 年 8 月 7 日的博文。

3.21

2015 年 8 月 5 日

变更：

• 性能改进：仅加载可见的功能块
• 对文档进行了多项改进

2015 年 7 月 21 日

变更：

• 推出了带标签的标记
• 已修复：超高清屏幕上的多边形发生 iOS7 内存不足错误
• 修复了 IE10 及更高版本中的触摸事件问题
• 针对开发者提供的输入的错误验证现在会输出到控制台，而不是抛出错误。

2015 年 7 月 6 日

修复了以下问题：

• 问题 8159：bug：StrokePosition.OUTSIDE 的呈现方式不正确

2015 年 6 月 17 日

变更：

• 修复了以下问题： 问题 6321：Bug：“Uncaught TypeError: Cannot read property 'x' of undefined”仅在 Android/iOs 浏览器中出现

2015 年 6 月 2 日

变更：

• 已弃用：CloudLayer、PanoramioLayer
• 修复了：问题 8098：bug：加权热图在只有一个数据点的情况下无法正确呈现

2015 年 6 月 2 日

变更：

• 添加了对 placeId 进行地理编码到地址/latlng 的功能
• 通过 Geocoding API 返回地点 ID

2015 年 5 月 28 日

变更：

• 修复了：问题 6358：SVG 路径符号在 HDPI 设备上无法正确呈现

2015 年 5 月 19 日

修复了以下问题：

• 问题 7673：使用地图类型下拉菜单后，控件会失去位置
• 问题 7589：调整地图大小时，街景小人会进行跳转。

3.20

2015 年 4 月 24 日

已修复：

• 提高了地形的最大缩放级别，即使在最大缩放级别下也能加载高分辨率图块。

2015 年 4 月 13 日

修复了以下问题：

• 问题 7820：从 file:// 加载的页面上的光标不起作用
• 问题 7591：Bug：当半径参数不是整数时，StreetViewService.getPanoramaByLocation 会失败

2015 年 3 月 25 日

修复了以下问题：

• 问题 7733：Bug：KML 地面/图片叠加层突然分辨率非常低
• 保存微件文本，使其与星形图标更加对齐

2015 年 3 月 17 日

修复了以下问题：

• 问题 7756：bug：Safari 8 性能回归
• 移除了受众特征图层
• 信息窗口的 Chrome 改进

2015 年 2 月 17 日

当前的 Maps JavaScript API 实验版 (3.19) 将成为正式版。

版本 3.17 将被移除。现在，如果请求 3.17 或任何更低版本，系统会提供 3.18 版本。

如需查看版本控制文档，请访问： https://developers.google.com/maps/documentation/javascript/versions

转换后可用的版本：

实验性：3.20

版本：3.19

已冻结：3.18

3.19

2015 年 4 月 24 日

修复了以下问题：

• 登录模式下的光标。

2015 年 3 月 19 日

修复了以下问题：

• 问题 7756： bug：Safari 8 性能回归

2015 年 1 月 20 日

已修复：

• 问题 7475： 错误：phantomjs TypeError：无法删除属性

2015 年 1 月 13 日

已修复：

• 图块现已从屏幕阅读器中隐藏

2014 年 12 月 17 日

已修复：

• 问题 6917：bug：形状不遵循地图的“可拖动”属性
• 问题 7445：Bug：使用 v3 Maps API 的已登录功能时出现呈现故障

2014 年 12 月 2 日

已修复：

• 问题 7390：Bug：weather.com 超链接无法正常运行
• 问题 7376： bug：WebGL 已关闭（现已重新启用）
• ES6 命名与符号冲突

2014 年 11 月 25 日

修复了以下问题：

• 问题 7333：错误：IE9 中 infowindow 的箭头损坏

3.18

2014 年 12 月 4 日

修复了以下问题：

• 问题 7390：Bug：weather.com 超链接无法正常运行

2014 年 9 月 18 日

修复了以下问题：

• 问题 7136：多个标记标题在 Firefox 中无法正常使用

2014 年 9 月 9 日

修复了以下问题：

• 问题 7098：设置街景 POV 标题会引发错误

2014 年 8 月 26 日

3.18 已发布为实验版。

3.17 现已是稳定版本。

3.17

2014 年 8 月 20 日

已修复：

• 问题 6937：3.17 中的回归：无法读取（在 Places 中）未定义的属性“remove”

2014 年 8 月 12 日

修复了以下问题：

• 问题 6968：错误：键盘箭头键在 v=3.exp 下无法正常使用

2014 年 7 月 31 日

添加时间:

• 地图窗格：提供了明确的文档，说明 DOM 事件如何通过这些窗格传播。 添加了 overlayMouseTarget 窗格。

2014 年 7 月 7 日

添加时间:

• 向数据图层和各个数据图层地图项添加了 toGeoJson，以便将几何图形导出到 GeoJSON。

2014 年 6 月 24 日

添加时间:

• place_id 是地点的唯一标识符，已添加到地点库中，用于自动补全和地点详情。
• 向 DirectionsRoute 添加了 overview_path，用于提供表示整个路线路线的编码多段线。

2014 年 5 月 26 日

添加时间:

• Maps API 网址不再需要 sensor 参数。

2014 年 5 月 20 日

3.17 已发布为实验版。

3.16

2014 年 4 月 15 日

修复了以下问题：

• 标记现在的不透明度与其他几何图形类型相匹配 - https://developers.google.com/maps/documentation/javascript/3.exp/reference#MarkerOptions

2014 年 4 月 8 日

添加时间:

• 在地图上绘制时，鼠标移动会导致地图平移。

修复了以下问题：

• 在更多位置接受 LatLngLiteral。
• InfoWindow 会在 Roboto 加载完成后自行调整大小（问题 5713）

2014 年 3 月 31 日

已修复：

• 半透明 KML 图层在 IE 8 上不再透明（问题 6540）

2014 年 3 月 26 日

修复了以下问题：

• 移除了 Chrome 中的 event.returnValue 调用，以防止出现控制台警告。
• 双指张合缩放在 IE11 中不起作用（问题 5747）

2014 年 3 月 18 日

添加时间:

• 推出数据层 - https://developers.google.com/maps/documentation/javascript/datalayer

2014 年 3 月 12 日

添加时间:

• 在接受 google.maps.LatLng 的大多数位置支持 LatLngLiteral - https://developers.google.com/maps/documentation/javascript/3.exp/reference#LatLngLiteral

2014 年 2 月 24 日

添加时间:

• 在距离矩阵和路线服务中支持渡轮。

2014 年 2 月 17 日

3.16 已发布为实验版。

3.15

2014 年 3 月 3 日

已修复：

• 修复了 Chrome 中的 bug (https://code.google.com/p/chromium/issues/detail?id=336676)，因此在 Chrome Windows 和 Linux 中重新启用硬件加速

2014 年 2 月 10 日

修复了以下问题：

• 在 Chrome/Linux 上停用全功能块硬件加速，以解决更大的 Chrome 硬件加速问题。

2014 年 2 月 3 日

修复了以下问题：

• 滚轮在 IE 11 中不起作用（问题 5944）

2014 年 1 月 29 日

修复了以下问题：

• 在 Chrome/Windows 上停用所有功能块硬件加速，以解决较大的 Chrome 硬件加速问题。（问题 6219）

2014 年 1 月 22 日

修复了以下问题：

• 在加载绘制管理器时，暂时在 Chrome/Windows 上停用硬件加速，以解决 Chrome 问题： https://code.google.com/p/chromium/issues/detail?id=336676（问题 6224）

2014 年 1 月 16 日

已修复：

• 视觉刷新 CSS 的具体性降低，以替换更少的用户设置的样式。

2013 年 11 月 27 日

修复了以下问题：

• 在实例化地图后创建标记会抛出“contains”未定义错误（问题 5798）

2013 年 11 月 19 日

修复了以下问题：

• 在 Firefox 中无法正确显示路线面板操作图标

3.14

2013 年 9 月 10 日

修复了以下问题：

• 官方 Google 信息窗口中的链接不会在新标签页/窗口中打开（问题 5794）

2013 年 8 月 15 日

• 在 API 的发布版本中，视觉刷新将成为默认地图渲染模式。
• DynamicMapsEngineLayer：矢量图层、影像图层和 KML 图层的地图项报告

3.13

2013 年 6 月 25 日

添加时间:

• DynamicMapsEngineLayer

2013 年 6 月 11 日

添加时间:

• 向 StreetViewPanoramaOptions 添加了“disableDefaultUI”选项

已修复：

• bug：自定义街景全景图片向下 90 度（问题 4875）

3.12

2013 年 6 月 4 日

已修复：

• 当 visualRefresh=true 时，Infowindow domready 不会触发（问题 5415）
• bug：iOS 上的 visualRefresh 信息窗口 (问题 5396)

2013 年 5 月 15 日

添加时间:

• Google 地图视觉刷新： https://developers.google.com/maps/documentation/javascript/basics#VisualRefresh

2013 年 4 月 29 日

修复了以下问题：

• 在 Android 和 Dolphin 浏览器中，已移除的标记仍会在地图上显示

3.11

2013 年 2 月 19 日

已修复：

• 在绘制过程中更改 DrawingMode 会导致错误
• 点击路线面板中的路段可更改缩放级别

2013 年 2 月 12 日

修复了以下问题：

• 可使用触控输入在可拖动多边形中拖动不可拖动的多边形（问题 4868）
• 切换 travelMode 时，“路线替代方案”面板中的公交图标不正确（问题 4581）
• 在某些情况下，panTo(latLng) 并不总是让地图精确居中于 latLng

2013 年 1 月 29 日

添加时间:

• 添加了 StreetViewCoverageLayer，以便以编程方式添加覆盖层
• StreetViewPanoramas 的实验组 StreetViewPov

修复了以下问题：

• 使用 V3.8 版 Google 地图 JavaScript 时内存用量增加会导致崩溃（在 IE 9、Chrome 等浏览器中观察到）( 问题 4162 )
• 在 Firefox 中，InfoWindow 中的下拉（选择）菜单不会跟随地图平移

2013 年 1 月 22 日

添加时间:

• 多段线、多边形、圆形和矩形的可拖动选项
• PlaceResult 中的 price_level 字段

2013 年 1 月 15 日

已修复：

• 重复的多段线图标针对某些多段线绘制不正确 ( 4333 问题)

2013 年 1 月 7 日

修复了以下问题：

• 滚动地图也会滚动页面（问题 1605、问题 3652）

2012 年 12 月 17 日

添加时间:

• 新增语言：乌尔都语和冰岛语

修复了以下问题：

• 导航后 IE9 中的地图模糊/朦胧 (问题 3875)

2012 年 12 月 17 日

添加时间:

• 新增语言：乌尔都语和冰岛语

修复了以下问题：

• 导航后 IE9 中的地图模糊/朦胧 (问题 3875)

2012 年 12 月 10 日

添加时间:

• 能够加载设置了 crossorigin 属性的图片

已修复：

• 在放大显示遥控器图片时显示标记的问题（问题 4616）
• 在 IE 7/8 的多段线上重新显示符号时发生 JS 错误

2012 年 12 月 3 日

修复了以下问题：

• Markermanager 库不适用于 Maps API JS v3（问题 4543）

2012 年 11 月 27 日

添加时间:

• 在高 DPI 设备上使用高 DPI 画布优化标记

已修复：

• MapTypeControl 未清除样式（问题 4588）

3.10

2013 年 2 月 4 日

修复了以下问题：

• 使用 Google 地图 JavaScript V3.8 时内存用量增加，导致崩溃（在 IE 9、Chrome 等浏览器中观察到）（问题 4162）

2012 年 9 月 25 日

添加时间:

• 室内街景
• 对 IconSequence 使用 FixedRotation 选项
• 查询路线时指示“当前路况时间”

2012 年 9 月 11 日

新变化：

• 为多边形、矩形和圆形添加了 StrokePosition
• computeOffsetOrigin 到几何图形库
• 该 API 新增了四种语言：南非荷兰语、阿姆哈拉语、斯瓦希里语、祖鲁语

2012 年 8 月 28 日

添加时间:

• 将类型添加到 Places API textSearch

修复了以下问题：

• Symbol 对象无法传递给 GWT 下的 MarkerOptions
• 回归：滚动页面时在 iOS 5 上通过双指张合进行缩放（问题 4046）

2012 年 8 月 14 日

显著变更：

• 将接口修改为 KmlLayer，以接受网址作为 MVC 属性，而不是构造函数参数。

3.9

2012 年 9 月 10 日

修复了以下问题：

• 在 GWT 下，无法将符号对象传递给 MarkerOptions
• 回归：在 iOS 5 上滚动网页时无法通过双指张合缩放（问题 4046）

2012 年 8 月 9 日

修复了以下问题：

• Android 3.x 上的语法错误

2012 年 7 月 31 日

显著变更：

• 在自定义投影中隐藏街景叠加层

修复了以下问题：

• 当缩放比例 > 35 时，标记符号不会在 Safari 上触发事件
• 系统不会针对自定义地图（地图类型 + 投影）上的标记引发点击事件

2012 年 7 月 25 日

修复了以下问题：

• 自动补全的 componentRestrictions（问题 4302）

2012 年 7 月 17 日

修复了以下问题：

• 在 IE 中，InfoWindow 中的文本框不可点击
• bounds_changed 应在 zoom_changed 之前触发（问题 1399）
• 调用街景后，地图选项 backgroundColor 未保留
• 从“自定义地图”切换到“卫星”时会不必要地加载地图图块
• 绘制模式下忽略地图可拖动/滚轮属性（问题 4012）
• 当显示多个世界副本时，LatLngBounds 应返回完整的经度范围
• 双击时不绘制空形状（问题 3964）
• 点击时产生多余的标记事件（问题 3911）

显著变更：

• 将搜索和查询端点重命名为 nearbySearch 和 textSearch

2012 年 7 月 10 日

显著变更：

• 使 google.maps.event.removeListener() 接受 null 作为实参

2012 年 6 月 27 日

添加时间:

• 公交路线模式： http://mapsplatform.googleblog.com/2012/06/public-transit-routing-and-layer-now.html

• 向 Places API 添加分页、评价和文本搜索： http://mapsplatform.googleblog.com/2012/07/add-flexible-search-and-google-reviews.html

显著变更：

• 将“透明”识别为颜色。

2012 年 6 月 23 日

添加时间:

• 符号
• HeatmapLayer

http://mapsplatform.googleblog.com/2012/06/powerful-data-visualization-with.html

• 新增了样式设置选项“粗细”和“颜色”：

http://mapsplatform.googleblog.com/2012/06/google-maps-api-now-with-even-more.html

2012 年 5 月 15 日

添加时间:

• 自动补全的国家/地区限制 (AutocompleteOptions.componentRestrictions)（问题 3899）
• “地区”和“城市”类型过滤条件

3.8

2012 年 5 月 1 日

已修复：

• 已删除的标记有时会重新出现（ 问题 4087）
• 标记阴影有时不会渲染（问题 3993）

2012 年 4 月 23 日

修复了以下问题：

• 关闭街景后，街景小人使用自定义地图类型继续停留在地图上（问题 4076）
• 已移除的动画标记无法重新添加到地图中（问题 4052）

2012 年 4 月 18 日

修复了以下问题：

• 在 Firefox 中，天气信息窗口始终显示下雨图标（问题 4063）

添加时间:

• FusionTablesLayer 的 orderBy、limit 和 offset（问题 3557）

2012 年 4 月 10 日

修复了以下问题：

• 即使整个视口都不支持航拍图像，系统也会显示航拍图像（问题 3913）

2012 年 4 月 3 日

添加时间:

• WeatherLayer 和 CloudLayer（问题 3555）
• DemographicsLayer

已修复：

• 在 IE 9 Quirks 中，多边形可见的功能块边界
• 在画布街景中平移时标记跳来跳去

2012 年 3 月 28 日

修复了以下问题：

• 使用小写标记名称以符合 XHTML 规范 ( 问题 3868)
• 更改了 Apple 触控板的缩放行为，使其不那么敏感（问题 2416）

2012 年 3 月 20 日

已修复：

• 使用不存在的阴影图片创建标记会导致错误（问题 4014）

添加时间:

• 街景中的 Click-to-go/Click-to-zoom（问题 2447）

显著变更：

• 在街景中默认停用双击缩放功能

2012 年 3 月 6 日

修复了以下问题：

• 快速放大时 OverviewMapControl 中出现错误 （ 问题 3882）
• 从页面中移除地图 div 时，IE 中会出错（问题 3971）
• 缩放的标记在 IE < 9 上呈现不正确（问题 3912、问题 3908）

添加时间:

• 向 GroundOverlay 添加不透明度（问题 2767）
• utc_offset 和 open_hours 传递给 PlaceResult（问题 2431）
• 向 StreetViewPanoramaOptions 添加了 clickToGo 选项（问题 2447）

2012 年 2 月 21 日

修复了以下问题：

• IE 9 上地图模糊不清（问题 3875）
• 由 LatLng 空间中共线边组成的多段线被错误地简化了（问题 3739）

添加时间:

• google.maps.sites.poly.containsLocation() 和 isLocationOnEdge()（问题 1978）

2012 年 2 月 15 日

修复了以下问题：

• 回归：如果“size”参数无效，则缩放标记的呈现方式不正确（问题 3908）
• 在用户拖动控制点时调用 setEditable(false) 时，地图会卡在编辑模式（问题 3842）

显著变更：

• 在街景全景图片之间进行交叉淡化。

3.7

2012 年 2 月 7 日

修复了以下问题：

• 在下拉动画开始之前，标记会在最终位置闪烁 ( 问题 3608)
• 同时打开信息窗口和设置缩放级别会导致地图中心不正确（问题 3738）
• 拖动标记时忽略右键点击（问题 3237）
• 标记标题有时不会在 Firefox 上显示（ 问题 3773）

显著变更：

• 缩放后的标记现在会在画布中渲染（如果有）

添加了：

• 用于 ImageMapType 的 setOpacity()（问题 3125）
• GroundOverlay 的 setOpacity()（问题 2767）
• ImageMapType 的“tilesLoaded”事件 ( 问题 1744)
• stop() 到 MouseEvent，这会停止事件传播（问题 2172）

2012 年 1 月 31 日

修复了以下问题：

• 修复：在世界各地平移后韩语功能块显示错误（问题 2722）
• 已修复：无法准确放置街景小人以显示街景（问题 3861）
• 为多边形添加了“visible”属性（问题 2861）
• 即使视口相距甚远，panTo 和 panBy 也会执行动画效果 (Regression)

2012 年 1 月 24 日

修复了以下问题：

• 鼠标事件通过信息窗口以气泡形式显示（问题 3573）
• 在 IE9 上启用了 CSS 转换
• 向 StreetViewPanorama 添加了 imageDateControl
• 在 IE 9、Opera 和 Safari/Windows 上启用了画布街景

2012 年 1 月 16 日

修复了以下问题：

• 在绘制模式下，Pegman 不应可拖动
• 根据多边形和其他图层的 zIndex，正确触发事件
• 添加了 KmlLayer“status”属性（问题 3015）

2012 年 1 月 10 日

修复了以下问题：

• 如果 disableDefaultUI 为 true 且 streetViewControl 为 true，则显示街景小人

2011 年 12 月 7 日

修复了以下问题：

• 高速公路 (road.highway.controlled_access) 的样式可以与普通公路分开设置
• 当用户在自动补全时按下“Enter”键时触发 place_changed（问题 3407）

1011 年 11 月 28 日

修复了以下问题：

• 调整窗口大小时重新定位自动补全功能。可在 Autocomplete 对象上触发“resize”事件。

2011 年 11 月 22 日

修复了以下问题：

• 现在计算信息窗口内容大小时将级联样式考虑在内
• 鸟瞰地图旋转控件与地图创建时的标题不符

2011 年 11 月 7 日

显著变更：

• 默认控件的全新视觉样式
• 可修改的形状（多边形、多段线、圆形、矩形）
• 新增了 DrawingManager，以添加新叠加层
• 新增了 PlaceResult 字段：website 和 international_phone_number
• 新建了 ElevationResult 字段：resolution

修复了以下问题：

• 现在，在 IE 7 及更高版本中，导航结果中的起点和终点图标会以透明背景呈现

3.6

2011 年 10 月 31 日

修复了以下问题：

• 在 IE7 上将 Maps API 与原型库一起使用时出错

2011 年 10 月 25 日

修复了以下问题：

• 当 KmlLayer 地图在图层加载完成之前发生更改时出现的错误
• 在 IE 中添加和移除多边形时会发生内存泄漏

2011 年 10 月 18 日

显著变更：

• 向 PlaceSearchRequest 添加了关键字字段
• 从街景中移除了道路线

2011 年 10 月 10 日

修复了以下问题：

• 街景预览中的地址过长

2011 年 9 月 27 日

已修复：

• 如果缩放级别发生变化，概览地图控件会同时更新中心和缩放级别

2011 年 9 月 27 日

修复了以下问题：

• 在 Chrome 中双重提取初始图块
• 平移时发生内存泄漏
• 平移到不在覆盖范围内的区域时，不丢弃街景小人
• 回归：经度超过 -180 的地图项会消失
• 回归：在平移和缩放地图时打开信息窗口时，地图中心不正确

显著变更：

• 在街景小人进行拖动时显示街景预览

2011年9月20日

修复了以下问题：

• 使用 Canvas 渲染标记时，Chrome/Windows 中会发生内存泄漏
• 航向为 90 度或 270 度的航拍视图的标记渲染

显著变更：

• 无法通过地图类型注册表访问默认 Google 地图类型（会阻止访问地图图块）
• 退出和进入航拍图片时的旋转动画

2011 年 9 月 12 日

已解决的问题：

• 在 Firefox 4 及更高版本中，提示出现后标记会卡在举起位置（问题 3334）

显著变更：

• GeocoderResult.formatted_address（未记录）

2011 年 9 月 6 日

已修复：

• 在 Firefox 中，选择元素（下拉）信息窗口不会跟随地图平移操作
• 韩国境内某些移动设备上的功能块

2011 年 8 月 29 日

显著变更：

• 允许自定义控件的 z-index 高于 API 控件的 z-index
• 通过链接，用户可以转到 maps.google.com 的正确语言版本
• 如果没有信息窗口 HTML、名称或说明，请勿在 KML 地图项上打开信息窗口。
• 修复了回归问题：高 DPI 图块损坏

2011 年 8 月 24 日

已解决的问题：

• 停用了 Chrome/Mac 的硬件加速：修复了标记渲染问题和叠加层点击问题 (问题 3544、问题 3551)
• 修复了在 Android 滚动页面时出现的双指张合缩放问题（问题 3373）

显著变更：

• 商家图标现在默认处于开启状态。

2011 年 8 月 17 日

显著变更：

• 地图注点的可点击图标。
• 您可以在 MapOptions 中设置样式，并将其应用于所有默认地图类型。
• 除非明确停用，否则街景小人会显示在自定义地图类型上。

3.5

2011 年 8 月 10 日

已修复：

• 在街景中将标记拖动到水平面时，标记会卡在向上拖动的位置
• 调整地图或窗口的大小时，街景不会调整大小
• 包含共享 InfoWindow 的街景会导致浏览器崩溃

2011 年 8 月 2 日

已解决的问题：

• IE 上的信息窗口中的超链接不起作用（问题 3503）
• 比例尺控件无法打印（问题 2966）
• 回归：将 OverviewMapControl 与样式地图搭配使用时出错（问题 3489）

显著变更：

• 现在，大多数控件的上下文菜单在右键点击时处于停用状态。
• 当用户将鼠标悬停在 InfoWindow 上时，InfoWindow 中的街景全景图/地图不会平移
• 现在可以在 iPad 上滚动信息窗口了

2011 年 7 月 18 日

已解决的问题：

• 在 iOS 4.1 及更高版本中滚动页面时，事件 LatLng 不正确（问题 3373）

2011 年 7 月 11 日

已解决的问题：

• 修复了在触摸设备上的信息窗口内 <select> 不可点击（问题 3232）
• 修复了以下问题：如果 MapOptions.draggable 为 false，则在右键点击后地图上不会触发点击（问题 3071）

显著变更：

• 现在，Z-index 相同的标记会跨图块边界以一致的方式排序
• 现在，您可以在 iOS 设备上滚动信息窗口
• 现在，当地图的投影发生变化时，标记和多边形会重新绘制

2011 年 7 月 5 日

已解决的问题：

• 修复了当地图不可拖动时标记光标不显示（问题 3120）

显著变更：

• 添加了为地点自动补全控件和下拉菜单设置样式的功能
• 地点自动补全 widget 在用户选择一条建议后保留服务器返回的说明

2011 年 6 月 30 日

已解决的问题：

• 已修复：系统会重复提取初始地图图块
• 修复了以下问题：在 3.4 之后创建地图时，maptypeid_changed 事件会多次触发（问题 3051）

显著变更：

• 地点自动补全功能已更改为附加到正文，而不是附加到输入父元素
• BOTTOM_RIGHT 现在会正确定位

2011 年 6 月 8 日

已解决的问题：

• 修复了当缩放级别的变化大于 2 时，缩放不再以动画形式呈现（问题 3033）

显著变更：

• 已修复：OverlayView.set('map', foo) 现在与 OverlayView.setMap 相同
• 移除了 GeocoderRequest 的“language”选项

2011 年 5 月 17 日

已解决的问题：

• 修复了 IE7 中的街景呈现问题（问题 3272）

显著变更：

• 在加载和更改地图类型时，为地图图块启用了淡出转换效果。

2011 年 5 月 7 日

没有明显变化。

3.4

2011 年 5 月 7 日

没有明显变化。

2011 年 5 月 6 日

已解决的问题：

• 已修复：街景全景图片无法在 IE7 中显示（问题 3272）
• 修复了以下问题：具有 ImageMapType 的半透明 PNG 在 IE7 和 IE8 中会失去透明度（问题 3275）

显著变更：

• 距离矩阵服务

2011 年 4 月 14 日

已解决的问题：

• 修复：支持为多边形 strokeColor 和 FillColor 使用命名的 CSS 颜色
• 修复：在 strokeOpacity 设置为 0.0 时多边形不可见（问题 3241）
• 修复：在 IE8 中，当广告单元可见时平移时会出现错误（问题 3159）
• 允许在地图类型控件中显示地形地图和混合地图，而不显示地图和卫星地图（问题 3089）
• 为高 DPI 屏幕加载高 DPI 图块 ( 问题 2614)

显著变更：

• 如果航拍图像已启用且可用，航拍倾斜度默认为 45 度
• 改进了 iPad 上的双指张合行为
• 将 DirectionsTravelMode 和 DirectionsUnitSystem 重命名为 TravelMode 和 UnitSystem（旧名称仍保持向后兼容性）

2011 年 4 月 14 日

已解决的问题：

• 已修复：标记图标和阴影在 IE6 中不再透明
• 已修复：标记在缩放时不再闪烁
• 修复了：在靠近南北极点的图块边界上渲染多边形的问题

显著变更：

• 多段线和多边形现在会尽可能在画布中渲染。
• 现在，多段线和多边形边界上事件的 LatLng 会贴靠到线上的最近点。

2011 年 4 月 5 日

已解决的问题：

• panTo 在触摸设备上不进行动画处理（问题 3066）
• Marker.MAX_ZINDEX 未定义 ( 问题 3184)

2011 年 3 月 28 日

已解决的问题：

• 在卫星模式下无法在街景中更改航向 ( 问题 3174)
• 停用 VML 后，映射损坏（问题 3119）

显著变更：

• 街景道路叠加层现在会以倾斜模式显示

2011 年 3 月 22 日

已解决的问题：

• 街景小人在自定义地图类型中显示（问题 3154）

显著变更：

• 修复了：巨型标记会在图块边界处被剪裁
• 修复了倾斜模式下的街景叠加层
• 已修复：概览地图控件会在打印模式下显示

2011 年 3 月 17 日

已解决的问题：

• 45 度图像（问题 2412）
• 概览地图控件（问题 1470）
• 支持动画 GIF - 添加了“优化”选项（问题 3095）
• Marker.getVisible() 返回未定义（问题 3114）

显著变更：

• 修复：圆形和矩形忽略 zIndex
• 修复了以下问题：当标记正在动画化时，鼠标事件会触发两次事件
• 修复了以下问题：如果在设置地图类型 ID 后将地图类型添加到注册表，自定义样式的地图不会使用样式
• 已修复：非样式化地图类型采用样式化地图类型的样式
• 标记现在会触发 MouseEvent，而不是 DOM 事件

2011 年 3 月 11 日

已解决的问题：

• 双击标记不会再缩放地图（问题 3090）
• 带有自定义标记阴影的锚点现在可以正常使用（问题 3112）

显著变更：

• Panoramio 图层
• 修复了路线标记 Z-index 问题
• 修复了默认阴影位置

2011 年 3 月 2 日

显著变更：

• 标记现在会在 Canvas/VML 中呈现（如果可用）
• 在支持触控的设备上，多段线、多边形和 KML 的点击目标更大

2011 年 2 月 22 日

已解决的问题：

• 通过“anchorPoint”MVC 属性公开的信息窗口锚点（问题 2860）
• 修复了缩放级别 0 和 1 下的混合模式问题 (问题 3062)
• 修复了在向地图快速添加/移除圆形/矩形问题（问题 3052）
• Draggable: 修复了触摸设备上的 false（问题 3044）

2011 年 2 月 18 日

已解决的问题：

• 街景中的标记只会缩小而不会放大（问题 2969）
• 现在，当 routeIndex 不为 0 时，可拖动路线会正常运行 (问题 2995)
• 修复了 Flash 和地图拖动之间的冲突问题 ( 问题 2956)
• 在 maptypeid_changed 监听器中更改 mapTypeId 后，地图类型控件现在是一致的

显著变更：

• 现在，从地图类型控件中点击“卫星图像”模式后，标签会默认开启

2011 年 2 月 8 日

显著变更：

• 全新的层次地图类型控件 - 支持触控！
• 新徽标（问题 2574）
• 将 MarkerShape.coord 重命名为 MarkerShape.coords，以匹配 HTML <area> coords 属性

3.3

2011 年 3 月 17 日

已解决的问题：

• 多边形未渲染

2011 年 2 月 8 日

已解决的问题：

• Chrome 中不取消功能块请求 ( 问题 3011)
• 右键点击事件未在 FF/Mac 中触发（问题 2920）
• Safari/Mac 中的文本渲染问题 ( 问题 3024)
• 在 IE 中无法正确打印路线地图

2011 年 1 月 21 日

显著变更：

• 球面几何图形库现在接受 MVCArrays
• 修复了在 IE6 中拖动时标记下方的交叉显示问题
• 地图容器 div 不再设置 Z-index

2011 年 1 月 17 日

已解决的问题：

• 修复了以下问题：zoom_changed 的计时不正确导致 fromLatLngToContainerPixel 的结果不正确（问题 2539）

2011 年 1 月 6 日

已解决的问题：

• 添加了几何图形库 - 提供球面几何图形和多段线编码实用程序 (问题 2540、问题 2595、问题 2246)
• 能够在地图上设置最小/最大缩放级别 ( 问题 1624)

显著变更：

• 缩放和平移控件已分开（不再提供导航控件）。这些可以单独配置。
• 触摸设备上新增了触控友好的缩放控件
• 现在，您可以通过调用 clear() 清除 MVCArray 的内容
• 修复了在 IE8 中添加和移除标记时发生的内存泄漏问题
• 通过改进的简化算法更快地渲染多边形

2010 年 12 月 23 日

已解决的问题：

• 修复了可拖动路线中的航点点击处理脚本（问题 2871）

2010 年 12 月 21 日

已解决的问题：

• 为拖动地图时增加了惯性（问题 2592）
• 修复了街景中的 CSS 错误（问题 2666）
• 修复了在 IE 中显示地图宽度为 0 的 InfoWindow 时出现的 JS 错误（问题 2536）

显著变更：

• 现在，无论请求的是 ZOOM_PAN 还是 SMALL 导航控件，触摸设备上都会显示适合触摸的缩放控件。如果设备在浏览器中支持多点触控，则系统不会显示缩放控件，因为缩放是通过双指张合完成的。

2010 年 12 月 9 日

已解决的问题：

• InfoWindows 现在可以在 IE 中正常打印（问题 1343）
• 修复了 ImageMapType 在 IE8 中的不透明度

显著变更：

• 进行拖动时，标记下方会显示一个带自定义图标的叉号，且已启用 lowerOnDrag

2010 年 12 月 5 日

已解决的问题：

• 提供一个接口，用于查看某个指定位置的卫星图像的最大缩放级别。（问题 2049）
• 添加了一个选项 (raiseOnDrag)，用于在拖动标记时启用/停用动画。( 问题 2910)

显著变更：

• 现在，标记在拖动时会抬起，在放下时会弹跳。
• 您可以使用 setAnimation 函数以编程方式控制标记动画。

2010 年 11 月 28 日

已解决的问题：

• maptypeid_changed 不再触发两次（问题 2449）
• 现在可以访问 MarkerImage 对象的“size”属性了（问题 2465）
• 标记形状引用的是图标而不是精灵（问题 2629）
• 改进了在拖动标记时平移地图的功能（问题 2868）

显著变化：

• 现在，无需启用背景图片打印功能即可打印地图
• 修复了以下 bug：当“可拖动”设置为 false 时，可拖动方向标记可拖动

2010 年 11 月 16 日

更改的问题：

• 问题 2076：提供一种向 DirectionsRenderer 提供 InfoWindow 的方法（问题 2076）
• 问题 2524： 实现了 streetViewControlOptions
• 问题 2557：向街景添加了停用缩放功能

显著变更：

• 修复了以下 bug：如果按住 Shift 键点击标记，Firefox 中会打开一个新窗口。
• 使用 DirectionsRenderer 指定 markerOptions 时，字母标记图标会丢失

3.2

2010 年 11 月 11 日

显著变更：

• 修复了在 IE7/IE8 上使用 RTL 时多边形被剪裁/截断的 bug
• 修复了由于 3D 转换导致 Safari 5 上隐藏复选框的 bug
• 横跨赤道的测地线多段线缺少细节
• 添加了 LEFT_CENTER、LEFT_BOTTOM、RIGHT_CENTER、RIGHT_BOTTOM 控件位置。
• 将控件位置 LEFT 重命名为 LEFT_TOP、RIGHT 重命名为 RIGHT_TOP、TOP 重命名为 TOP_CENTER，并将 BOTTOM 重命名为 BOTTOM_CENTER

2010 年 10 月 11 日

更改的问题：

• 问题 2478： 街景 - 在某些浏览器中，指南针未对齐/缺失
• 问题 2528：ImageMapTypeOptions 不透明度在 IE8 中损坏
• 问题 2661：信息窗格 - 右键点击输入字段不会显示上下文菜单
• 问题 2741：在地图平移后，在 iOS 4 上标记位置不起作用

显著变更：

• 街景默认处于启用状态
• 修复了未将“this”传递给 .getTileUrl 的 bug
• InfoWindow domready 事件现在会在窗口可见后触发

2010 年 9 月 28 日

更改的问题：

• 问题 2712：内存泄漏（添加/移除标记、显示/隐藏标记、缩放/平移地图）

显著变更：

• V2 和 V3 地图在同一页面上显示时，两者的效果更好
• 修复了快速向下拖动 HTML5 街景时出现的错误

2010 年 9 月 16 日

更改的问题：

• 问题 2701：初始街景导航器控件方向未跟随 POV

2010 年 9 月 14 日

更改的问题：

• 问题 157：支持可拖动的行车路线
• 问题 1852：系统会在没有参数的情况下触发 google.maps.Marker 上的“右键点击”事件
• 问题 2673：位置更改后，街景小人消失了

显著变更：

• 改进了标记性能

2010 年 8 月 31 日

更改的问题：

• 问题 2658：高信息窗口

显著变更：

• 改进了测地线，以支持更高级别的缩放

2010 年 8 月 24 日

更改的问题：

• 问题 2648：在 V3.2.1 中，触发地图大小调整事件会导致 Firefox 中出现错误

显著变更：

• 现在，重复放大或缩小（例如使用滚轮时），我们从中间缩放级别加载的功能块更少。

2010 年 8 月 16 日

更改的问题：

• 问题 2416：Apple Magic Mouse 平移和缩放过于灵敏
• 问题 2606：在地图上设置 draggable: false 会停用链接
• 问题 2640：在浏览器刷新 / 卸载 (IE) 时不清除内存

显著变更：

• Street View 标记会根据距离进行缩放
• 平移时更新缩放滑块

2010 年 8 月 9 日

显著变更：

• 已移除已废弃的 KMLMouseEvent.position 和 FusionTablesMouseEvent.position 属性。改用 .latLng
• 移除了已弃用的属性 StreetViewService.getNearestPanorama。改用 .getPanoramaByLocation

3.1

2010 年 9 月 28 日

显著变更：

• 修复了起点和终点相同的路线会抛出 JS 错误的问题

2010 年 8 月 9 日

显著变更：

• 更改 OverlayView 的地图已修正
• 修复了调用 GroundOverlay.setMap(null) 的问题
• IE 在缩放/平移时不再泄露内存

2010 年 8 月 5 日

更改的问题：

• 问题 2588：对附加监听器的全景对象调用 setVisible(false) 会导致 IE 中出现 JS 错误

显著变更：

• 修复了在 IE6 中缩放更改时标记消失的问题

2010 年 7 月 29 日

更改的问题：

• 问题 2337：丢失了多段线
• 问题 2497：系统不执行 Circle 的点击可选项

显著变更：

• 自定义全景图片“originHeading”已被弃用，取而代之的是“centerHeading”
• 韩国混合图块现在显示道路
• 点击现在会穿过地图上不可点击的多边形

2010 年 7 月 22 日

更改的问题：

• 问题 1856：支持在 Opera 中渲染多边形
• 问题 2159：使用滚轮缩放后触发 Dragend 事件
• 问题 2385：在较深的缩放级别下，Internet Explorer 中的 GroundOverlay 变黑
• 问题 2337：丢失了多段线
• 问题 2427：在启用自动平移的信息窗口的情况下进行拖动会导致标记“悬挂”
• 问题 2493：在 IE7 中无法正确清除标记
• 问题 2500：为现有标记使用 !Marker.setIcon(<scaled MarkerImage>) 时，系统会剪裁 MarkerImage
• 问题 2549：Google 下拉菜单的 CSS 会生成警告

显著变更：

• 拖动多边形时不再触发点击事件
• 点击在 InfoWindow 外部展开的表单选择元素不再触发地图点击
• 点击 KML 叠加层不再触发地图点击事件
• 街景现在会自动平移，以适应屏幕上的信息窗口大小
• 将 KML 和 FusionTables MouseEvent LatLng 从“position”更改为“latLng”
• Android 缩放控件不再将点击传递给地图

2010 年 6 月 17 日

更改的问题：

• 问题 2346： 添加了用于停用流畅动画的选项

显著变更：

• 修复了标记闪烁 bug
• 改进了 InfoWindow domready 事件触发
• DirectionsRoute.bounds 现已公开

2010 年 6 月 11 日

更改的问题：

• 问题 2389： 街景在 IE7 中不起作用
• 问题 2460：街景小人定位中的 bug

显著变化：

• 修复了标记内存泄漏问题
• 首次地理编码延迟时间已缩短
• 提供了对 StreetViewService 的访问权限

3.0

2010 年 5 月 18 日

更改的问题：

• 问题 2037：GPolylineOptions 测地线

显著变化：

• 修复了自定义地图类型的 Google 版权信息显示错误的 bug
• 向多边形和多段线添加了测地属性
• 向多边形和多段线添加了可点击选项
• 向 GroundOverlay 添加了可点击选项

2010 年 5 月 13 日

已更改的问题：

• 问题 1724：通过元素（而非字符串）设置内容时，infoWindow 大小/边距不正确

显著变更：

• 修复了跨越日期线时地面叠加层过早剪裁的 bug
• 现在，标记 setIcon 可与网址中的 \ 配合使用
• IE 中的多边形和多段线 mouseout 事件触发器
• 更改标记图标时不再闪烁

2010年5月7日

已更改的问题：

• 问题 1458：功能请求：Google API v3 中的 KML 支持
• 问题 1658：添加了交通信息叠加层
• 问题 2209： 堆栈溢出
• 问题 2254：对圆形对象多次调用“setMap(gMap)”和“setMap(null)”会更改其描边和填充不透明度

显著变更：

• 添加了KML 图层和 GeoRSS 图层
• 添加了地面叠加层
• 添加了新图层：路况和骑行
• 针对 DirectionsRendererOptions 添加了“suppressBicyclingLayer”属性
• 修复了一些 bug，以确保在 MapType 更改时正确引用缩放图层
• 将 DirectionsResult 属性“start/end_point”重命名为“start/end_location”
• 将 DirectionsLeg 属性“start/end_geocode”重命名为了“start/end_address”
• 将 DirectionsRoute 的“optimize_waypoint_order”属性重命名为了“carousel_order”
• 移除了对旧路线属性名称（setTripIndex、getTripIndex、hideTripList、provideTripAlternatives）的支持并继续记录警告。此外，还会移除将路线转换为分段路线和行程路线转换为分段路线的功能。
• 将 GeocoderGeometry.latLng 更新为 GeocoderGeometry.location

2010 年 4 月 30 日

已更改的问题：

• 问题 2230：地图在初始化时没有使用预期的自定义投影

显著变更：

• 现在，点击地图会将焦点移至键盘
• 现在支持 iPad 双指张合即可缩放功能

2010 年 4 月 26 日

已更改的问题：

• 问题 1826：在多边形和多段线上添加了 mouseover 和 mouseout 事件
• 问题 2177：map.setZoom(z) 在“maptypeid_changed”事件期间无法正常工作
• 问题 2247：DirectionsRenderer 上的 hideRouteList 选项无法按预期运行

显著变更：

• 修复了在平移期间自定义图标从地图底部消失的错误

2010 年 4 月 13 日

已更改的问题：

• 问题 2275： MarkerImage 无法重复使用
• 问题 2181：添加 google.maps.Marker 后，使用鼠标滚轮放大或缩小地图时，标记会隐藏

2010 年 4 月 11 日

没有明显变化或已更改的问题。

2010 年 4 月 5 日

已更改的问题：

• 问题 1976：自定义图标和可拖动标记问题
• 问题 2107：拖动到地图之外时，可拖动标记会消失
• 问题 2181：基本地图的投影属性不存在

显著变更：

• 将 DirectionsRoute 中的路线概览多段线公开为 overview_path。
• 将地图的当前投影公开为只读属性。

2010 年 3 月 23 日

显著变更：

• Elevation 现已在 API 中公开
• 改进了在互联网连接速度较慢的情况下的功能块加载。

2010 年 3 月 15 日

显著变更：

• 现在，当样式发生更改时，多边形可以正确地重绘。
• 使用旧样式的“Directions”时，系统会通过 console.log 显示已弃用的警告消息。

2010 年 3 月 10 日

已更改的问题：

• 问题 1801：多段线/多边形 zIndex
• 问题 2144：DirectionsRequest 应提供 closeHighways 选项
• 问题 2207： 错误：IE 中会填充多段线
• 问题 2113：1 月版本发布后，在高缩放级别下多段线在 FF 中损坏

显著变更：

• 添加了骑车路线！
• 添加了新的 DirectionsRequest 选项：
• avoidHighways
• avoidTolls
• optimizeWaypoints
• 提高了多边形/多段线的渲染速度
• 重命名了以下 Directions 对象。旧名称仍受支持。
• DirectionsRoute 到 DirectionsLeg
• DirectionsTrip 到 DirectionsRoute

2010 年 3 月 3 日

已更改的问题：

• 问题 2136：对不应引用的 google.maps.MarkerImage 中的属性进行了混淆处理

显著变更：

• 修复了地图跳跃错误。
• 连续两次缩放已得到改进。
• 标记拖动事件 .latLng 不再经过混淆处理。

2010 年 2 月 26 日

已更改的问题：

• 问题 1651： 地图画布上的 mousemove / mouseover / mouseout
• 问题 2142：DirectionsRendererOptions 应允许用户完全隐藏标记
• 问题 2148：欠缺 event.latLng！
• 问题 2109： bug：NavigationControlStyle.ZOOM_PAN 在 IE8 中无法正确显示
• 问题 2153： MVCArray.push() 不会返回新长度

显著变更：

• 为 ImageMapType 添加不透明度。
• 修复了右键点击矩形/圆形时未触发事件的 bug。
• 信息窗口的内容事件在隐藏后不再移除。

2010 年 2 月 8 日

已更改的问题：

• 问题 2135：Bug：如果您在多段线中重复使用多边形的 MVCArray，多段线将关闭。

显著变更：

• 添加了新的 Rectangle 类
• 添加了新的圆形类
• 修复了创建标记后再移除标记时发生的内存泄漏问题。
• 停止了对 LatLng 的 MVCArray 进行注解以闭合多边形，因为这会导致共享相同 MVCArray 的多段线也被闭合（请参阅问题 2135）
• 修复了有时在地图的缩放比例设为当前值时隐藏屏幕上的标记的错误。
• 修复了 ImageMapType，使其在 Android 上正确显示。
• 更改了多边形裁剪方案，以允许包含北极或南极的多边形。
• 将 MercatorProjection 的纬度范围扩大到浮点精度允许的最大范围。

2010 年 1 月 28 日

已更改的问题：

• 问题 1367：功能请求：公开 LayoutManager，以便开发者在“控制流”中放置 DIV
• 问题 1916： 功能请求：添加了缩放 MarkerImage 的功能
• 问题 1443：extend() 和 union() 应返回 LatLngBounds 对象
• 问题 1997： “size”MapOption 的文档
• 问题 2074：当世界地图与地图容器的尺寸完全匹配时，地图无法渲染

显著变更：

• 添加了对印度语系语言的支持：
• bn、gu、kn、ml、mr、ta、te
• 向事件命名空间添加了新的静态方法：
• addListenerOnce
• addDomListenerOnce
• 向 DirectionsStep 对象添加了新的“encoded_lat_lngs”属性，以便以压缩的 ASCII 格式公开一组经纬度
• 通过移除屏幕外标记 DOM 元素来提升性能
• 修复了 Google Chrome 中的平移 bug
• 修复了 iPhone 上的双指张合缩放 bug

2010 年 1 月 19 日

已更改的问题：

• 问题 1422： 功能请求：允许开发者创建自定义地图类型
• 问题 1523：功能请求：fromContainerPixelToLatLng（反之亦然）
• 问题 1443：Extend() 和 union() 应该返回 LatLngBounds 对象
• 问题 1960：bug：使用 provideTripAlternatives 时信息不完整
• 问题 1675：教程文档错误
• 问题 1676：教程文档错误 - 控件选项
• 问题 1856：Polygons not rendering in Opera!!!
• 问题 1954：保加利亚语本地化不正确。
• 问题 1976：错误：自定义图标和可拖动标记问题
• 问题 2063：缩减 OverlayView 子类时变量名称发生冲突

显著变更：

• 发布了对自定义地图类型（包括基本地图类型、叠加层地图类型和投影）的支持：
• http://code.google.com/apis/maps/documentation/v3/overlays.html#CustomMapTypes
• 新增了 ImageMapType 对象，以支持自定义地图图块
• http://code.google.com/apis/maps/documentation/v3/reference.html#ImageMapType

2009 年 12 月 17 日

显著变更：

• 修复了在地图平移动画开始之前发生的初始抖动问题。
• 修复了使用滚轮或 DoubleClick 缩放至超过最大缩放级别时地图会跳转到其他位置的问题。
• 版权、MapType 和导航控件会根据地图大小调整大小。
• 旧样式的 getter、setter 和事件名称已正式弃用，并且不再进行定义。

2009 年 12 月 10 日

已更改的问题：

• 问题 1820：使用滚轮进行放大操作似乎使缩放级别超出最大缩放级别，并且地图位置会“跳过/跳跃”
• 问题 1743：滚动缩放会导致地图移动到完全不同的位置

其他显著变更：

• 添加了新方法 panToBounds。
• 添加了新的地图动画。会影响所有浏览器中的拖动、平移、缩放和对 setCenter/setZoom 的调用。
• 添加了在使用已废弃的方法时发出的控制台日志警告消息。

2009 年 11 月 25 日

已更改的问题：

• 问题 1696： 功能请求：地图控件放置
• 问题 1909：在地图中心发生变化后，getBounds 出现损坏
• 问题 1938：map.setOptions 无法识别控件选项

其他显著变更：

• 添加了 RTL 支持，以启用以下语言： 阿拉伯语、波斯语、希伯来语
• 公开了 DirectionsResult 步骤的 lat_lngs 属性。

2009 年 11 月 11 日

已更改的问题：

• 问题 1742： 自定义图标标记始终显示在默认标记上方

其他显著变更：

• 新增了对三种新语言的支持。
• 巴斯克语
• 加利西亚语
• 塔加路语

2009 年 10 月 29 日

已更改的问题：

• 问题 1421： 功能请求：向 API v3 添加 Directions 类

其他显著变更：

• 更新了参考文档，添加了 DirectionsRenderer 和 DirectionsService

2009 年 10 月 26 日

已更改的问题：

• 问题 1647： 功能请求：为 infowindow dom ready 提供事件
• 问题 1710：可以在双击时取消用户缩放事件

其他显著变更：

• 将无效参数传入新的 google.maps.LatLng() 时，会抛出 JS 错误
• 修复了 bug：静态地图在加载时加载两次

2009 年 10 月 15 日

已更改的问题：

• 问题 1525：在低缩放级别下出现 get_bounds 错误
• 问题 1757：fitBounds() 在 180 经度上不起作用
• 问题 1790： map.setOptions 无法设置光标
• 问题 1767： 事件传播存在 bug 问题

其他显著变更：

• 文档更新：
• 公开了新方法：LatLngBounds.isEmpty()
• 按名称对所有方法、事件、属性和常量进行排序
• 修复了多段线和多边形选项属性中的错误类型

2009 年 9 月 28 日

• 改进了多边形渲染性能。
• 修复了 SVGView 的 JS 警告问题。

2009 年 9 月 22 日

已更改的问题：

• 问题 1420：功能：向 API 添加多段线类
• 问题 1371：在地图移动时，map.bounds_changed 事件会反复触发
• 问题 1700：在 Firefox 3.5 中缩小后点击时的位置不正确
• 问题 1702：当父元素中存在滚动偏移量时，点击和双击事件中报告的 latLng 不正确
• 问题 1723：在 iPhone 上拖动时地图会跳跃

其他显著变更：

• 发布了多段线和多边形！借助这些 API，您可以在地图上绘制线条或填充区域、指定描边和填充样式，并支持大多数鼠标事件（即尚不支持鼠标悬停）。它们适用于所有受支持的浏览器（IE6.0 及更高版本、Firefox 2.0 及更高版本、Safari 3.1 及更高版本、Chrome），包括受支持的移动设备。
• 在开发者指南中添加了两个关于多段线和多边形的新部分。
• 向 API 参考文档中添加了两个新类，分别用于 Polyline 和 Polygon。
• 添加了新的地图事件“idle”，该事件会在地图一段时间没有移动时触发。解决了问题 1371。
• 修复了从点击事件返回的错误 LatLng 值的问题。
• 修复了 iPhone 上的双指张合缩放 bug。请参阅问题 1723。

2009 年 9 月 10 日

已更改的问题：

• 问题 1659：在平移后，点击和双击事件中报告的 latLng 不正确，Firefox 3.5
• 问题 1621：在 ie8 中使用 dooctype 在地图上点击地图后会获得错误的位置
• 问题 1642： InfoWindow overflow:auto
• 问题 1531： infoWindow 的高度会随着每次打开而增加

其他显著变更：

• 修改了 get/set 方法和事件名称的语法，如下所述。为了保持向后兼容性，旧版语法仍受支持。例如：
• set_funBoat() => setFunBoat()
• get_funBoat() => getFunBoat()
• funBoat_changed => funcraft_changed
• 向 OverlayView 接口添加了新方法“onAdd”，系统会在首次初始化窗格和投影时调用此方法。这解决了问题 1377。
• OverlayView 接口的“remove”方法已重命名为“onRemove”。旧名称仍受支持，以实现向后兼容性。

2009 年 9 月 2 日

已更改的问题：

• 问题 1525：在低缩放级别下出现 get_bounds 错误
• 问题 1596：平移超过世界北部或南部边缘时会返回错误
• 问题 1643：错误：不必要地映射滚轮
• 问题 1379：我在 V3 中看不到韩国地图数据

其他显著变更：

• 在 Chrome、Safari 4 和 Firefox 3.5 中启用了连续滚轮和双击缩放功能
• 改进了地图拖动性能
• 双击现在会在缩放后将地图居中

2009 年 8 月 24 日

已更改的问题：

• 问题 1567：将 map.set_center 设置为附近的位置不起作用。
• 问题 1605：滚动地图也会滚动页面
• 问题 1467：平移地图函数 + 动画

其他显著变更：

• 默认启用滚轮缩放功能。如需停用此选项，请将地图选项的滚轮属性设为 false。
• 更新了文档，以添加 panTo 和 panBy 函数。

2009 年 8 月 14 日

已更改的问题：

• 问题 1575：可拖动标记方法 set_draggable() 中存在 bug

其他显著变更：

• 已启用滚轮缩放功能。
• 修复了影响 iPhone 的问题，即地图在拖动后会跳转。

2009 年 8 月 4 日

已更改的问题：

• 问题 1393：允许使用可拖动标记
• 问题 1448： 错误：API v3 需要 checkResize() 函数（或等效函数）
• 问题 1404：Opera 中的光标出错
• 问题 1514：使用 HTML 4.01 严格模式时，MapType 选择箭头显示不正确
• 问题 1426： InfoWindow z-index 控件

其他显著变更：

• 在 iPhone 上使用双指张合和拖动操作应该更稳定。
• 向 InfoWindow 对象添加了 zIndex Setter 和 Getter。

文档变更：

• 添加了标记 get_draggable 和 set_draggable 方法
• 添加了标记拖动、拖动开始、拖动结束、draggable_changed 事件
• 添加了标记可拖动属性
• 添加了信息窗口 get_zIndex 和 set_zIndex 方法
• 信息 添加了窗口 zIndex_changed 事件
• 添加了信息窗口 zIndex 属性

2009 年 7 月 13 日

已更改的问题：

• 问题 1415： infowindow 内容：可选择 true/ false
• 问题 1432：在调用 set_icon 后，Mouseout 事件未触发
• 问题 1365：使用严格的 DOCTYPE 时，地图类型控件无法正确渲染

其他显著变更：

• 开发者无需再为 MarkerImage 指定大小，API 会在未提供时检测大小。附带说明：MarkerImage 的 size、anchor 和 origin 参数均为可选参数。
• 开发者无需再在 OverlayView 子类的构造函数中调用 OverlayView.call(this)。
• 从接口中移除了“已更改”的 OverlayView 方法。这不应影响开发者的代码，因为这些方法之前实际上并未使用。
• 从地理编码器请求对象中移除了 partialmatch 选项。如果开发者继续传递，对查询没有任何影响。

2009 年 6 月 12 日

更改的问题：

• 问题 1363： bug：iPhone 上未分派地图点击事件

其他显著变更：

• 大号缩放控件在所有浏览器中均可点击
• Infowindow 会“清除”大缩放控件，将自身完全放置在地图和控件内
• 移动版版权使用美观的图片
• 功能块从中间而不是左上角加载
• 用户无法再选择地图类型按钮的文本或任何控件图片
• 主库小于约 1.9 KB