Maps JavaScript API 版本说明归档

本归档列出了 2024 年及更早年份的 Maps JavaScript API 版本说明。如需了解最新版本，请参阅 Maps JavaScript API 版本说明。

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 与 Places 搭配使用以及将 App Check 与 Maps 搭配使用。

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 属性。您可以使用 #rgba、#rrggbbaa、rgba(r, g, b, a) 或 rgb(r g b / a) 颜色格式在相应的 *Color 属性中指定 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 查找的地理编码响应添加了地址描述符。
• 向 Place 类添加了多个主要类型和显示名称属性。

3.57.9

2024 年 7 月 18 日

变更：

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

3.57.8b

2024 年 7 月 11 日

没有面向公众的变更。

3.57.7

2024 年 7 月 4 日

变更：

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

3.57.6a

2024 年 6 月 27 日

没有面向公众的变更。

3.57.5

2024 年 6 月 20 日

没有面向公众的变更。

3.57.4

2024 年 6 月 13 日

变更：

• [Beta 渠道] 集成了新的标签添加工具，用于呈现矢量地图标签。
• InfoWindow 具有新属性 isOpen，用于指明它是在地图上还是在街景中打开。
• 修正了地点自动补全 PlacePrediction 类的错误参考文档。

3.57.3a

2024 年 6 月 6 日

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

3.57.2

2024 年 5 月 28 日

变更：

• 修复了 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 渠道] 新的信息窗口关闭按钮和可选标题现已推出。
• [Beta 渠道] 改进了街景小人控件的键盘和单指针无障碍功能。
• 修复了因移除高级标记而导致的内存泄漏问题。
• 修复了圆圈无法绘制平滑周长的问题。
• 添加了用于在 google.maps.Map 实例化期间设置矢量模式的 API（不需要 mapId）。

3.56.8

2024 年 4 月 11 日

变更：

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

3.56.7

2024 年 4 月 4 日

变更：

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

3.56.6

2024 年 3 月 28 日

变更：

• [Beta 渠道] 地图光栅图块现在以 WebP 图片格式提供。
• 修复了矢量地图上地图内地图注点的信息窗口锚点定位问题。
• 修复了以下 bug：AdvancedMarkerElement 在显示时没有设置位置。
• 向 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 仍会针对任何重大回归问题提供 bug 修复，但 google.maps.Marker 中的现有 bug 将不再处理。服务停用前，我们将至少提前 12 个月发出通知。如需了解弃用详情，请访问 https://developers.google.com/maps/deprecations。
• 向新的 Place 类 API 添加了其他属性。
• 向新的 Place 类 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 类现已在每周渠道中推出。
• 弃用 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，以自动处理从右到左的布局上下文。

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 渠道] 向 Places 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() 不可用的 bug。

3.54.4

2023 年 9 月 7 日

变更：

• 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 渠道] 新 Place 类中的提供方说明已重构。PhotoAttribution 现为 AuthorAttribution。author 现更名为 displayName。authorURI 现更名为 uri。photoURI{?string}现已在AuthorAttribution上架。Photo.attributions 现更名为 Photo.authorAttributions。Review.authorAttribution {?AuthorAttribution} 取代了 Photo.author/authorURI/authorPhotoURI。
• [Beta 渠道] 在 Place 类的 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 日

变更：

• 允许将 Node 元素传递给高级标记的 content 属性。
• 改进了高级标记冲突行为的性能。
• 在 JavaScript 行程分享中为 DeliveryVehicleStop 添加了新字段。

3.53.4a

2023 年 5 月 24 日

bug 修复：

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

3.53.3

2023 年 5 月 18 日

变更：

