Maps JavaScript API 版本说明

订阅以下版本说明。

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

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

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

自 2021 年 8 月 26 日起，从 beta 渠道开始，Maps JavaScript API 可能会进行额外的调用来报告遥测信息，以便计算多项功能的服务等级目标 (SLO)。您可能需要更新内容安全政策，以确保这些调用不会在浏览器级别被阻止。如需了解详情，请参阅常见问题解答。

3.59.3

2024 年 12 月 12 日

变更：

• Firebase App Check 现已可与 Maps JS API 和 Places JS 搭配使用。

3.59.2

2024 年 12 月 5 日

变更：

• [Alpha 版] 在支持的城市中，z17 及更高级别的缩放级别下会显示原子地图项。
• 向初始化程序添加了使用归因 ID，这有助于 Google 了解哪些库和示例对开发者有用，例如标记聚类库的使用情况。如需停用发送使用归因 ID 的功能，您可以放心地删除此属性或将值替换为空字符串。实例化后对此值所做的更改可能会被忽略。
• 您现在可以使用 Firebase App Check 来防范恶意请求。详细了解如何将 App Check 与地点集成以及如何将 App Check 与 Google 地图集成。

3.59.1

2024 年 11 月 21 日

变更：

• [Beta 版频道] 修复了街景中缺少缩放控件的问题。
• 修复了以下 bug：不可点击的旧版标记仍会分派点击事件。
• 修复了导致高级标记在切换到自定义地图类型时无法更新像素位置的 bug。
• 现在，在应用具有地图 ID 的默认或自定义地图类型和样式时，系统会记录控制台警告。当存在地图 ID 时，地图样式是通过 Cloud 控制台进行控制的，并且云端样式目前仅适用于路线图地图类型。
• 在深色模式下，设置悬停时相机控制移动按钮的样式。
• 解决了使用非常小的边界时 fitBounds 内边距问题。

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 会错误地在地图周围显示蓝色焦点线。
• 为 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 日

变更：

• 将 searchNearby 函数添加到新的 Place 类。

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 组件。
• 向新的地点类 API 添加了停车选项。
• 废弃了 google.maps.Marker。请改为使用 google.maps.marker.AdvancedMarkerElement。目前，我们没有计划停用 google.maps.Marker，但建议您改用 google.maps.marker.AdvancedMarkerElement，而不是 google.maps.Marker。虽然 google.maps.Marker 将继续收到针对任何重大回归问题的 bug 修复，但 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，或向 Web 组件添加 gmp-clickable 属性。对于使用 addListener() 注册 gmp-click 事件的用户，目前无需进行任何更改。

3.55.7

2024 年 1 月 11 日

变更：

• [Beta 版渠道] AdvancedMarkerElement 的 element 属性现在指向 AdvancedMarkerElement 的实例。
• [Beta 版渠道] 高级标记现在可以使用子节点自定义其内容。
• 修复了点击地图后平移和缩放键盘快捷键无法使用的 bug。
• 为 JavaScript 历程共享启用多段线自定义功能。
• [Alpha 渠道] 向 PlaceAutocomplete 添加了 types、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 日

变更：

