此页面由 Cloud Translation API 翻译。

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.55.1

2023 年 11 月 16 日

没有公开更改。

3.54.12a

2023 年 11 月 8 日

变更：

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

3.54.12

2023 年 11 月 2 日

变更：

[Alpha 渠道] 将地点自动补全功能更新为网络组件。这是一项重大变更。如需了解最新的使用信息，请参阅 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 版] 向 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 被一个不支持 iterable 的实现替换时，地图会被停用。
修复了在限制级别停用缩放按钮后失去焦点的问题。

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 版] 在 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 日

变更：

允许将节点元素传递给高级标记的 content 属性。
改进了高级标记冲突行为的性能。
在 JavaScript 历程共享中新增了一个用于 DeliveryVehicleStop 字段。

3.53.4a

2023 年 5 月 24 日

修复了一些 bug：

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

3.53.3

2023 年 5 月 18 日

变更：

[alpha 通道] 修复了以下 bug：使用箭头键选中某条联想查询，然后点击“Esc”时，地点自动补全元素无法恢复原始文本。
[Alpha 渠道] 更新了地点自动补全预测样式，以确保文本溢出时显示省略号。
[Beta 版] Local Context 现在会显示一条通知，显示 Local Context 地图上地点的相关情境信息即将停用。
修复了以下 bug：街景小人只有在至少已返回到基座一次后，才会显示悬停拖动预览。
废弃了地点自动补全服务的边界、位置和半径。请改用 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 displayNames 将使用最终用户所用的语言。
[Beta 版] AdvancedMarkerView 和 PinView 已重命名为 AdvancedMarkerElement 和 PinElement。
[Beta 渠道] 修复了 AdvancedMarkers 和 Pins 在不显式加载的情况下有时可用的问题。访问这些类前，请务必始终加载“标记”库。
[Beta 版渠道] AdvancedMarker position 现在已标准化为 LatLngAltitude。
[Beta 渠道] 停用高级标记 draggable 属性，改为使用 gmpDraggable。

3.52.9

2023 年 4 月 13 日

变更：

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

修复了一些 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 渠道] 地点自动补全 widget（新）实验性版本已发布。
在每周渠道中发布 JavaScript 历程分享功能。

3.52.5

2023 年 3 月 16 日

变更：

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

修复了一些 bug：

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

3.52.4

2023 年 3 月 9 日

变更：

[Beta 渠道] 禁止在拖动标记时触发高级标记的点击事件。

3.52.3

2023 年 3 月 2 日

变更：

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

修复了一些 bug：

修复了向地图添加标记或从中移除标记时可能发生的内存泄漏问题。
修复了导致交互式元素在触摸设备上可点击的高级标记下方时可点击的 bug。

3.52.2

2023 年 2 月 23 日

变更：

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

3.52.1

2023 年 2 月 16 日

变更：