• [Alpha 渠道] 修复了以下 bug：如果您使用箭头键突出显示联想查询，然后点击“Esc”键，地点自动补全元素不会恢复原始文本。
• [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 行程分享中，向 Task 和 TaskTrackingInfo 添加了 TimeWindow 字段。
• AdvancedMarkerElement 和 PinElement 已发布到每周渠道。
• 边界的数据驱动型样式已发布到每周渠道。
• getMapCapabilities 和 mapcapabilities_changed 事件已发布到每周渠道。

3.53.1a

2023 年 4 月 27 日

变更：

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

3.52.9

2023 年 4 月 13 日

变更：

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

bug 修复：

• 修复了关闭 InfoWindow 会导致错误的 bug。

3.52.8

2023 年 4 月 6 日

变更：

• 在 JavaScript 行程分享中，将 pollingIntervalMillis 添加为轮询位置信息提供方的公共字段。
• [Beta 渠道] 将 Place 类 JSON 响应从蛇形命名法更改为 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。
• 修复了 InfoWindow 关闭按钮在影子根中不可见的 bug。
• 为了改善 Core Web Vitals 并减少不必要的数据传输，Maps JS 现在会延迟加载地图图块，直到地图接近视口。在网页的初始视口中创建的地图应该不会有任何变化。

3.52.1

2023 年 2 月 16 日

变更：

• 添加了 importLibrary() 函数，该函数可在运行时动态加载库。
• [Beta 渠道] 启用 InfoWindow 在高级标记上打开时的自动平移功能。
• [Beta 版渠道] 将 Journey Sharing 库数据对象中的某些字段设为不可为 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 随机数。

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：将高级标记与 InfoWindow 搭配使用时，使用键盘拖动标记后，InfoWindow 可能无法打开。

3.51.4

2023 年 1 月 5 日

变更：

• Beta 渠道：向地点类添加新属性
• Beta 渠道：如果点击位置有多个地图项，则数据驱动型样式 FeatureMouseEvent.features 数组可能包含多个地图项，并且点击位置的所有 FeatureLayer 点击监听器都会触发。
• Beta 渠道：如果 google.maps.Map.getFeatureLayer 的参数无效，则会抛出错误。
• 更正了全屏地图上高级标记的像素位置。
• 更改了地图鼠标事件，现在会忽略在已按下某个鼠标按钮的情况下发生的其他鼠标按钮点击。
• 修复了导致高级标记在放大地图时消失的问题。
• 提升了在包含许多高级标记的地图中进行缩放时的性能。
• 更新了 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 中引入了语言参数。如果未明确指定，Maps JS API 不再将 US 视为 Geocoder 中的默认区域。
• 在 Directions JS API 中引入了语言参数。
• 在 Distance Matrix JS API 中引入了语言参数。

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 日

变更：

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

3.50.6

2022 年 9 月 22 日

bug 修复：

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

变更：

• 现在，当调用 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 值会被拒绝。
• 修复了在 iOS 设备上使用街景时动作追踪控件不可见的 bug。
• 修复了以下 bug：在 Embed 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 日

变更：

• 改进了街景动作追踪控件的色彩对比度。
• 使街景中的动作追踪控件支持键盘操作，并对屏幕阅读器友好。
• MapsNetworkError、MapsRequestError 和 MapsServerError 类现已公开并记录在文档中。

3.49.2

2022 年 5 月 26 日

变更：

• 改进了街景动作追踪控件的色彩对比度。
• 使街景中的动作追踪控件支持键盘操作，并对屏幕阅读器友好。
• 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 版 API 仍可按编号请求。
• 版本 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 修复：

• 修复了 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 参考文档。
• 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 时，地图不再接收 Tab 键焦点。
• 现在，当达到相应的最大或最小缩放级别时，“放大”和“缩小”按钮会被停用。
• 将 MapType 控件转换为使用语义元素，以改进 Maps Embed API 中的无障碍功能和屏幕阅读器体验。
• 为“错误”屏幕上的图标添加了替代文本。
• 对代码运行状况进行了多项常规改进。

bug 修复：

• 将不符合 WCAG 的 controlHeight 和 controlWidth 属性替换为符合要求的 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 日

变更：

• Local Context：从 Local Context InfoWindow 照片中移除了提供方链接。

3.46.6

2021 年 9 月 23 日

变更：

• 修复了地图不可拖动时地图光标显示为手形的问题。

3.46.5

2021 年 9 月 16 日

bug 修复：

• 修复了地点自动补全 widget 中色彩对比度存在的问题。

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 月开始，使用 Internet Explorer 11 的用户会在地图顶部看到一条警告消息。支持 Internet Explorer 11 的最后一版 Maps JavaScript API 是 v3.47。我们将于 2022 年 11 月完全停止对 Internet Explorer 11 的支持。

bug 修复：

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

3.45.8

2021 年 7 月 29 日

变更：

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

3.45.7

2021 年 7 月 22 日

变更：

• 对 IE11 的支持已弃用。现在，IE11 中的地图将在 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 修复：

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

变更：

• 添加了 InfoWindowOpenOptions.map 属性。

3.45.1

2021 年 6 月 3 日

变更：

• 向 Data.StyleOptions 接口添加了动画、图标、标签和不透明度属性的文档。
• 重新设计了版权对话框，以提供更好的无障碍支持。
• 现在，InfoWindow 在打开时会自动管理焦点。这代表新的默认行为。
• 添加了 InfoWindowOpenOptions API，让开发者能够控制在打开 InfoWindow 时如何管理焦点。
• 现在，按 ESC 键即可关闭 InfoWindow。
• 现在，使用屏幕阅读器时，InfoWindow 会被读为“对话框”。
• 现在已启用 polyfill 隔离；此更改可防止在宿主页面上安装地图 API 内部 polyfill。

bug 修复：

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

新功能：

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

3.44.14

2021 年 5 月 13 日

变更：

• 现在，如果在没有关联的 Map 或 StreetView 实例的情况下调用 InfoWindow.open()，系统会将警告记录到控制台。

3.44.12

2021 年 4 月 28 日

bug 修复：

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

Local Context：

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

3.44.11a

2021 年 4 月 20 日

变更：

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

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 渠道中开启了 Polyfill 隔离。这意味着，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 修复：

• 修复了以下 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 修复：

• 修复了在某些情况下，在地图和街景之间切换时，全屏控件停止运行的 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 键或空格键打开和关闭下拉菜单。
• 下拉菜单项现在可以获得焦点。
• 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 地图的倾斜度会根据缩放级别受到限制。
• 修复了在 Internet Explorer 上当 controlSize 小于 27 时全屏按钮部分消失的问题。

3.42.8

2020 年 10 月 7 日

变更：

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

支持更新后的地点图标

2020 年 10 月 1 日

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

3.42.7

2020 年 9 月 29 日

变更：

• 修复了以下 bug：在“报告地图错误”控件提示中，从右到左 (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 日

已修复：

• 修复了使用云端样式设置时，将 clickableIcons 属性设置为 false 无效的 bug。

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 不是 Element，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 无法再使用（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 Code 的支持。Plus Code 是简短的代码，可为世界上每个地点提供地址，即使在没有传统街道地址的区域也是如此。
• 我们已不再支持 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 的格式可能会发生变化。
• 您可以使用问题跟踪器报告任何问题。
• 更新了 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：用户必须用单指滑动才能滚动页面，用双指滑动才能平移地图。如果用户用单指滑动地图，地图上会显示一个叠加层，其中包含提示，告知用户使用双指移动地图。在移动设备上查看上述示例，了解协作模式的实际效果。
  • none：地图无法平移或捏合。
  • auto（默认）：行为是 cooperative 或 greedy，具体取决于页面是否可滚动。

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

• 默认情况下，全屏控件在移动设备上可见，因此用户可以轻松放大地图。当地图处于全屏模式时，用户可以使用一根或两根手指平移地图。注意：iOS 不支持全屏功能。因此，全屏控件在 iOS 设备上不可见。

已弃用登录地图

2016 年 10 月 6 日

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

路线服务响应中的经停点变更

2016 年 8 月 29 日

Directions Service 响应中的 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 日

变更：

• 现在，您可以停用地图图标的可点击性。地图图标表示地图注点（也称为 POI）。请参阅 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 Content Security Policy 指令即可使用该 API。

2015 年 12 月 21 日

变更：

• 地图选项，用于停用已登录地图的登录按钮（它会显示已登录用户的头像，仍允许通过登录操作 [例如加星标] 进行登录，但设置此选项后，地图上将不再有登录按钮）。
• 文本搜索请求的接口已发生变化。types 参数已于 2016 年 3 月 1 日弃用，取而代之的是新的 type 参数，该参数在每个搜索请求中仅支持一种类型。 此外，establishment、food 和 grocery_or_supermarket 类型将不再作为搜索参数受支持（不过，这些类型可能仍会在搜索结果中返回）。使用旧版 types 参数的请求在 2017 年 3 月 1 日之前仍受支持，在此之后，所有文本搜索都必须使用新实现。

2015 年 12 月 2 日

变更：

• Autocomplete 构造函数会验证它是否获得了输入元素。
• 基本地图注点信息窗口在未登录模式下显示的内容与登录模式下相同。
• Closure 编译器的 Google Maps API 外部函数现在为枚举指定了类型（数字或字符串）。

2015 年 11 月 25 日

变更：

• 向 LatLng 和 LatLngBounds 对象添加了 .toJSON() 方法。这些 API 旨在通过 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 的浏览器支持政策，请参阅 2014 年 8 月 7 日的 IEBlog 帖子。

3.21

2015 年 8 月 5 日

变更：

• 性能提升：仅加载可见图块
• 多项文档改进

2015 年 7 月 21 日

变更：

• 带标签的标记已发布
• 修复了以下问题：在超高清屏幕上，iOS7 出现 Poly 内存不足错误
• IE10+ 上的触摸事件修复
• 现在，开发者提供的输入内容中的错误验证会输出到控制台，而不是抛出错误。

2015 年 7 月 6 日

已修复：

• 问题 8159：Bug：StrokePosition.OUTSIDE 呈现不正确

2015 年 6 月 17 日

变更：

• 修复了以下问题： 问题 6321： Bug：“Uncaught TypeError: Cannot read property 'x' of undefined”（未捕获的 TypeError：无法读取未定义的属性“x”），仅在 Android/iOS 浏览器中出现

2015 年 6 月 2 日

变更：

• 已弃用：CloudLayer、PanoramioLayer
• 修复了以下问题：问题 8098：Bug：加权热图无法正确呈现一个点

2015 年 6 月 2 日

变更：

• 添加了将 placeId 地理编码为地址/经纬度的功能
• 通过 Geocoding API 返回 placeId

2015 年 5 月 28 日

变更：

• 修复了以下问题： 问题 6358：SVG 路径表示法在 HDPI 设备上无法正确呈现

2015 年 5 月 19 日

已修复：

• 问题 7673：使用地图类型下拉菜单后，控件位置发生偏移
• 问题 7589：调整地图大小时，街景小人会跳动。

3.20

2015 年 4 月 24 日

已修复：

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

2015 年 4 月 13 日

已修复：

• 问题 7820：光标在从 file:// 加载的页面上无法正常工作
• 问题 7591： 错误：当 radius 参数不是整数时，StreetViewService.getPanoramaByLocation 会失败

2015 年 3 月 25 日

已修复：

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

2015 年 3 月 17 日

已修复：

• 问题 7756：Bug：Safari 8 性能下降
• 移除了受众特征层
• InfoWindow 边框的改进

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：形状不遵循地图的“draggable”属性
• 问题 7445： bug：使用 v3 地图 API 的登录功能时出现呈现错误

2014 年 12 月 2 日

已修复：

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

2014 年 11 月 25 日

已修复：

• 问题 7333：Bug：在 IE9 中，信息窗口的插入符号损坏

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”属性（在 Places 中）

2014 年 8 月 12 日

已修复：

• 问题 6968：错误：键盘箭头键无法与 v=3.exp 搭配使用

2014 年 7 月 31 日

添加时间:

• 地图窗格提供了明确的文档，说明 DOM 事件如何通过它们进行传播。 已添加overlayMouseTarget窗格。

2014 年 7 月 7 日

添加时间:

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

2014 年 6 月 24 日

添加时间:

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

2014 年 5 月 26 日

添加时间:

• 地图 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 错误已修复，因此在 Chrome Windows 和 Linux 中重新启用硬件加速 (https://code.google.com/p/chromium/issues/detail?id=336676)

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”选项

已修复：

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

3.12

2013 年 6 月 4 日

已修复：

• 当 visualRefresh=true 时，信息窗口 domready 不会触发（问题 5415）
• 错误：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

已修复：

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

2013 年 1 月 22 日

添加时间:

• 向多段线、多边形、圆形、矩形添加了 draggable 选项
• 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 日

已修复：

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

2012 年 9 月 25 日

添加时间:

• 室内街景
• 向 IconSequence 添加了 fixedRotation 选项
• “当前路况下的用时”添加到路线

2012 年 9 月 11 日

新：

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

2012 年 8 月 28 日

添加时间:

• types 传递给 Places API textSearch

已修复：

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

2012 年 8 月 14 日

显著变化：

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

3.9

2012 年 9 月 10 日

已修复：

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

2012 年 8 月 9 日

已修复：

• Android 3.x 上的语法错误

2012 年 7 月 31 日

显著变化：

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

已修复：

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

2012 年 7 月 25 日

已修复：

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

2012 年 7 月 17 日

已修复：

• 在 IE 中，信息窗口中的文本框无法点击
• bounds_changed 应在 zoom_changed 之前触发（问题 1399）
• 调用街景后，地图选项 backgroundColor 未保留
• 从自定样式的地图切换到卫星地图会不必要地加载地图图块
• 在绘图模式下，地图 draggable/scrollwheel 属性会被忽略（问题 4012）
• 当显示多个世界副本时，LatLngBounds 应返回完整的经度范围
• 双击时不会绘制空形状 (问题 3964)
• 点击时触发多余的标记事件（问题 3911）

显著变化：

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

2012 年 7 月 10 日

显著变化：

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

2012 年 6 月 27 日

添加时间:

• TRANSIT DirectionsMode： http://mapsplatform.googleblog.com/2012/06/public-transit-routing-and-layer-now.html

• Places API 的分页、评价、textSearch： 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

• 新增了样式设置工具选项“weight”和“color”：

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 模式下，多边形会显示图块边界
• 在 Canvas 街景中平移时标记跳动

2012 年 3 月 28 日

已修复：

• 使用小写标记名称以符合 XHTML 标准（问题 3868）
• 更改了 Apple 触控板的缩放行为，以降低其敏感度（问题 2416）

2012 年 3 月 20 日

已修复：

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

添加时间:

• 街景中的点击前往/点击放大功能 (Issue 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）
• 拖动标记时忽略右键点击 (Issue 3237)
• 标记标题有时不会在 Firefox 上显示（问题 3773）

显著变化：

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

添加：

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

2012 年 1 月 31 日

已修复：

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

2012 年 1 月 24 日

已修复：

• 鼠标事件通过 InfoWindow 冒泡（问题 3573）
• 在 IE9 上启用了 CSS 转换
• 向 StreetViewPanorama 添加了 imageDateControl
• 在 IE 9、Opera 和 Safari/Windows 上启用了 Canvas 街景

2012 年 1 月 16 日

已修复：

• 在绘图模式下，小黄人应该无法拖动
• 正确触发事件，遵循多边形和其他图层的 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 上将地图 API 与 Prototype 库搭配使用时出错

2011 年 10 月 25 日

已修复：

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

2011 年 10 月 18 日

显著变化：

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

2011 年 10 月 10 日

已修复：

• 街景预览中的地址过长

2011 年 9 月 27 日

已修复：

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

2011 年 9 月 27 日

已修复：

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

显著变化：

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

2011年9月20日

已修复：

• 在 Chrome/Windows 中使用 Canvas 渲染标记时出现内存泄漏
• 偏航角为 90 度或 270 度的航拍视图的标记渲染

显著变化：

• 无法通过地图类型注册表访问默认 Google 地图类型（防止访问地图图块）
• 离开和进入航拍图像时的旋转动画

2011 年 9 月 12 日

已解决的问题：

• 在 Firefox 4+ 上显示提示后，标记会卡在凸起位置 (问题 3334)

显著变化：

• GeocoderResult.formatted_address 未记录

2011 年 9 月 6 日

已修复：

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

2011 年 8 月 29 日

显著变化：

• 允许自定义控件的 z-index 高于 API 控件
• 链接会将用户引导至正确语言版本的 maps.google.com
• 如果 KML 地图项没有信息窗口 HTML、名称或说明，请勿在 KML 地图项上打开 InfoWindow。
• 修复了回归问题：高 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> 无法点击（问题 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）
• 修复了以下问题：在 IE7 和 IE8 中，具有 ImageMapType 的半透明 PNG 会失去透明度（问题 3275）

显著变化：

• 距离矩阵服务

2011 年 4 月 14 日

已解决的问题：

• 修复：支持为多边形 strokeColor 和 fillColor 使用具名 CSS 颜色
• 修复了以下问题：如果 strokeOpacity 设置为 0.0，则多边形不可见（问题 3241）
• 已修复：在 AdUnit 可见的情况下进行平移时，IE8 中出现错误（问题 3159）
• 允许在地图类型控件中显示地形图和混合地图，但不显示地图和卫星地图（问题 3089）
• 为高 DPI 屏幕加载高 DPI 图块（问题 2614）

显著变化：

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

2011 年 4 月 14 日

已解决的问题：

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

显著变化：

• 现在，多段线和多边形会尽可能在 Canvas 中渲染。
• 多段线和多边形边界上事件的 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() 返回 undefined（问题 3114）

显著变化：

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

2011 年 3 月 11 日

已解决的问题：

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

显著变化：

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

2011 年 3 月 2 日

显著变化：

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

2011 年 2 月 22 日

已解决的问题：

• 通过“anchorPoint”MVC 属性公开 InfoWindow 锚点（问题 2860）
• 修复了缩放级别为 0 和 1 时的混合地图（问题 3062）
• 修复了快速向地图添加/从中移除圆形/矩形时出现的问题 (Issue 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 中未触发 rightclick 事件（问题 2920）
• Safari/Mac 中的文本渲染问题（问题 3024）
• 路线地图在 IE 中无法正确打印

2011 年 1 月 21 日

显著变化：

• 球面几何库现在接受 MVCArray
• 修复了在 IE6 中拖动标记时标记下方显示十字的问题
• 不再在地图容器 div 上设置 z-index

2011 年 1 月 17 日

已解决的问题：

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

2011 年 1 月 6 日

已解决的问题：

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

显著变化：

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

2010 年 12 月 23 日

已解决的问题：

• 修复了可拖动路线中的航点点击处理程序 (Issue 2871)

2010 年 12 月 21 日

已解决的问题：

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

显著变化：

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

2010 年 12 月 9 日

已解决的问题：

• 现在，在 IE 中可以很好地打印 InfoWindow（问题 1343）
• 修复了 IE8 中 ImageMapType 的不透明度问题

显著变化：

• 拖动带有自定义图标的标记时，如果启用了 raiseOnDrag，标记下方会显示一个十字

2010 年 12 月 5 日

已解决的问题：

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

显著变化：

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

2010 年 11 月 28 日

已解决的问题：

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

显著变化：

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

2010 年 11 月 16 日

更改的问题：

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

显著变化：

• 修复了在 Firefox 中按住 Shift 键点击标记时会打开新窗口的 bug。
• 使用 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 上的“rightclick”事件在没有参数的情况下触发
• 问题 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) 时未清除内存

显著变化：

• 街景标记会根据其距离进行缩放
• 平移时缩放滑块会更新

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：在附加了监听器的 Panorama 对象上调用 setVisible(false) 会导致 IE 中出现 JS 错误

显著变化：

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

2010 年 7 月 29 日

更改的问题：

• 问题 2337：多段线丢失
• 问题 2497： Circle 不支持可点击选项

显著变化：

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

2010 年 7 月 22 日

更改的问题：

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

显著变化：

• 拖动多边形时不再触发点击事件
• 点击在信息窗口外部展开的表单选择元素不再触发地图点击事件
• 点击 KML 叠加层不再触发地图点击事件
• 现在，街景会自动平移，以在屏幕上容纳 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 geodesic

显著变化：

• 修复了在自定义地图类型上无法正确显示 Google 版权信息的 bug
• 向多边形和多段线添加了测地属性
• 为多边形和多段线添加了 clickable 选项
• 为 GroundOverlay 添加了 clickable 选项

2010 年 5 月 13 日

已更改的问题：

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

显著变化：

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

2010年5月7日

已更改的问题：

• 问题 1458：功能请求：Google API v3 中的 KML 支持
• 问题 1658：添加路况叠加层
• 问题 2209：堆栈溢出
• 问题 2254：对 Circle 对象多次调用“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：map.setZoom(z) 在“maptypeid_changed”事件期间无法正常运行
• 问题 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 日

显著变化：

• 现在，当样式发生更改时，多边形会正确重新绘制。
• 使用旧版“路线”时，系统会通过 console.log 发出弃用警告消息。

2010 年 3 月 10 日

已更改的问题：

• 问题 1801：多段线/多边形 zIndex
• 问题 2144：DirectionsRequest 应提供 avoidHighways 选项
• 问题 2207： Bug：多段线在 IE 中被填充
• 问题 2113：1 月版本发布后，在 Firefox 中，多段线在高缩放级别下会断开

显著变化：

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

2010 年 3 月 3 日

已更改的问题：

• 问题 2136：混淆 google.maps.MarkerImage 中不应引用的属性

显著变化：

• 修复了地图跳跃问题。
• 改进了连续缩放两次的操作。
• 标记拖动事件 .latLng 不再经过混淆处理。

2010 年 2 月 26 日

已更改的问题：

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

显著变化：

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

2010 年 2 月 8 日

已更改的问题：

• 问题 2135： 错误：如果您在多段线中重复使用多边形的 MVCArray，则多段线会闭合。

显著变化：

• 添加了新的 Rectangle 类
• 添加了新的 Circle 类
• 修复了在创建然后移除标记时发生内存泄漏的问题。
• 停止对 LatLng 的 MVCArray 进行注释以闭合多边形，因为这会导致共享同一 MVCArray 的多段线也闭合（请参阅问题 2135）
• 修复了以下 bug：如果地图的缩放级别设置为当前值，有时会隐藏屏幕上的标记。
• 修复了 ImageMapType 在 Android 上无法正确显示的问题。
• 更改了多边形裁剪方案，以允许包含北极或南极的多边形。
• 将 MercatorProjection 的纬度范围增加到浮点精度允许的最大可能值。

2010 年 1 月 28 日

已更改的问题：

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

显著变化：

• 新增了对印度语系的支持：
• 孟加拉语、古吉拉特语、卡纳达语、马拉雅拉姆语、马拉地语、泰米尔语、泰卢固语
• 向事件命名空间添加了新的静态方法：
• 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：多边形无法在 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 日

显著变化：

• 修复了地图平移动画开始前出现的初始抖动。
• 修复了使用滚轮或双击缩放超过最大缩放级别时地图跳转到其他位置的问题。
• 版权、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：功能请求：提供一个用于信息窗口 DOM 就绪的事件
• 问题 1710：能够取消双击时的用户缩放事件

其他明显变化：

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

2009 年 10 月 15 日

已更改的问题：

• 问题 1525：在低缩放级别下出现 get_bounds 错误
• 问题 1757：fitBounds() 无法跨越 180 度子午线
• 问题 1790：map.setOptions 无法设置光标
• 问题 1767：事件传播存在问题

其他明显变化：

• 文档更新：
• 公开了新方法：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 上拖动时地图会跳动

其他明显变化：

• 推出了多段线和多边形！这些功能可让您在地图上绘制线条或填充区域、指定描边和填充样式，并支持大多数鼠标事件（即尚不支持鼠标悬停）。它们可在所有受支持的浏览器（IE6.0+、Firefox 2.0+、Safari 3.1+、Chrome）中运行，包括受支持的移动设备。
• 在开发者指南中新增了两个部分：多段线和多边形。
• 在 API 参考文档中新增了两个类：多段线和多边形。
• 添加了新的地图事件“idle”，该事件会在地图静止一段时间后触发。解决了问题 1371。
• 修复了点击事件返回不正确的 LatLng 值的问题。
• 修复了 iPhone 上的双指张合缩放 bug。请参阅问题 1723。

2009 年 9 月 10 日

已更改的问题：

• 问题 1659：在 Firefox 3.5 中，平移后点击和双击事件中报告的 latLng 不正确
• 问题 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：平移到世界地图的北边缘或南边缘之外会返回错误
• 问题 1643： Bug：地图不必要地滚动滚轮
• 问题 1379：在 V3 中看不到韩国地图数据

其他明显变化：

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

2009 年 8 月 24 日

已更改的问题：

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

其他明显变化：

• 默认启用滚轮缩放。如需停用此功能，请将地图选项的 scrollwheel 属性设置为 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。

文档变更：

• 添加了 Marker get_draggable 和 set_draggable 方法
• 添加了标记 drag、dragstart、dragend、draggable_changed 事件
• 已添加标记器可拖动属性
• 添加了信息窗口 get_zIndex 和 set_zIndex 方法
• 添加了信息窗口 zIndex_changed 事件
• 添加了信息窗口 zIndex 属性

2009 年 7 月 13 日

已更改的问题：

• 问题 1415：信息窗口内容：可选择 true/ false
• 问题 1432：调用 set_icon 后，Mouseout 事件不会触发
• 问题 1365：地图类型控件在严格的 doctype 下无法正确呈现

其他明显变化：

• 开发者不再需要为 MarkerImage 指定大小，如果未提供，API 会检测到。另外，MarkerImage 的 size、anchor 和 origin 参数都是可选的。
• 开发者不再需要在 OverlayView 子类的构造函数中调用 OverlayView.call(this)。
• 从接口中移除了 OverlayView“changed”方法。这应该不会影响开发者的代码，因为这些方法之前并未实际使用。
• partialmatch 选项已从 Geocoder Request 对象中移除。如果开发者继续传递该参数，它不会对查询产生任何影响。

2009 年 6 月 12 日

更改的问题：

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

其他明显变化：

• 在所有浏览器中，大缩放控件均可点击
• 信息窗口“避开”大型缩放控件，将自身完全定位在地图和控件内
• 移动版权使用精美图片
• 图块从中心（而非左上角）开始加载
• 用户无法再选择地图类型按钮的文本或任何控件图片
• 主库的大小缩减了约 1.9 KB