• [Beta 版渠道] 修复了导致 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：除非街景小人先返回到底部至少一次，否则不会显示拖动悬停预览。
• 地点自动补全服务的 bounds、location 和 radius 已废弃。请改为使用 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 版渠道] 发布了有关地点 v2 toJSON 方法的文档。
• [Beta 版渠道] 修复了地图换行时拖动高级标记时出现的问题。
• [Beta 版渠道] 数据驱动型样式设置：PlaceFeature.fetchPlace 的显示名称将采用最终用户的语言。
• [Beta 版] AdvancedMarkerView 和 PinView 已重命名为 AdvancedMarkerElement 和 PinElement。
• [Beta 版渠道] 修复了 AdvancedMarkers 和 Pin 有时无需显式加载即可使用的问题。请务必先加载“marker”库，然后再访问这些类。
• [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 修复：

• 修复了关闭 InfoWindow 会导致错误的 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 修复：

• 修复了以下 bug：对于 importLibrary() 使用的库，TypeScript 接口为空。

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 Nonce。

3.51.7

2023 年 1 月 26 日

变更：

• Beta 版渠道：数据驱动型样式：添加了 fetchPlace 方法，用于获取地图项的显示名称。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：在传递封装在代理中的 Map 时，高级标记无法呈现。
• Beta 版渠道：为 JavaScript 历程共享添加了行程地理位置提供商标记自定义功能。

3.51.2

2022 年 12 月 1 日

变更：

• Beta 版渠道：google.maps.importLibrary() API 现已发布。
• Beta 版渠道：已弃用：Local Context 已弃用，不再建议用于新网站。此功能可继续正常使用；我们若计划停止支持，会提前 12 个月发出通知。如果您有兴趣自行打造类似于 Local Context 的体验，建议您在快速构建器中查看“街区探索”解决方案或使用 Maps JavaScript API 的地点库。 地点库的代码示例和 Codelab 可以为您提供帮助。
• Beta 版渠道：为了改进核心网页指标并减少不必要的数据传输，Google 地图 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 版渠道：为行程分享添加了样式自定义功能。旧版设置方法已废弃。
• Internet Explorer 11 现已从 Maps Embed API 中弃用。
• 使用混合地图或卫星地图类型时，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 上 InfoWindow 的右侧和底部内边距问题。

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 日

变更：

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

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 参数。
• 修复了多个地点 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 设备上，街景中的动作跟踪控件不可见。
• 修复了以下 bug：在嵌入 API 中，对于 RTL 语言，路线的悬停文本会被截断。
• 使公交信息窗口更易于访问，更易于屏幕阅读器使用。

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 修复：

• 修复了导致在关闭街景时提交表单的 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 版渠道：修复了多个地点 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。
• 向全屏控件添加了 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 叠加视图 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 修复：

• 修复了 sInfoWindow 中“在 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 参考文档。
• Beta 版渠道：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 日

变更：

• Beta 版频道：Beta 版的 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 属性替换为符合标准的数据-* 属性。

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 日

变更：

• 现在，当第一个可聚焦控件不在 InfoWindow 视口中或 disableAutoPan=true 时，系统会在打开时将焦点管理到 InfoWindow 容器。

bug 修复：

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

3.45.5

2021 年 7 月 1 日

变更：

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

bug 修复：

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

3.45.4

2021 年 6 月 24 日

变更：

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

3.45.3

2021 年 6 月 16 日

bug 修复：

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

变更：

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

3.45.2

2021 年 6 月 10 日

bug 修复：

• 修复了以下问题：在嵌入 API 中，键盘快捷键对话框的背景无法正确叠加在地图类型控件上。
• 修复了在加载字体 CSS 样式时可能会导致错误的问题。
• 修复了以下 bug：在打开 InfoWindow 的情况下平移地图时可能会出现闪烁。

变更：

• 添加了 InfoWindowOpenOptions.map 属性。

3.45.1

2021 年 6 月 3 日

变更：

• 向 Data.StyleOptions 接口添加了有关动画、图标、标签和不透明度属性的文档。
• 重新设计了版权对话框，以提供更好的可访问性支持。
• InfoWindows 现在会在打开时自动管理焦点。这是新的默认行为。
• 添加了 InfoWindowOpenOptions API，让开发者能够控制打开 InfoWindow 时的焦点管理方式。
• 现在，您可以通过按下 Esc 键关闭 InfoWindows。
• 现在，使用屏幕阅读器时，InfoWindow 会被读出为“对话框”。
• 现在已启用 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 修复：

• 修复了以下 bug：启用街景后，地图控件可通过键盘访问。

3.44.8

2021 年 4 月 1 日

变更：

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

3.44.7

2021 年 3 月 25 日

变更：

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

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 版渠道中启用了多填充隔离。这意味着，Maps JavaScript API 将不再将 polyfill 安装到托管页面中。

3.43.8a

2021 年 2 月 25 日

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

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

3.43.8

2021 年 2 月 5 日

变更：

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

bug 修复：

• 修复了以下问题：即使 clickable 设为 false，带标签的 Markers 也会拦截点击事件。

3.43.7a

2021 年 1 月 28 日

bug 修复：

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

3.43.6

2021 年 1 月 21 日

bug 修复：

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

3.43.5

2021 年 1 月 14 日

变更：

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

bug 修复：

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

3.43.3

2020 年 12 月 9 日

变更：

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

bug 修复：

• 修复了在某些情况下，在全局和街景之间切换时全屏控制功能会停止运行的 bug。
• 修复了以下 bug：在标记的 click 事件中，控制台中会记录错误。
• 修复了标记的可点击区域的大小绘制得过大的 bug。
• 修复了影响 IE11 上符号的 polyfill 冲突 bug。

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 键或空格键打开和关闭下拉菜单。
• 下拉菜单项现在可以聚焦。
• 本地情境库：当轮播界面控件按钮无效时，系统会将其停用，并且这些按钮不再与列表中的第一项或最后一项重叠。

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 日

变更：

• 在路线服务中添加了对承诺的 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() 实现，系统会将错误记录到控制台。
• 在 Elevation 服务方法中添加了对 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 的实际最大宽度为 94px。 此更改生效后，实际宽度上限将为 100 像素。
• 修复了使用标记和地图边界时绘制请求构建器的内存泄漏问题。

3.40.6

2020 年 3 月 24 日

变更：

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

3.40.4

2020 年 3 月 10 日

变更：

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

3.40.2

2020 年 2 月 23 日

变更：

• 从标签页导航中移除了 Google 地图中的隐藏 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（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：bug：防范 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 地图网站的体验更加一致。如果您还想继续使用一段时间较早版本的控件集，您可以在 3.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 地理编码为地址/经纬度的功能
• 通过 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 性能回归
• 移除了受众特征图层
• 改进了 InfoWindow 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：设置街景视角标题会抛出错误

2014 年 8 月 26 日

3.18 已发布为实验版。

3.17 现已稳定。

3.17

2014 年 8 月 20 日

修复了以下问题：

• 问题 6937： 3.17 中的回归问题：无法读取未定义的“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 上停用所有功能块硬件加速，以解决更大的问题。

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，以便以编程方式添加覆盖层
• 公开了适用于 StreetViewPanorama 的 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 日

添加时间:

• 室内街景
• 将 fixedRotation 选项添加到 IconSequence
• 将“当前路况所需时间”添加到路线中

2012 年 9 月 11 日

新变化：

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

2012 年 8 月 28 日

添加时间:

• 将类型添加到 Places API textSearch

修复了以下问题：

• 在 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）

添加时间:

• 街景中的点击即可前往/点击即可放大功能 ( 问题 2447)

显著变更：

• 默认情况下，在街景中停用了双击缩放功能

2012 年 3 月 6 日

修复了以下问题：

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

添加时间:

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

2012 年 2 月 21 日

修复了以下问题：

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

添加时间:

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

2012 年 2 月 15 日

修复了以下问题：

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

显著变更：

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

3.7

2012 年 2 月 7 日

修复了以下问题：

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

显著变更：

• 放大标记现在会在 Canvas 中呈现（如果可用）

添加了：

• 针对 ImageMapType 添加了 setOpacity() (问题 3125)
• GroundOverlay 的 setOpacity()（问题 2767）
• ImageMapType 的“tilesLoaded”事件 ( 问题 1744)
• 将 stop() 添加到 MouseEvent，用于停止事件传播（问题 2172）

2012 年 1 月 31 日

修复了以下问题：

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

2012 年 1 月 24 日

修复了以下问题：

• 鼠标事件会通过 InfoWindow 冒泡（问题 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 日

修复了以下问题：

• 现在，InfoWindow 内容大小的计算会考虑到层叠样式
• 鸟瞰地图旋转控件与地图创建时的标题不符

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 上滚动 InfoWindow

2011 年 7 月 18 日

已解决的问题：

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

2011 年 7 月 11 日

已解决的问题：

• 修复了以下问题：<select> 在触摸设备上的 Infowindow 中不可点击（问题 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）
• 修复了 IE8 中 ImageMapType 的不透明度问题

显著变更：

• 当拖动带有自定义图标的标记时，系统会在标记下方显示一个十字架，并且 raiseOnDrag 处于启用状态

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：最初的街景导航器控件标题不遵循视角

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：浏览器刷新 / onunload 时未清除内存 (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 叠加层不再触发地图点击事件
• 现在，Street View 会自动平移以适应屏幕上的 InfoWindow
• 将 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 的“optimized_waypoint_order”属性重命名为“waypoint_order”
• 移除了对旧版路线属性名称 (setTripIndex、getTripIndex、hideTripList、provideTripAlternatives) 的支持，并继续记录警告。此外，还移除了将路线转换为相应路段再转换为步骤，以及将行程转换为路线再转换为步骤的转化。
• 将 GeocoderGeometry.latLng 更新为 GeocoderGeometry.location

2010 年 4 月 30 日

已更改的问题：

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

显著变更：

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

2010 年 4 月 26 日

已更改的问题：

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

显著变更：

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

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 应提供 avoidHighways 选项
• 问题 2207： 错误：IE 中会填充多段线
• 问题 2113：在 1 月发布后，FF 中高缩放级别的多段线会中断

显著变更：

• 添加了骑车路线！
• 添加了新的 DirectionsRequest 选项：
• avoidHighways
• avoidTolls
• optimizeWaypoints
• 提高了多边形/多段线的渲染速度
• 重命名了以下 Directions 对象。旧名称仍受支持。
• 路线到 DirectionsLeg
• 导航行程到 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，多段线会关闭。

显著变更：

• 添加了新的矩形类
• 添加了新的圆形类
• 修复了创建标记后再移除标记时发生的内存泄漏问题。
• 停止了对 LatLng 的 MVCArray 进行注解以闭合多边形，因为这会导致共享相同 MVCArray 的多段线也被闭合（请参阅问题 2135）
• 修复了以下 bug：如果将地图的缩放设置为其当前值，系统有时会隐藏屏幕上的标记。
• 修复了 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： bug：自定义图标和可拖动标记问题
• 问题 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 日

显著变更：

• 修复了在地图平移动画开始之前发生的初始抖动问题。
• 修复了使用滚轮或双击缩放到超出最大缩放级别时地图跳转到其他位置的问题。
• 版权、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 添加了 Polyline 类
• 问题 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 中点击带有 doctype 的地图后，会获取错误的位置信息
• 问题 1642： InfoWindow overflow:auto
• 问题 1531： infoWindow 的高度会随着每次打开而增加

其他显著变更：

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

2009 年 9 月 2 日

已更改的问题：

• 问题 1525：在低缩放级别下出现 get_bounds 错误
• 问题 1596： panning past the northern or southern edge of the world returns an error
• 问题 1643： bug：地图滚轮不必要地滚动
• 问题 1379：我在 V3 中看不到韩国地图数据

其他显著变更：

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

2009 年 8 月 24 日

已更改的问题：

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

其他显著变更：

• 默认启用滚轮缩放功能。如需停用此功能，请将 Map 选项的滚轮属性设置为 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 后，鼠标移出事件不会触发
• 问题 1365：使用严格的 doctype 时，地图类型控件无法正确呈现

其他显著变更：

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

2009 年 6 月 12 日

更改的问题：

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

其他显著变更：

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