添加了 importLibrary() 函数，该函数提供在运行时动态加载库的功能。
[测试版渠道] 在高级标记上打开信息窗口时，启用自动平移功能。
[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 的显示名称。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 等现代使用模式。地点类包含一些新的数据字段。
Beta 渠道：修复了在传递封装在代理中的地图时导致高级标记无法渲染的错误。
Beta 渠道：为 JavaScript 旅程分享功能添加了行程位置提供商标记自定义。

3.51.2

2022 年 12 月 1 日

变更：

Beta 渠道：google.maps.importLibrary() API 现已发布。
Beta 渠道：已弃用：Local Context 已被弃用，不再推荐用于新网站。此功能可继续正常使用；我们若计划停止支持，会提前 12 个月发出通知。如果您有兴趣自行打造类似于 Local Context 的体验，建议您在快速构建器中查看“Neighborhood Discovery”解决方案或使用 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 渠道：发布了地点库中的 Place 类。
Beta 渠道：为旅程分享添加了样式自定义功能。废弃了旧的设置方法。
Maps Embed API 中的 Internet Explorer 11 现已停用。
使用混合地图类型或卫星地图类型时，Maps Embed API 中的 Google 徽标会改变样式，以提高可见性
改进了高级标记加载性能。
让绘图的“撤消”按钮可供访问，且便于屏幕阅读器使用。
可让路线渲染程序的标记通过键盘访问，并便于屏幕阅读器使用。
向地图比例控件添加 ARIA 说明。
为地图的比例控件启用键盘焦点和互动。
向 Geocoder JS API 引入语言参数。如果未明确指定，Maps JS API 便不会再将 US 视为地理编码器中的默认区域。
向 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 上的信息窗口右下方内边距问题。

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 类以添加自定义属性。
修复了在地图倾斜后事件中出现错误的 LatLng 的 bug。

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 引入了语言和区域参数。
对于内容安全政策设置中不含 googleapis.com 域名的网站，移除了 Maps JavaScript API 街景中的支持。如需了解详情，请参阅内容安全政策指南。

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。
修复了 Embed API 中 RTL 语言路线悬停文本被截断的 bug。
让公交信息窗口更易于访问，也更便于使用屏幕阅读器。

3.49.9

2022 年 7 月 14 日

变更：

阐明了旅程分享位置信息提供程序中 ID 字段的用法。

3.49.8

2022 年 7 月 7 日

变更：

使用键盘访问街景导航链接，并让屏幕阅读器易于理解。
在 StreetViewPanorama 上引入了一个新的 focus 方法。

3.49 欧元

2022 年 6 月 23 日

变更：

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

修复了一些 bug：

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

3.49.5

2022 年 6 月 16 日

变更：

向街景添加了键盘快捷键控件和对话框，让键盘快捷键更易于发现。

修复了一些 bug：

修复了导致在关闭街景时提交表单的 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 仍可使用。
版本 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 类型、extern 和参考文档中。
函数 google.maps.event.addDomListener() 和 google.maps.event.addDomListenerOnce() 已弃用，不应继续使用。请改用标准的 addEventListener() 方法。这些方法将继续有效，并且我们不打算停用它们。
向街景标记图标添加了 title 和 aria-label。
为 Fullscreen 控件添加了 aria-pressed 属性。
改进了地图类型控件的下拉菜单间距。
更新地图类型下拉列表控件的 ARIA 标签。

修复了一些 bug：

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

3.48.8

2022 年 4 月 7 日

变更：

提高了 Maps JS API 和 Embed API Google 徽标的色彩对比度。

3.48.7a

2022 年 3 月 31 日

变更：

Beta 渠道：移除了已废弃的 WebGL Overlay View API。
为 Maps JavaScript API 客户启用更新后的基本地图。新版基本地图已在个人用户版 Google 地图上使用，它可提供更丰富、更详细的基本地图，尤其是在土地的自然地貌方面。

修复了一些 bug：

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

3.48.6

2022 年 3 月 24 日

变更：

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

3.48.5

2022 年 3 月 17 日

变更：

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

修复了一些 bug：

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

3.48.4

2022 年 3 月 10 日

变更：

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

3.48.3

2022 年 3 月 3 日

变更：

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

3.48.1

2022 年 2 月 17 日

变更：

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

3.48

2022 年 2 月 10 日

变更：

每周渠道更新至版本 3.48。
季度渠道已更新至版本 3.47。
如果需要，版本 3.46 和 3.45 仍可使用。

3.47.6

2022 年 1 月 20 日

修复了一些 bug：

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

3.47.4

2022 年 1 月 6 日

变更：

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 时，地图不再接收标签页焦点。
现在，当达到相应的最大或最小缩放级别时，“放大”和“缩小”按钮将被停用。
将 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：修复了某些文本项的色彩对比度。
修复了 extern 中 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 日

变更：

修复了地图不可拖动时地图光标会显示手的 bug。

3.46.5

2021 年 9 月 16 日

修复了一些 bug：

修复了地点自动补全 widget 中色彩对比度的 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 中的地图会在 Beta 渠道中显示横幅。
更新了嵌入式地图上的“查询路线”链接，以使其更加准确。

修复了一些 bug：

修复了 getFeatureById() 方法无法检索 ID 为 0 的地图项的问题。
修复了在 ComponentRestriction 值为未定义或为 null 时抛出 UNKNOWN ERROR/SERVICE BACKGROUND ERROR 的问题。

3.45.6a

2021 年 7 月 15 日

变更：

打开后，如果第一个可聚焦的控件不在信息窗口视口中或处于 disableAutoPan=true 状态，焦点现在会管理到 InfoWindow 容器。

修复了一些 bug：

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

3.45.5

2021 年 7 月 1 日

变更：

更新了输入和 JS API 中 Maps Studio 的网址。

修复了一些 bug：

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

3.45.4

2021 年 6 月 24 日

变更：

修复了导致在表单提交时打开键盘快捷键对话框的 bug。
修复了“键盘快捷键”按钮未对齐的 bug。
移除了意外添加到 window 的对象（Spherical、PolygonCodec、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 样式时出错的问题。
修复了在打开信息窗口的情况下平移地图时可能发生闪烁的 bug。

变更：

添加了 InfoWindowOpenOptions.map 属性。

3.45.1

2021 年 6 月 3 日

变更：

向 Data.StyleOptions 接口添加了有关动画、图标、标签和不透明度属性的文档。
重新设计了版权对话框，以更好地支持无障碍功能。
现在，信息窗口在打开后会自动管理焦点。这表示新的默认行为。
添加了 InfoWindowOpenOptions API，使开发者能够控制打开 InfoWindow 时焦点的管理方式。
现在按 ESC 键可关闭信息窗口。
现在，在使用屏幕阅读器时，信息窗口以“对话框”形式读出。
现已启用 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 日

变更：

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

3.44.4

2021 年 3 月 4 日

变更：

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

修复了一些 bug：

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

3.44.2

2021 年 2 月 25 日

变更：

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

3.44.1

2021 年 2 月 18 日

变更：

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

3.43.8a

2021 年 2 月 25 日

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

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

3.43.8

2021 年 2 月 5 日

变更：

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

修复了一些 bug：

修复了带有标签的 Markers 拦截点击事件（即使 clickable 设置为 false）的问题。

3.43.7a

2021 年 1 月 28 日

修复了一些 bug：

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

3.43.6

2021 年 1 月 21 日

修复了一些 bug：

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

3.43.5

2021 年 1 月 14 日

变更：

更改了菜单中的复选框，以便更易于通过屏幕阅读器使用。
增加了室内街景全景图片的 floors 按钮尺寸。
修复了移动动作跟踪控件在街景中的位置。

修复了一些 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 冲突问题。

3.43.2

2020 年 12 月 1 日

变更：

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

修复了一些 bug：

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

3.43.1a

2020 年 11 月 20 日

变更：

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

修复了一些 bug：

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

3.43

2020 年 11 月 18 日

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

每周渠道已更新至版本 3.43。
季度渠道已更新至版本 3.42。
若有编号的请求，版本 3.41 仍然可用。
版本 3.40 已被删除，不能再使用。

3.42.9

2020 年 10 月 15 日

变更：

修复了屏幕阅读器传达错误复选框状态的 bug。
修正了地图控件出现的问题，即 Tab/Shift+Tab 的顺序有误。
将地图按钮从 div 转换为了原生按钮，以改进无障碍功能。
现在，倾斜受到了限制，具体取决于 WebGL 地图的缩放级别。
修复了当 controlSize 小于 27 时，全屏按钮在 Internet Explorer 上部分消失的问题。

3.42.8

2020 年 10 月 7 日

变更：

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

支持更新后的地点图标

2020 年 10 月 1 日

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

3.42.7

2020 年 9 月 29 日

变更：

修复了“Report a map error”控件提示上的 RTL（从右到左）语言的文字顺序不正确的 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() 实现，控制台会记录一个错误。
添加了对海拔服务方法中的 Promise 的 Beta 版支持。
引入了新的 InfoWindow.minWidth 属性，用于指定 InfoWindow 的最小宽度。
修复了在更改目的地后路线变得模糊的 bug。

3.42

2020 年 8 月 19 日

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

变更：

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

每周渠道更新至版本 3.42。
季度渠道已更新至版本 3.41。
如有数字请求，版本 3.40 仍可使用。
版本 3.39 已被删除，不能再使用。

3.41.7

2020 年 7 月 22 日

已修复：

修复了使用 Cloud 样式设置时将 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 代码的支持。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 版本控制的指南。

变更：

新的 renderer 现在是默认渲染程序。
新的基本地图现在是默认地图。

3.32

2018 年 2 月 13 日

变更：

现已推出全新的实验性渲染程序。
一个全新的实验性基本地图现已推出。

3.31

2018 年 2 月 13 日

变更：

默认将前 256 个 Markers DOM 标记设为 Markers，后续将标记设为 Tile Markers。当前默认设置为所有图块标记。
在较高的缩放级别（放大）拖动街景小人时，首选 NEAREST，而不是 Google 选择的 BEST 全景图片。
现在，在 mousedown 处理程序内更改 gestureHandling: none 时，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：无法选择信息窗口内的文本

2017 年 1 月 10 日

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

2016 年 11 月 15 日

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

变更：

MapOptions 对象中新增了 gestureHandling 选项，可帮助您优化用户在移动设备上与地图互动时的体验。可用值包括：
- greedy：当用户滑动（拖动）屏幕时，地图始终平移（向上或向下、向左或向右）。换言之，单指滑动和双指滑动都会使地图平移。
- cooperative：用户必须单指滑动来滚动页面，双指滑动才能平移地图。如果用户用单指滑动地图，地图上会出现一个叠加层，并提示用户使用双指移动地图。您可以在移动设备上查看上面的示例，了解协作模式的实际应用。
- none：地图不可平移或双指张合。
- auto（默认值）：行为为 cooperative 或 greedy，具体取决于页面是否可滚动。
如需了解详情和查看示例，请参阅开发者指南。
全屏控件在移动设备上默认可见，因此用户可以轻松放大地图。当地图处于全屏模式时，用户可以使用单指或双指平移地图。注意：iOS 不支持全屏功能。因此，全屏控件在 iOS 设备上不可见。

已登录的地图已弃用

2016 年 10 月 6 日

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

在路线服务响应中更改 via 航点

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 地理开发者博客。
该 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 日

变更：

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

2015 年 12 月 2 日

变更：

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

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 的浏览器支持政策，请参阅 2014 年 8 月 7 日的 IEBlog 博文。

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、KMLLayer
修复了：问题 8098：bug：加权热图在一个点上无法正确呈现

2015 年 6 月 2 日

变更：

添加了对 placeId 进行地理编码到 address/latlng 的功能
通过 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：bug：当 radius 参数不是整数时，StreetViewService.getPanoramaByLocation 会失败

2015 年 3 月 25 日

已修复：

问题 7733：bug：KML 地面/图像 - 叠加层的分辨率突然超低
保存微件文本，让文本与星形图标更对齐

2015 年 3 月 17 日

已修复：

问题 7756：bug：Safari 8 性能降低
已移除受众特征图层
改进了信息窗口 Chrome

2015 年 2 月 17 日

当前的 Maps JavaScript API 实验版本 (3.19) 将成为发布版本。

版本 3.17 将被移除。针对 3.17 或任何先前版本的请求现在将使用 3.18 版。

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

延续后的可用版本：

实验性版本：3.20

版本：3.19

冻结：3.18

3.19

2015 年 4 月 24 日

已修复：

已登录模式下的光标。

2015 年 3 月 19 日

已修复：

问题 7756： bug：Safari 8 性能降低

2015 年 1 月 20 日

已修复：

问题 7475： bug：phantomjs TypeError：无法删除属性

2015 年 1 月 13 日

已修复：

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

2014 年 12 月 17 日

已修复：

问题 6917：bug：形状不遵循地图的“draggable”属性
问题 7445：bug：使用 v3 Maps API 的登录功能时出现出现的错误

2014 年 12 月 2 日

已修复：

问题 7390：错误：weather.com 超链接无效
问题 7376：bug：WebGL 已关闭（现已重新启用）
ES6 命名与符号冲突

2014 年 11 月 25 日

已修复：

问题 7333：bug：信息窗口的脱字符号在 IE9 中损坏

3.18

2014 年 12 月 4 日

已修复：

问题 7390：错误：weather.com 超链接无效

2014 年 9 月 18 日

已修复：

问题 7136：Firefox 中的多个标记标题不起作用

2014 年 9 月 9 日

已修复：

问题 7098：设置街景 POV 方向会抛出错误

2014 年 8 月 26 日

3.18 发布为实验性版本。

3.17 现已稳定。

3.17

2014 年 8 月 20 日

已修复：

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

2014 年 8 月 12 日

已修复：

问题 6968：bug：键盘箭头键在 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。
在 Roboto 完成加载后，InfoWindow 会自动调整大小（问题 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 已修复，在 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 日

已添加的功能：

将“disableDefaultUI”选项设置为 StreetViewPanoramaOptions

已修复：

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

3.12

2013 年 6 月 4 日

已修复：

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

2013 年 5 月 15 日

已添加的功能：

Google 地图外观刷新： https://developers.google.com/maps/documentation/javascript/basics#VisualRefresh

2013 年 4 月 29 日

已修复：

在 Android 浏览器和 Dolphin 浏览器上，已移除的标记会保留在地图上

3.11

2013 年 2 月 19 日

已修复：

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

2013 年 2 月 12 日

已修复：

您可以使用触控输入功能通过可拖动多边形来拖动不可拖动的多边形（问题 4868）
切换 travelMode 时，“路线备用”面板中的公交图标不正确（问题 4581）
在某些情况下，panTo(latLng) 并非始终将地图正好位于 latLng

2013 年 1 月 29 日

已添加的功能：

添加了 StreetViewCoverageLayer，用于以编程方式添加覆盖率图层
StreetViewPanoramas 的公开 StreetViewPov

已修复：

使用 3.8 版 Google Maps JavaScript 时内存用量增加会导致崩溃（在 IE 9、Chrome 等中观察到）（问题 4162）
在 Firefox 中，信息窗口中的下拉菜单（选择）菜单无法随地图平移

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 日

已添加的功能：

能够加载包含跨域属性集的图片

已修复：

在特写中显示带有远程图片标记的问题（问题 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 日

已修复：

使用 3.8 版 Google Maps JavaScript 时内存用量增加会导致崩溃（在 IE 9、Chrome 等中观察到）（问题 4162）

2012 年 9 月 25 日

已添加的功能：

室内街景
将 fixedRotation 选项设置为 IconSequence
“当前路况下所需时间”到路线

2012 年 9 月 11 日

新变化：

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

2012 年 8 月 28 日

已添加的功能：

将类型转换为 Places API textSearch

已修复：

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

2012 年 8 月 14 日

显著变更：

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

3.9

2012 年 9 月 10 日

已修复：

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

2012 年 8 月 9 日

已修复：

Android 3.x 上的语法错误

2012 年 7 月 31 日

显著变更：

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

已修复：

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

2012 年 7 月 25 日

已修复：

自动补全的组件限制（问题 4302）

2012 年 7 月 17 日

已修复：

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

显著变更：

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

10 2012 年 7 月

显著变更：

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

2012 年 6 月 27 日

已添加的功能：

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

从分页、评价、textSearch 到 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

新样式器选项“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）

已添加的功能：

街景中的点击即可/点击缩放（问题 2447）

显著变更：

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

2012 年 3 月 6 日

已修复：

快速放大时 OverviewMapControl 出错（问题 3882）
从页面中移除地图 div 时出现 IE 错误（问题 3971）
缩放后的标记在版本低于 9 的 IE 上无法正确呈现（问题 3912、问题 3908）

已添加的功能：

opacity to GroundOverlay（问题 2767）
将 utc_offset 和 open_hours 转换为 PlaceResult（问题 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）
同时打开信息窗口并设置缩放级别会导致地图中心不正确（问题 3738）
拖动标记时忽略右键点击（问题 3237）
Firefox 上有时不显示标记标题（问题 3773）

显著变更：

缩放的标记现在会在 Canvas 中渲染（如有）

添加了：

适用于 ImageMapType 的 setOpacity()（问题 3125）
适用于 GroundOverlay 的 setOpacity()（问题 2767）
ImageMapType 的“tiles 已加载”事件（问题 1744）
stop() 传递给 MouseEvent，这会停止事件传播（问题 2172）

2012 年 1 月 31 日

已修复：

修复了：平移地球后显示的韩国图块不正确（问题 2722）
修复了：无法准确放置街景小人以显示街景（问题 3861）
为多边形添加了“visible”属性（问题 2861）
即使视口之间距离很远，panTo 和 panBy 也会添加动画效果（回归）

2012 年 1 月 24 日

已修复：

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

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 日

已修复：

信息窗口内容大小现在在计算时将级联样式考虑在内
航拍地图旋转控件与创建地图时的方向不一致

2011 年 11 月 7 日

显著变更：

默认控件的新外观样式
可修改的形状（多边形、多段线、圆形、矩形）
新增了 DrawingManager，用于添加新叠加层
新增了 PlaceResult 字段：website 和 international_phone_number
新的 ElevationResult 字段：Resolution

已修复：

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

3.6

2011 年 10 月 31 日

已修复：

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

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 中出现内存泄漏
航向视图为 90 度或 270 度的航拍视图的标记渲染

显著变更：

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

2011 年 9 月 12 日

解决的问题：

在 Firefox 4 及更高版本上显示提示后，标记卡在凸起的位置（问题 3334）

显著变更：

GeocoderResult.formatted_address 未记录

2011 年 9 月 6 日

已修复：

Firefox 中的“选择元素（下拉菜单）”信息窗口不随地图平移
部分移动设备上的韩国卡片

2011 年 8 月 29 日

显著变更：

允许自定义控件具有高于 API 控件的 Z-index 值
链接可将用户引导至 maps.google.com 的正确语言版本
如果没有信息窗口 html、名称或说明，请勿在 KML 地图项上打开 InfoWindow。
修复了回归问题：高 DPI 图块损坏

2011 年 8 月 24 日

解决的问题：

针对 Chrome/Mac 停用了硬件加速：修复了标记渲染问题和叠加层点击问题（问题 3544、问题 3551）
针对 Android，修复了页面滚动后双指张合缩放功能（问题 3373）

显著变更：

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

2011 年 8 月 17 日

显著变更：

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

3.5

2011 年 8 月 10 日

已修复：

在街景中拖动到地平线时标记卡在向上拖动位置
调整地图或窗口大小时，街景大小未调整
包含共享信息窗口的街景导致浏览器崩溃

2011 年 8 月 2 日

解决的问题：

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

显著变更：

大多数控件的上下文菜单现在会在右键点击时停用。
将鼠标悬停在信息窗口上时，信息窗口内的街景全景图片/地图不会平移
现在可以在 iPad 上滚动信息窗口

2011 年 7 月 18 日

解决的问题：

当页面在 iOS 4.1 以上版本上滚动时，事件 LatLng 不正确（问题 3373）

2011 年 7 月 11 日

解决的问题：

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

显著变更：

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

2011 年 7 月 5 日

解决的问题：

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

显著变更：

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

2011 年 6 月 30 日

解决的问题：

已修复：初始地图图块将被重复提取
修复了：在 3.4 之后创建地图时多次触发 maptypeid_changed 事件（问题 3051）

显著变更：

地点自动补全功能已更改为附加到正文，而不是输入父项
BOTTOM_RIGHT 现在可正确放置

2011 年 6 月 8 日

解决的问题：

已修复：当缩放级别的变化幅度大于 2 时，缩放不再具有动画效果（问题 3033）

显著变更：

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

2011 年 5 月 17 日

解决的问题：

修复了：IE7 中的街景渲染问题（问题 3272）

显著变更：

加载和更改地图类型时，为地图图块启用了淡出过渡。

2011 年 5 月 7 日

没有明显的变化。

3.4

2011 年 5 月 7 日

没有明显的变化。

2011 年 5 月 6 日

解决的问题：

修复了：IE7 中不显示街景全景图片（问题 3272）
已修复：使用 ImageMapType 的半透明 PNG 在 IE7 和 IE8 中会丢失透明度（问题 3275）

显著变更：

距离矩阵服务

2011 年 4 月 14 日

解决的问题：

修复了以下问题：为 poly strokeColor 和 fillColor 支持已命名的 CSS 颜色
修复了：当 strokeOpacity 设置为 0.0 时，多边形不可见（问题 3241）
已修复：在 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 后将地图类型添加到注册表，自定样式的地图不会使用样式
已修正：非样式化地图类型会采用自定样式的地图类型
标记现在会触发 MouseEvents，而不是 DOM 事件

2011 年 3 月 11 日

解决的问题：

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

显著变更：

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

2011 年 3 月 2 日

显著变更：

现在，标记会在画布/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 中未触发 rightclick 事件（问题 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 日

解决的问题：

在可拖动方向上修复了 Waypoint 点击处理程序（问题 2871）

2010 年 12 月 21 日

解决的问题：

添加了在拖动时向地图添加的动量（问题 2592）
修复了街景中的 CSS 错误（问题 2666）
修复了在 IE 中显示地图宽度为 0 的信息窗口时出现的 JS 错误（问题 2536）

显著变更：

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

2010 年 12 月 9 日

解决的问题：

信息窗口现在可在 IE 中正常打印（问题 1343）
修复了 IE8 中 ImageMapType 的不透明度

显著变更：

拖动时，会在带有自定义图标的标记下方显示一个叉号，并且已启用 letOnDrag

2010 年 12 月 5 日

解决的问题：

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

显著变更：

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

2010 年 11 月 28 日

解决的问题：

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

显著变更：

现在无需启用背景图片打印功能即可打印地图
修复了在“draggable”设置为 false 时可拖动路线标记可拖动的 bug

2010 年 11 月 16 日

已更改的问题：

问题 2076：提供一种向 DirectionsRenderer 提供信息窗口的方式（问题 2076）
问题 2524：实现 streetViewControlOptions
问题 2557：为街景添加了“停用缩放功能”

显著变更：

修复了导致在用户点击标记时在 FF 中打开新窗口的 bug。
使用 DirectionsRenderer 指定标记选项时，字母标记图标会丢失

3.2

2010 年 11 月 11 日

显著变更：

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

2010 年 10 月 11 日

已更改的问题：

问题 2478：街景 - 某些浏览器中罗盘未对齐/缺失
问题 2528：IE8 中的 ImageMapTypeOptions 不透明度被破坏
问题 2661：信息窗口 - 在输入字段中点击鼠标右键不显示上下文菜单
问题 2741：地图平移后的 iOS 4 上无法正常放置标记

显著变更：

街景默认处于启用状态
修复了“此内容”未传递给 .getTileUrl 的 bug
信息窗口 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：在浏览器刷新 / 取消加载 (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：对附加了监听器的全景对象调用 setVisible(false) 会导致 IE 中出现 JS 错误

显著变更：

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

2010 年 7 月 29 日

已更改的问题：

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

显著变更：

自定义全景图片“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 会生成警告

显著变更：

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

2010 年 6 月 17 日

已更改的问题：

问题 2346：用于停用平滑动画的选项

显著变更：

修复了标记闪烁问题
改进了 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：对 Circle 对象多次调用“setMap(gMap)”和“setMap(null)”会更改它的描边和填充不透明度

显著变更：

添加了 KML 图层和 GeoRSS 图层
添加了地面叠加层
添加了新图层：路况和骑车
针对 DirectionsRendererOptions 添加了“preventBicyclingLayer”属性
修复了 bug，以确保在 MapType 发生变化时正确引用缩放图层
DirectionsResult 属性“start/end_point”已重命名为“start/end_location”
已将 DirectionsLeg 属性“start/end_Geocoding”重命名为“start/end_address”
将 DirectionsRoute 的“Optimized_航点_order”属性重命名为“航点_order”
移除了对旧路线属性名称（setTripIndex、getTripIndex、HideTripList、provideTripAlternatives）的支持，并且会继续记录警告。还会移除从路程到路程的路线和从行程到路段的路线的转换。
已将 GeocoderGeometry.latLng 更新为 GeocoderGeometry.location

2010 年 4 月 30 日

已更改的问题：

问题 2230：在没有预期的自定义投影的情况下进行地图初始化

显著变更：

现在，点击地图可聚焦于键盘
现在支持在 iPad 上使用双指张合缩放功能

2010 年 4 月 26 日

已更改的问题：

问题 1826：在多边形和多段线上添加鼠标悬停和鼠标移开事件
问题 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 日

显著变更：

海拔现已在 API 中公开，
改进了针对慢速互联网连接的图块加载。

2010 年 3 月 15 日

显著变更：

现在，更改样式时，多边形可以正确重新绘制。
使用旧样式的“Directions”时，console.log 会显示已弃用的警告消息。

2010 年 3 月 10 日

已更改的问题：

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

显著变更：

添加了骑车路线！
添加了新的 DirectionsRequest 选项：

avoidHighways
avoidTolls
optimizeWaypoints

提高了多边形/多段线的渲染速度
重命名了以下 Directions 对象。旧名称仍受支持。

到 DirectionsLeg 的 DirectionsRoute
前往 DirectionsRoute 的 DirectionsTrip

2010 年 3 月 3 日

已更改的问题：

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

显著变更：

修复了地图跳跃错误。
改进了连续缩放两次的功能。
不再对标记拖动事件 .latLng 进行混淆处理。

2010 年 2 月 26 日

已更改的问题：

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

显著变更：

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

2010 年 2 月 8 日

已更改的问题：

问题 2135：bug：如果您在多段线上重复使用多边形的 MVCArray，该多段线会关闭。

显著变更：

添加了新的 Rectangle 类
添加了新的 Circle 类
修复了在创建和移除标记时出现的内存泄露问题。
停止为 LatLng 的 MVCArray 添加注解以闭合多边形，因为这会导致共享同一 MVCArray 的多段线也关闭（请参阅问题 2135）
修复了在地图的缩放级别设置为当前值时有时会隐藏屏幕上的标记的错误。
修复了 ImageMapType，以便在 Android 上正确显示。
更改了多边形裁剪方案，以允许包含北极或南极的多边形。
已在浮点精度要求的情况下，将墨卡托投影法的纬度范围扩大到尽可能高。

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 中的平移问题
修复了 iPhone 上的双指张合缩放问题

2010 年 1 月 19 日

已更改的问题：

问题 1422：功能请求：允许开发者创建自定义地图类型
问题 1523：功能请求：fromContainerPixelToLatLng（反之亦然）
问题 1443：extended() 和 union() 应返回 LatLngBounds 对象
问题 1960：bug：使用 provideTripAlternatives 的信息不完整
问题 1675：教程文档错误
问题 1676：教程文档错误 - 控件选项
问题 1856：多边形在 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 日

显著变更：

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

2009 年 12 月 10 日

已更改的问题：

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

其他显著变更：

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

2009 年 11 月 25 日

已更改的问题：

问题 1696：功能请求：地图控件放置位置
问题 1909：地图中心更改后 getBounds 损坏
问题 1938：map.setOptions 无法识别控件选项

其他显著变更：

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

2009 年 11 月 11 日

已更改的问题：

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

其他显著变更：

新增了对三种新语言的支持。

巴斯克语
加利西亚语
塔加路语

2009 年 10 月 29 日

已更改的问题：

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

其他显著变更：

通过 DirectionsRenderer 和 DirectionsService 更新了参考文档

2009 年 10 月 26 日

已更改的问题：

问题 1647：功能请求：提供信息窗口 dom 就绪事件
问题 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 日

改进了 Poly 的渲染性能。
修复了 SVGView 的 JS 警告问题。

2009 年 9 月 22 日

已更改的问题：

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

其他显著变更：

发布了多段线和多边形！您可以使用这两个 API 在地图上绘制线条或填充区域，指定描边和填充样式，并支持大多数鼠标事件（即尚未实现鼠标悬停）。它们适用于所有受支持的浏览器（IE6.0+、Firefox 2.0+、Safari 3.1+ 和 Chrome），包括受支持的移动设备。

在开发者指南中添加了两个关于多段线和多边形的部分。
在多段线和多边形的 API 参考文档中添加了两个新类。

添加了新的地图事件“idle”，该事件会在地图没有一点移动时触发。解决了问题 1371。
修复了从点击事件返回的错误的 LatLng 值。
修复了 iPhone 上的双指张合缩放问题。请参阅问题 1723。

2009 年 9 月 10 日

已更改的问题：

问题 1659：平移后，点击和 dblclick 事件中报告了错误的 latLng（Firefox 3.5）
问题 1621：使用 dooctype 在 ie8 中点击地图后获取错误位置
问题 1642：InfoWindow overflow:auto
问题 1531：infoWindow 的高度会随着每次打开而增大

其他显著变更：

修改了 get/set 方法和事件名称的语法，具体如下所示。旧语法仍受支持，以保持向后兼容性。例如：

set_funBoat() => setFunBoat()
get_funBoat() => getFunBoat()
funBoat_changed => funbow_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：平移地图函数 + 动画

其他显著变更：

默认启用了滚轮缩放。如需停用该工具，请将地图选项的滚动轮属性设置为 false。
更新了文档，添加了 panTo 和 panBy 函数。

2009 年 8 月 14 日

已更改的问题：

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

其他显著变更：

已启用滚轮缩放。
修复了影响 iPhone 中地图在拖动后发生跳跃的问题。

2009 年 8 月 4 日

已更改的问题：

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

其他显著变更：

在 iPhone 上双指张合和拖动操作应该会更稳健。
为 InfoWindow 对象添加了 zIndex setter 和 getter。

文档变更：

添加了标记 get_draggable 和 set_draggable 方法
已添加标记拖动、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 时对其进行检测。另一方面，MarkerImage 的大小、锚点和 origin 参数都是可选的。
开发者不再需要在 OverlayView 子类的构造函数中调用 OverlayView.call(this)。
从界面中移除了 OverlayView“已更改”方法。这应该不会影响开发者的代码，因为这些方法之前实际上并未使用过。
从地理编码器请求对象中移除了 partialmatch 选项。如果开发者继续传递它，它对查询没有任何影响。

2009 年 6 月 12 日

已更改的问题：

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

其他显著变更：

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