Maps JavaScript API 版本说明

订阅这些发行说明。 订阅

Maps JavaScript API 团队会定期更新 API,以加入新功能、修复 bug 并提升性能。您可以通过在 Maps JavaScript API 引导请求的 v 参数中指定要在您的应用程序中加载的 API 版本来指示它。了解更多版本控制

此变更日志按日期和版本号列出发布版本,以及相关的更改。

要接收有关新 Maps API 版本的更新,请订阅 google-maps-js-api-v3-notify 组。

3.66.3d

2026 年 9 月 2 日

变更:

  • [alpha 通道] 将trafficPolylinesDisabled字段添加到RoutePolyline3DOptions。这样,开发者就可以在创建 3D 路径折线时禁用交通感知折线。
  • [alpha 通道] 优化 Route3DElement,避免在切换 trafficPolylinesDisabled 时产生不必要的后端请求。

3.66.2d

2026 年 8 月 26 日

变更:

  • [alpha 通道] 从字体加载中移除 Route 3D 图标,并将它们移至嵌入式 SVG 资源中,以避免多次加载 Material Symbols 字体时出现问题。
  • [beta 通道] 新增 Places UI Kit 高级组件:AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement, PlaceLinkElement, PlaceButtonElement, PlaceNameElement, AdvancedPlaceListElement, AdvancedPlaceSearchElement
  • 为公交线路名称添加了工具提示,以便即使名称被截断也能看到完整名称。
  • 为自定义 Web 组件添加了 removeEventListener 类型定义。
  • 修复了 VoiceOver 在屏幕阅读器中显示路线标记等视觉上隐藏元素的焦点轮廓的问题。

3.66.1a

2026 年 8 月 17 日

变更:

  • 通过添加备用标签和移除冗余的键盘焦点停止点,修复了静态席位卡图像的辅助功能行为。

3.65.12f

2026 年 8 月 6 日

变更:

  • [alpha 通道] 向 3D Maps JS API 的 alpha 通道添加 <gmp-label-3d> (google.maps.maps3d.Label3DElement)。现在开发者可以使用新元素来声明标签文本,并独立配置其碰撞行为,使其与链接的 3D 标记元素(例如 <gmp-marker-3d><gmp-marker-3d-interactive>)分开。
  • 为“地点详情”组件中的“更多选项”按钮提供独特的易用名称。
  • [alpha 通道] 改进了在 alpha/beta 通道之外使用TravelMode.TWO_WHEELER时 Route 3D 旅行模式的错误信息
  • [alpha 通道] Route3D 组件现在支持 trafficPolylinesDisabled 属性。这样,开发者可以在使用 TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL 路由选项时禁用交通感知折线。
  • [alpha 通道] AutofitsCamera 北边界填充增加,以防止默认图钉裁剪。
  • 修复了在触摸屏设备上无法将街景小人拖到地图上的问题。

3.65.11b

2026 年 7 月 27 日

变更:

  • [alpha 通道] 增强 Route3D 弹出窗口,显示非公共交通图标(自行车、汽车、两轮车和步行)。
  • [alpha 通道] Route.createWaypointMarkers 为起点和终点创建标记,除非指定 customOverride 函数,否则应用默认样式。目前不支持中间航点。

3.65.10a

2026 年 7 月 22 日

变更:

  • 修复了 Maps JS 加载 Material Symbols Outlined 字体时可能会影响基础页面上加载的相同字体的问题。
  • 修复了以下问题:当使用 options.value 初始化或通过 value 属性以编程方式修改 PlaceAutocompleteElement 时,该属性会在表单 POST 中提交空值。
  • 更新了 3D 地图倾斜和航向 UI 控件,以便在增加相机限制范围时重新启用。

3.65.8c(已回滚)

2026 年 7 月 7 日

变更:

  • [alpha 通道] Route3DElement 为公交线路渲染额外的折线和弹出框数据。
  • 地址验证 API 添加了对 internalUsageAttributionIds 的支持。此属性允许将 API 调用归因于特定的软件包或开源软件库。
  • 更新了 2D 地图上 POI 点击的默认信息窗口,使其使用地点小部件。
  • 提高了高流量条件下街景全景的可靠性。

3.65.6a

2026 年 6 月 25 日

变更:

  • [beta 通道] 更新了 2D 地图上 POI 点击的默认信息窗口,使其使用地点小部件。
  • 修复了 3D 地图在 fov 值极端时偶尔会抛出错误的 bug。
  • 更新默认路由标记,不再使用已弃用的 glyph PinElement 选项。

3.65.5e

2026 年 6 月 17 日

变更:

  • 已修复 OverlayView.getMap() 的类型定义
  • 更新了 BasicPlaceAutocompleteElementPlaceAutocompleteElement 的类型定义,以表明构造函数选项参数是可选的。

3.65.3b

2026 年 6 月 4 日

变更:

  • Maps JavaScript API 中的 DrawingManager 功能已不再可用。有关更多信息,请参阅https://developers.google.com/maps/deprecations
  • 提高了地图版权对话框在深色模式下的颜色对比度。
  • 当航向达到极限时,禁用 3D 地图旋转控制。
  • 修复了“地点自动完成”移动输入字段与 iOS 系统状态栏/安全区域重叠的问题。注意:当视口元标记中设置 viewport-fit=cover 时,此修复方法有效。
  • 为 Maps 3D JavaScript API 添加了对 internalUsageAttributionIds 的支持。借助此属性,开发者可以将 API 调用归因于特定软件包或 OSS 库。
  • 为 Places(新版)API 添加了对 internalUsageAttributionIds 的支持。借助此属性,开发者可以将 API 调用归因于特定软件包或 OSS 库。
  • [alpha 通道] 缩小了 Route3DElement 属性的 getter 类型范围,以匹配 setter 规范化。
  • [alpha 通道] Route3DElement 公开 routes、fallbackInfo 和 geocodingResults 属性。

3.65.2d

2026 年 5 月 27 日

变更:

  • 修复了在地图边界受限的情况下缩小地图时缩放按钮出现的问题。
  • 地点库已为地点引入 transitStation
  • 在 Routes 库中添加了对 internalUsageAttributionIds 的支持。借助此属性,开发者可以将 API 调用归因于特定软件包或 OSS 库。

3.65.1c

2026 年 5 月 20 日

变更:

  • 现在,无论是否提供地图 ID 或自定义样式,浅色模式下路线图和地形的 Google 徽标都将显示为白色背景上的深灰色。
  • [alpha 通道] Route3DElement 分别在成功和错误调用 Routes API 后分发 gmp-load 和 gmp-error 事件。
  • 修复了文档中关于自动完成预测的辅助文本中会突出显示匹配项的错误说明。匹配项仅在正文中突出显示,反映了 Places API 自动完成功能的行为。
  • 改进了地点自动完成预测项的颜色继承,使其能够优雅地继承父元素上设置的颜色。
  • 为 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 添加了“input-icon”和“clear-icon”插槽,用于自定义图标。
  • 为 BasicPlaceAutocomplete 和 PlaceAutocomplete 预测项公开 prediction-item-secondary-textprediction-item-nonmatch 阴影部分,从而可以为未匹配的主文本和辅助文本设置自定义样式。
  • 为 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 添加 no-clear-button 属性和 noClearButton 属性,以允许隐藏清除按钮。
  • Maps JavaScript API 中的热图图层功能现已停用。
  • 改进了地图配置检索中的错误处理。
  • 45 度图像现已不再用于栅格地图。
  • 在 PlacesLibrary 文档中添加了缺失的类。还记录了 FormattableText 上的 toString() 方法。
  • 改进了“报告地图错误”链接的易用性。

3.64.12d

2026 年 5 月 6 日

变更:

  • LatLngequals() 方法现在接受 LatLngLiteral 对象,而不是抛出错误。LatLngLatLngAltitude equals() 的文档现在也准确地反映了现有的容差水平为 1e-9。
  • [alpha 版] 具有自动调整大小子项的 Map3DElement 现在最初以 RELATIVE_TO_GROUND 海拔模式渲染,该模式支持在加载时显示较高海拔区域,适用于相机属性是预定义而非使用 flyCameraTo 应用的情况。此外,在 Map3DElement 的初始加载时,如果地图具有使用 AutofitsCamera API 且仍在工作的子级,则初始地图渲染会延迟,直到所有子级都完成工作,并且无论飞行动画设置如何,相机都会快速移动;后续的相机更新会遵循飞行动画设置。
  • [Alpha 版] Polygon3DElement 添加了 autofitsCamera 属性,以支持自动调整相机。

3.64.11d

2026 年 4 月 29 日

变更:

  • [Alpha 版] MarkerElement 添加了 autofitsCamera 属性,以支持自动调整相机以适应标记。
  • 修复了 PlaceAutocompleteElement 中预测项图标无法在 Safari 浏览器中呈现的问题。
  • Places 库已为地点引入 isPureServiceAreaBusiness。现在,您可以在地点自动补全(数据 API 和 widget)和文本搜索请求中设置 pureServiceAreaBusinessesIncluded,以请求纯服务区域企业的搜索结果。
  • 地点库已为地点引入 addressDescriptorcontainingPlacestimeZone
  • Places 库已为地点引入 futureOpeningDate。现在,您可以在地点自动补全(数据 API 和 widget)、附近搜索和文本搜索请求中设置 futureOpeningBusinessesIncluded,以请求尚未开业的商家的结果。
  • 现在,无论有无地图 ID 或自定义样式,路线图浅色样式的 Google 徽标都将保持一致。之前,我们针对所有使用地图 ID 的路线图地图显示深色模式 Google 徽标。如需保留白色 Google 徽标,用户应切换到深色模式。
  • 在 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 中添加了 focus-ring 作为 CSS 阴影部分。
  • 添加了新的 FuelTypeDIESEL_PLUSE100。添加了新的 EVConnectorType NACS
  • 为 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 添加了 value、placeholder、disabled、readonly、no-input-icon 和 maxlength 属性。
  • 为 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 添加了“description”属性,以便为屏幕阅读器用户提供更多背景信息。
  • 缩小了 LatLngAltitudeLiteral.altitude 的声明类型,以不允许使用 null 或 undefined。更正了 DirectionalLocation.toJSON() 的声明返回值类型。

3.64.9c

2026 年 4 月 14 日

变更:

  • TypeScript 声明现在可以正确区分属性 getter 和 setter 的类型(包括没有 setter 的只读属性)。

3.64.8b

2026 年 4 月 8 日

变更:

  • [alpha 渠道] 如果 Route3DElement、Marker3DElement 和 Polyline3DElement 具有 autofitsCamera 属性,则在从 DOM 中移除时不会导致相机更新。对于 Route3DElement,错误或空响应对摄像头没有影响。此外,如果将给定元素的 autofitsCamera 从 true 更改为 false,系统不会更新相机以排除该元素,但会使该元素不再参与未来的相机更新。
  • AdvancedMarkerElementzIndex 现在由其显式设置的值或默认的垂直像素位置确定。显式值优先于默认值。为避免屏幕上没有 zIndex 的较低标记意外与有 zIndex 的标记重叠,我们建议在所有标记中始终应用 zIndex
  • TypeScript 声明现在包含一个将 HTML 标记名称映射到 JS 类(google.maps.HTMLElementTagNameMap 和全局 HTMLElementTagNameMap)的接口、一个将 HTML 标记名称映射到每个 JS 类的 EventMap(google.maps.HTMLElementEventMapTagNameMap)的接口、一个包含所有自定义 CSS 属性的接口 (google.maps.CSSProperties),并且每个基于字符串的枚举都有一个定义的字符串联合类型(如 ${EnumName}String),该字符串联合类型用于整个声明中的相应枚举。addEventListener() 也会在每个自定义元素上重载,并带有其 EventMap 类型,而 google.maps.importLibrary() 会重载,以便为传入的库名称正确设置每个返回库的类型。

3.64.7d

2026 年 4 月 1 日

变更:

  • 现在,mapId 属性可以在 Map3DElement 初始化后动态更新,无需重新实例化 Map3DElement
  • [alpha 渠道] 新增了用于在 3D 地图上渲染路线的 Route3DElement
  • [Alpha 版渠道] 添加了新的 Route.create3DPolylines()Route.createPopover() API。
  • [Alpha 版渠道] 添加了新的 spherical.traversePath() API。
  • [Alpha 版渠道] 为 Marker3DElementPolyline3DElementRoute3DElement 添加了新的 autofitsCamera API,并为 Map3DElement 添加了新的 autofitsCameraAnimation API。
  • [alpha 渠道] 新增了用于渲染带 Polygon3DElement 的圆圈的 CirclePathElement
  • [alpha 渠道] alpha 渠道中的 3D 地图现已推出新的 ROADMAP 地图模式。
  • 修复了以下 bug:在附加到 DOM 元素(该元素是在与 Maps JS 库代码不同的框架上下文中创建的)的地图中,StreetView Pegman 在移动设备上无法正常运行。

3.64.6d

2026 年 3 月 26 日

变更:

  • 修复了以下问题:如果没有突出显示任何预测结果,按 Enter 键不会提交地点自动补全元素的包含表单。
  • 修复了导致 FlattenerElement 无法在 3D 地图上绘制的竞态条件。
  • 修复了以下 bug:当地图附加到在与 Maps JS 库代码不同的 iframe 上下文中创建的 DOM 元素时,移动设备上的触控处理无法正常运行。

3.64.5d

2026 年 3 月 18 日

变更:

  • weekly 频道现在推出了几项 3D 地图更新,包括新的 MarkerElementFlattenerElement。此外,我们还添加了 cameraPositionfov 属性,以及对 flyCameraToflyCameraAround 方法的 altitudeMode 支持。
  • Places 库为已识别的地点引入了 currentOpeningHoursregularSecondaryOpeningHourscurrentSecondaryOpeningHourscurrentOpeningHours 提供接下来一周的营业时间,包括节假日等特殊时间。次要营业时间与场所的主要营业时间不同,指的是场所的免下车取餐、取餐或外卖等服务的营业时间。
  • 修复了 3D 地图中地图移动后,有时 Google 地图链接无法正确更新的问题。

3.64.4d

2026 年 3 月 12 日

变更:

  • 同步 InfoWindow 映射属性以在位置更改时修复导致不必要的控制台警告的问题。
  • 修复了程序化购买的问题fovMap3DElement 的更新偶尔会停止。
  • Map3DElement 上的 flyCameraAround 方法现在接受 Number.Infinity 作为 repeatCount 参数,从而实现无限动画。

3.64.3a

2026 年 3 月 2 日

变更:

  • Maps Embed API 现在使用 Places UI Kit 来显示地点详情。
  • [beta 频道] cameraPosition先前介绍过的房产Map3DElement3.64.2 版本现在也支持了flyCameraTo目标。如需了解详情,请参阅 Maps JavaScript 中的 3D 地图

3.64.2b

2026 年 2 月 26 日

变更:

  • google.maps.DirectionsServicegoogle.maps.DirectionsRenderergoogle.maps.DistanceMatrixService 将于 2026 年 2 月 25 日弃用。目前暂无计划停止服务,并将继续修复任何重大回归错误。服务停用前,我们将至少提前 12 个月发出通知。有关更多详细信息(包括更新的、推荐的替代方案),请参阅 legacy
  • [beta 通道] 引入了新的 MarkerElement,允许您在 3D 地图上的标记中显示自定义 HTML 内容。此外,新的 FlattenerElement 现在可以展平特定区域的 3D 网格。
  • [beta 通道] Map3DElement 已更新为 fovcameraPosition 属性,而 flyCameraToflyCameraAround 方法现在支持 altitudeMode。如需了解详情,请参阅 Maps JavaScript 中的 3D 地图
  • 修复了使用 document.createElement('gmp-pin') 创建 PinElement 时抛出 NotSupportedError 的错误。

3.64.1c

2026 年 2 月 19 日

变更:

  • AdvancedMarkerElement 调整大小时更新碰撞信息。

3.63.14d

2026 年 2 月 5 日

变更:

  • Places 库引入了在请求数据时识别地点的新选项。除了使用 id 之外,现在还可以指定 resourceName 来初始化 Place 对象。
  • Places 库已为已识别的地点引入了 subDestinations。这些 subDestinations 为在机场、国家公园、大学或体育场等大型或复杂场所内搜索的用户提供更具体的目的地。
  • 修复了 Map3D 在 JS 中设置 center 属性时需要指定海拔高度的问题(现在默认为 0)。
  • 来自 PlaceDetailsElementPlaceDetailsCompactElement 的 Place 对象现在包含一个 googleMapsLinks 属性,该属性提供 网址,以便深度链接到 Google 地图以执行各种操作。这包括用于查看地点、获取路线、查看照片、阅读现有评论和撰写新评论的 URI。

3.63.13

2026 年 1 月 29 日

变更:

  • Maps Embed API 在将鼠标光标悬停在兴趣点 (POI) 上时不再显示悬停卡片。
  • 为配置错误的 Places UI Kit(地点详情 + 地点搜索)元素添加控制台警告
  • PlaceDetailsElement 现在会在有 AI 生成的地点摘要时显示该摘要。
  • PlaceDetailsElement 现在提供 AI 生成的评论摘要。

3.63.10a

2026 年 1 月 13 日

变更:

  • 修复了阻止在弹出窗口中滚动和点击手势的问题。
  • 现在可以通过 Places API 使用 resourceNameshortFormattedAddress 字段

3.63.9d

2026 年 1 月 8 日

变更:

  • PlaceSearchElement 在照片加载时,非照片内容的显示速度会略快一些。Places UI Kit 对照片淡入动画进行了改进。
  • 提高在倾斜地图上渲染折线时的性能。
  • 修复了在某些条件下通过编程方式设置时 3D 地图相机无法更新的错误。
  • 略微提升了加载 PlaceDetailsElementPlaceSearchElement 的照片时的性能。
  • MapOptions 中明确了 draggable 属性的行为,以便更好地说明用户互动限制。
  • 在地址验证库中针对 possibleNextAction 强制执行 Beta 版渠道访问权限
  • PlaceAutocompleteElement 添加 placeholder 属性和 HTML 属性支持
  • PlaceAutocompleteElement 现在支持对更多标准 CSS 字体属性进行自定义,包括:字体、字号、字体系列、字重、行高、字样式和颜色。默认字体大小现在变为 16px。
  • PlaceAutocompleteElement 添加 value 属性和 HTML 属性支持
  • 优化 Places UI Kit 中的图像加载。
  • 已将 CSS 部分 input 添加到 PlaceAutocompleteElement

3.63.5d

2025 年 12 月 11 日

变更:

  • 在 Maps JavaScript API 中推出地址验证 API
  • mapTypeId 设置为 null 或 undefined 时,现在默认为 MapTypeId.ROADMAP,修复了可能导致地图图块无法加载的问题。
  • 如果相应地点无法评分,则在 PlaceDetailsElement 中隐藏评价部分。
  • 改进了 google.maps.Map 上显示的 Google 徽标的颜色对比度,并添加了自定义样式
  • 矢量地图现在使用与栅格地图相同的卫星图像,从而可以实现更高的视觉保真度。

3.63.4a

2025 年 12 月 4 日

变更:

  • --gmp-mat-spacing-medium 现在适用于 PlaceDetailsCompactElement 水平视图的内部容器内边距。
  • 修复了在 macOS Safari 浏览器中与 UI 控件交互时 3D 地图发生偏移的问题。
  • 现在可以在 Map3DElement 上动态更改 languageregion 属性,而无需重新创建映射。

3.63.1b

2025 年 11 月 20 日

变更:

  • 修复了信息窗口在附加到 AdvancedMarkerElement 时位置不正确的问题。
  • 仅当输入内容包含文字时,才显示 PlaceAutocompleteElement 的清除按钮。
  • 在 PlaceDetailsCompactElement 样式中,使方向属性匹配不区分大小写。
  • 添加了在 3D 地图上打开 PopoverElement 时禁止平移地图的功能。
  • 修复了阻止在 PinElement 上使用 addEventListener() 的错误。
  • 现在,点击内容区域外部即可关闭模态对话框(例如地图上的键盘快捷键对话框和 Places UI Kit 中的披露对话框)。
  • 地点数据现在包括人工智能生成的评论和附近设施的信息摘要。新增属性包括 evChargeAmenitySummary、neighborhoodSummary、generativeSummary 和 reviewSummary。

3.62.13e

2025 年 11 月 6 日

变更:

  • 修复了动态地向 DOM 添加和从 DOM 中删除 PopoverElement 时出现的内存泄漏问题。
  • 修复了动态地向 DOM 添加和从 DOM 中删除 Map3DElement 时出现的内存泄漏问题。
  • 修复了在 PlaceDetailsCompactElement 中使用粗边框时,圆角图片与圆角容器的对齐问题。

3.62.12c

2025 年 10 月 30 日

变更:

  • [alpha 通道] 移除了实验性的ElevationElement
  • 为 Map 3D PopoverElement 添加了 CSS 变量 background-colorborder-radiusbox-shadowpadding
  • Places UI Kit 照片灯箱在点击照片外部时不再关闭。

3.62.11d

2025 年 10 月 23 日

变更:

  • [alpha 通道] 使深色模式能够突出显示位置上下文列表项。
  • AdvancedMarkerElementOptions 添加了 anchorLeftanchorTop 属性。
  • <gmp-pin> Web 组件现已可用。使用新的 glyphSrc 属性为字形提供图像 网址,或使用 glyphText 属性显示文本。glyph 属性现已在 PinElement 上弃用。
  • 防止在视口外创建关联的 AdvancedMarker 时意外显示 InfoWindow。
  • 3D 地图现已在每周频道上线。此版本包含新的指南针控件和简化的默认 UI 控件;支持基于云的地图样式和协作手势处理;改进了本地化,在 Map3DElement 上新增了 languageregion 属性,并改进了底图标签的辅助功能。有关更多信息,请参阅 3D Maps in Maps JavaScript
  • 改进了 Map 3D 的内存管理,以避免 iOS 设备上出现内存不足的问题。
  • 已启动 Routes JS。允许开发者通过 Maps JS API 调用 Routes API 并绘制路线。

3.62.9c

2025 年 10 月 9 日

变更:

  • AdvancedMarkerElement 添加了 anchorTopanchorLeft 属性。这样就可以将标记的锚点更改为除默认底部中间位置之外的其他位置。

3.62.8d

2025 年 10 月 2 日

变更:

  • Maps Embed API 已启用新的相机控制功能。
  • [beta 通道] Map3DElement 类和 Map3DElementOptions 接口中的 defaultUIDisabled 属性已被 defaultUIHidden 替换。defaultUIDisabled 将继续在 beta 通道中运行。
  • [beta 通道] FlyAroundAnimationOptions 接口中的 rounds 属性已被 repeatCount 替换。rounds 将继续在 beta 通道中运行。
  • mapMode 属性在 PlaceContextualElement 中已被弃用。

3.62.7e

2025 年 9 月 25 日

变更:

  • 为 PlaceContextualElement 启用高亮标记。

3.62.6d

2025 年 9 月 18 日

变更:

  • [beta 通道] 澄清 Route 错误消息。
  • [beta 通道] 支持在 Route 请求中放置资源名称。
  • [beta 通道] 允许从 RouteLeg 路径创建 Route 折线。

3.62.5d

2025 年 9 月 10 日

变更:

  • [beta 通道] Polyline3DElement 中的 coordinates 属性已被 path 取代,现在可将其作为 HTML 属性使用。Polygon3DElement 上的 outerCoordinates 属性已被 path 取代,现在该属性可作为 HTML 属性使用。Polygon3DElement 上的 innerCoordinates 属性已被 innerPaths 替换。这两个元素的所有“坐标”属性都已弃用,但在 beta 版本中仍将继续发挥作用。

3.62.3c

2025 年 9 月 3 日

没有面向公众的变更。

3.62.2c

2025 年 8 月 28 日

变更:

3.62.1

2025 年 8 月 21 日

变更:

  • [beta 通道] 在 AddressValidation.fetchAddressValidation() 中,为会话管理的地址验证 API 添加了 sessionTokenplaceAutocompleteElement 作为可选选项。
  • [Beta 版渠道] 发布了 Routes JS。允许开发者通过 Maps JS API 调用 Routes API 并绘制路线。

3.61.14

2025 年 8 月 7 日

变更:

  • 修复了以下问题:在横屏模式下,地点详情紧凑型元素中没有照片灯箱。

3.61.12c

2025 年 7 月 31 日

变更:

  • 为 PlaceAutocompleteElementOptions 和 BasicPlaceAutocompleteElementOptions 中的其他字段添加了文档。
  • 解决了以下问题:当高级标记平移到屏幕外时,会短暂闪烁然后消失。
  • 向 Place 类添加了 googleMapsLinks。

3.61.11a

2025 年 7 月 24 日

变更:

  • 向 Place Review 类添加了 originalText 和 originalTextLanguageCode。
  • [alpha 版] 为 PlaceContextual 地图接地 widget 启用 mapMode。允许用户在“路线图”“混合”和“无”之间切换。
  • [Beta 版渠道] 如果地图初始化失败(例如,用户的浏览器不支持 WebGL),Map3DElement 现在会触发一个事件。
  • 地图上的 45° 角航拍图像现已弃用。如需了解详情,请参阅弃用 - 45° 角航拍图像

3.61.10d

17 July, 2025

变更:

  • 基本地点自动补全 widget 现已在每周更新的渠道中提供。
  • [Alpha 渠道] 移除了实验性 PlaceListElement。
  • 添加 PlaceSearchElement 和关联的配置 / 请求元素。
  • PlaceDetailsElement 和 PlaceDetailsCompactElement 的其他样式令牌。

3.61.9a

2025 年 7 月 10 日

变更:

  • 更新了标记,以防止在使用屏幕阅读器时在每个商品上重复显示导航说明。现在,每次进入群组时,系统只会播报一次指令。
  • 修复了深色模式下键盘快捷键对话框的对比度问题。
  • 为地点自动补全 Element 启用边框、边框半径、微件背景颜色和配色方案自定义支持。地点自动补全元素现在会自动遵循深色模式 - 如要停用,请在 CSS 中应用 color-scheme: light
  • 向 Place Photo 和 Review 类添加了 googleMapsURI 字段。
  • [Beta 版渠道] 向 Address Validation API 添加了 PossibleNextAction 枚举。

3.61.7a

2025 年 7 月 1 日

变更:

  • Maps JavaScript API 中的热图图层功能不再受支持。此 API 已于 2025 年 5 月弃用,并将于 2026 年 5 月发布的后续版本 Maps JavaScript API 中停用。如需了解详情,请参阅 https://developers.google.com/maps/deprecations
  • 修复了 GA 中的问题,该问题导致无法处理因自定义样式而隐藏的地图注点的点击。
  • [Beta 版渠道] 在 3D 地图中添加了对 WebGL 上下文丢失的额外处理。现在,当 WebGL 上下文恢复时,3D 地图会尝试自行恢复。

3.61.6d

2025 年 6 月 26 日

变更:

  • 向 Map3DElement 和 Map3DElementOptions 添加了 internalUsageAttributionIds。

3.61.5a

2025 年 6 月 17 日

变更:

  • 为地点自动补全功能启用对 LocationBias 的字符串“IP_BIAS”的支持。
  • 修复了 SearchNearbyRequest 的文档错误。SearchNearbyRequest.RankPreference 的默认值为 POPULARITY,而不是 DISTANCE

3.61.4a

2025 年 6 月 12 日

变更:

  • 添加了 RPCStatus 枚举,用于描述某些 Web 服务返回的状态代码。

3.61.3b

2025 年 6 月 5 日

没有面向公众的变更。

3.61.2

2025 年 5 月 29 日

变更:

  • 添加了 PlaceDetailsElement、PlaceDetailsCompactElement 和关联的配置元素。移除了 PlaceDetailsSize。
  • 修复了 PlaceAutocompleteElement 的一个问题,即选择 IME 条目会导致该元素选择预测项。

3.61.1

2025 年 5 月 22 日

变更:

  • [Beta 版渠道] 修复了 PlaceDetailsCompactElement 地点输出中缺少位置/视口的问题。
  • 覆盖的城市提供街道层面的详细信息。

3.60.12

2025 年 5 月 8 日

变更:

  • [Beta 渠道] 在 Maps JavaScript API 中添加了对 Address Validation API 的支持。
  • 修复了来自没有 Origin 标头的上下文的网络调用问题。

3.60.11(已回滚)

2025 年 5 月 1 日

变更:

  • [Beta 版渠道] 添加了 PlaceDetailsCompactElement 和关联的配置元素。
  • 修复了 StreetViewPanoramaOptions.zoomControl = false 不适用于街景地图的问题。

3.60.10

2025 年 4 月 24 日

变更:

  • [Beta 版渠道] 3D 地图现已在 Beta 版渠道中推出。此版本包含多项无障碍功能改进,并为折线、多边形和 3D 模型新增了互动元素。此外,现在还提供了一个新的 PopoverElement,用于在 3D 地图上显示自定义 HTML 内容。如需了解详情,请参阅 Maps JavaScript 中的 3D 地图

3.60.9

2025 年 4 月 17 日

变更:

  • [alpha 渠道] 将 PlaceContextualElement 启动到不受限制的实验。
  • [透明度通道] 3D 模型现在默认在 3D 地图上使用基于图像的光照 (IBL) 进行渲染。

3.60.8

2025 年 4 月 9 日

变更:

  • [Beta 版渠道] LocalContext API 现已完全移除。现在,尝试实例化 LocalContextMapView 会抛出错误。如需了解详情,请访问 https://developers.google.com/maps/deprecations#localcontext-deprecation
  • 修复了在触控设备上拖动高级标记时导致出现异常行为的 bug。
  • 提高了协作手势处理叠加层的不透明度,以便其上的文字在地图的所有区域都满足对比度要求。
  • 在 Places API 中添加了对 PostalAddress 的支持。
  • 确保启动时的静态地理分布图叠加层与底层地图具有相同的颜色方案。

3.60.7b

2025 年 4 月 3 日

变更:

  • 地点自动补全 widget 现已在每周更新的渠道中提供。

3.60.6

2025 年 3 月 27 日

变更:

  • 修复了 Safari 上使用 overscroll-behavior 的网页无法正常滚动的问题。
  • 修复了在启用冲突行为的情况下添加大量高级标记时出现的闪烁问题。
  • 在地点中添加了对 PriceRange 的支持。

3.60.5(已回滚)

2025 年 3 月 20 日

变更:

  • 修复了以下 bug:点击或触摸高级标记时,网页无法滚动。
  • 修复了导致全屏模式在 <gmp-map> 中无法正常运行的 bug。
  • 修复了隐藏的高级标记的信息窗口仍然可见的 bug。
  • 在路线图中添加自行车骑行图层后,自定义样式的地图不会丢失其自定义样式。

3.60.4

2025 年 3 月 11 日

变更:

  • 自定义样式和背景颜色会应用于定义了该样式的特定地图类型和配色方案(最初,这仅限于路线图和深色路线图)。公交图层将保留所选地图类型的任何自定义样式。

3.60.3(已回滚)

2025 年 3 月 5 日

变更:

  • 修复了导致路线面板不显示的 bug。

3.60.2

2025 年 2 月 27 日

变更:

  • 地点:新增了对电动汽车连接器类型 NACS (SAE J3400) 的支持。
  • 正式发布了 gmp-map 和 gmp-advanced-marker HTML 元素。

3.60.1

2025 年 2 月 20 日

变更:

  • [Alpha 渠道] Polygon3DElementPolyline3DElement 上的 altitudeMode 现在默认为 CLAMP_TO_GROUND
  • [alpha 渠道] 现在必须在 Map3DElement 上设置新的 mode 选项,才能渲染 3D 地图(提供 2 个新值 HYBRIDSATELLITE)。移除了现有的 defaultLabelsDisabled 选项,请将 mode 设置为 HYBRIDSATELLITE
  • [Beta 版渠道] 如果未针对特定地图类型专门设置背景颜色,则背景颜色将恢复为默认颜色或在 MapOptions 中设置的颜色。
  • [Beta 版渠道] 栅格自定义样式应仅应用于已分配该样式的地图类型。
  • 修复了以下问题:在全屏模式下拖动高级标记时,高级标记会发生偏移。还修复了以下问题:在全屏模式下拖动街景小人时,街景小人会出现偏移。
  • 将默认的缩放控件替换为新的摄像头控件,其中包含平移和缩放按钮。
  • 更新了缩放按钮图标,使其与新的平移按钮图标保持一致。

3.59.8

2025 年 2 月 6 日

变更:

  • 客户现在可以以文本形式访问 TransitFare 值。
  • [Alpha 版] 推出了新的 AirQualityMeterElement:<gmp-air-quality-meter>。
  • [Alpha 渠道] 现在,使用 PlaceAutocompleteElement 将需要 Google Cloud 项目启用 Places API(新)。 。
  • [alpha 版] PlaceAutocompleteElement:gmp-placeselect 事件已替换为 gmp-select,并提供 PlacePredictionSelectEvent 对象,而不是 PlaceAutocompletePlaceSelect 对象。
  • [Alpha 版] PlaceAutocompleteElement:gmp-requesterror 事件已替换为 gmp-error,并提供 Event 对象,而不是 PlaceAutocompleteRequestErrorEvent 对象。
  • [Alpha 渠道] PlaceAutocompleteElement:componentRestrictions 已替换为 includedRegionCodes。
  • [Alpha 渠道] PlaceAutocompleteElement:类型已替换为 includedPrimaryTypes。

3.59.7

2025 年 1 月 30 日

变更:

  • [Beta 版渠道] 为自定义样式设置的路线图和深色模式路线图背景颜色应渲染在图块和过去的地图边距后面。
  • [Beta 版渠道] 自定义样式的路线图(或深色模式路线图)在添加公交图层时会保持其自定义样式,而不会恢复为默认的基本地图样式。
  • 现在,当添加公交线路图层时,处于深色模式的地图将保持深色模式。

3.59.6

2025 年 1 月 23 日

没有面向公众的变更。

3.59.5

2025 年 1 月 16 日

变更:

  • 修复了在创建自定义街景全景时抛出未捕获错误的 bug。

3.59.4a

2025 年 1 月 9 日

变更:

  • 修复了启用流量图层时抛出未捕获错误的 bug。
  • [Beta 版渠道] 解决了 PlaceAutocompleteElement 未正确产生焦点的问题。
  • [Beta 版渠道] 在支持的城市中,原子地图功能将在 z17 及更深的缩放级别下显示。

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。
  • 防止屏幕阅读器在嵌入式地图上的滚动消息处于隐藏状态时聚焦于该消息。

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 Fleet Tracking 添加了 ODRD 车辆和车队位置信息提供程序。

3.58.7

2024 年 10 月 3 日

没有面向公众的变更。

3.58.6

2024 年 9 月 25 日

变更:

  • [Alpha 版] 从 Polyline3DElementPolygon3DElement 中移除了 *Opacity 属性。可以使用 #rgba#rrggbbaargba(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 版渠道] 默认情况下,将缩放控件替换为相机控件。相机控制功能同时提供缩放和平移控件。
  • cameraControlcameraControlOptions 属性发布到 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 组件中的地图类型控件无法打开菜单的 bug。
  • 修复了导致 AdvancedMarkerElement 的拖动指示器缺失的 bug。
  • 为新的 Place API 添加了自动补全功能。
  • 地图光栅图块现在以 WebP 图片格式提供。
  • 更新了 Place.searchByText 和 Place.searchNearby 的文档,以指向正确的字段列表。
  • 每周渠道中现已提供新的 InfoWindow 关闭按钮和可选的标题。

3.57.0

2024 年 5 月 24 日

没有面向公众的变更。

3.56.12a

2024 年 5 月 9 日

变更:

  • 修复了导致 AdvancedMarkerElement 的拖拽指示器缺失的错误。

3.56.11

2024 年 5 月 2 日

变更:

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

3.56.10

2024 年 4 月 25 日

变更:

  • [Beta 版渠道] PlaceAutocompleteElement 的 gmp-placeselect 事件现在会冒泡。
  • [Beta 版渠道] 新的 InfoWindow 关闭按钮和可选标题现已推出。
  • [Beta 版渠道] 改进了街景小人控件的键盘和单指针无障碍功能。
  • 修复了因移除高级标记而导致的内存泄漏问题。
  • 修复了圆形无法绘制平滑周界的问题。
  • 添加了在 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 图片格式提供。
  • 固定矢量地图上地图兴趣点的信息窗口锚点位置。
  • 修复了显示 AdvancedMarkerElement 时未指定位置的错误。
  • 为 InfoWindow API 添加了“关闭”事件。

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> 中创建默认 slot,并允许创建自定义元素来封装 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 Journey Sharing 中为 Trip 和车辆位置信息提供程序启用可感知流量的折线。
  • 新的 Place 类现已在每周更新的渠道中提供。
  • 弃用 Place.openingHours。请改用 regularOpeningHours。

3.55.9

2024 年 1 月 25 日

变更:

  • [Beta 版渠道] 修复了以下问题:在 MapElement 上按 Esc 键时,无法关闭键盘快捷键对话框。
  • 为直接脚本加载的引导网址添加了新的网址参数 loading=async。这表示 Maps JavaScript API 未同步加载,并且没有 JavaScript 代码由脚本的 load 事件触发。强烈建议您尽可能将此值设置为 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 版渠道] AdvancedMarkerElementelement 属性现在指向 AdvancedMarkerElement 的实例。
  • [Beta 版渠道] 高级标记现在可以使用子节点自定义其内容。
  • 修复了以下 bug:点击地图后,平移和缩放键盘快捷键不起作用。
  • 为 JavaScript 行程分享启用多段线自定义功能。
  • [Alpha 渠道] 向 PlaceAutocomplete 添加了类型、requestedLanguage、requestedRegion 和名称属性
  • [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 日

变更:

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 日

变更:

  • 在 Journey Sharing JavaScript 中增加了对多个位置提供商的支持。

3.54.6

2023 年 9 月 21 日

变更:

  • google.maps.FeatureLayer 会响应 mousemove 事件。
  • 添加了 google.maps.FeatureType.SCHOOL_DISTRICT,因此在数据驱动样式中支持学区。

3.54.5

2023 年 9 月 14 日

变更:

  • [beta 通道] 修复了导致 AdvancedMarkerElement 的 addEventListener() 不可用的错误。

3.54.4

2023 年 9 月 7 日

变更:

  • Google 徽标不会像以前那样经常与地图上的版权信息重叠。

3.54.2

2023 年 8 月 24 日

变更:

  • 修复了 DirectionsRenderer 中的一个错误,即如果在渲染 DirectionsResult 之前没有设置缩放和中心,则地图将无法加载。

3.54.1

2023 年 8 月 18 日

变更:

  • 升级 Maps JavaScript API,使其原生支持 ECMAScript 2020。
  • 高级标记现在显示得更加清晰。
  • 当 Array.from 被不支持可迭代对象的实现替换时,地图会被停用。
  • 修复了在达到缩放限制级别时缩放按钮被停用后焦点丢失的问题。

3.53.13

2023 年 7 月 27 日

变更:

  • [beta 通道] 新 Place 类中的属性已重构。PhotoAttribution 现为 AuthorAttributionauthor 现更名为 displayNameauthorURI 现更名为 uriphotoURI {?string} 现已在 AuthorAttribution 上可用。Photo.attributions 现更名为 Photo.authorAttributionsReview.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:如果您使用箭头键突出显示预测结果,然后点击“退出”,地点自动补全元素将无法恢复原始文本。
  • [Alpha 渠道] 更新了地点自动补全预测样式,以确保在文本溢出时显示省略号。
  • [Beta 版渠道] Local Context 现在会显示一条通知,告知用户 Local Context 地图上的地点情境信息即将停用。
  • 修复了以下 bug:街景小人不会显示拖动悬停预览,除非它之前至少返回过一次基座。
  • 地点自动补全服务中已弃用的 bounds、location 和 radius。请改用 locationBias 和 locationRestriction。

3.53.2

2023 年 5 月 4 日

变更:

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

3.53.1a

2023 年 4 月 27 日

变更:

  • 更新了地点自动补全服务,以支持 locationBias 和 locationRestriction
  • [Beta 版渠道] 发布了有关 Place v2 toJSON 方法的文档。
  • [Beta 版渠道] 修复了地图环绕时的高级标记拖动问题。
  • [Beta 渠道] 数据驱动型样式 PlaceFeature.fetchPlace 显示名称将采用最终用户的语言。
  • [Beta 版渠道] AdvancedMarkerView 和 PinView 已重命名为 AdvancedMarkerElement 和 PinElement。
  • [Beta 版渠道] 修复了以下问题:有时在未明确加载 AdvancedMarker 和 Pin 的情况下,它们也会可用。请务必记得在访问这些类之前始终加载“marker”库。
  • [Beta 版渠道] AdvancedMarker position 现在已标准化为 LatLngAltitude。
  • [Beta 版渠道] 弃用高级标记 draggable 属性,改用 gmpDraggable

3.52.9

2023 年 4 月 13 日

变更:

  • [Beta 版渠道] 将 Place 属性“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 时导致错误的问题。

3.52.8

2023 年 4 月 6 日

变更:

  • 在 JavaScript Journey Sharing 中添加了 pollingIntervalMillis 作为轮询位置信息提供者的公共字段。
  • [Beta 版渠道] 将 Place 类 JSON 响应从 snake_case 更改为 lowerCamelCase。

bug 修复:

  • 修复了地点评价的 publishTime 显示错误日期的问题。
  • 修复了创建自定义元素时会全局中断的问题。
  • [beta 通道] 修复了地图环绕时高级标记消失的错误。

3.52.6

2023 年 3 月 23 日

变更:

  • [alpha 通道] Place Autocomplete Widget(新)实验版已发布。
  • 向每周频道发布了 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 修复:

  • 修复了在地图上添加和删除标记时可能发生的内存泄漏问题。
  • 修复了在触摸设备上,当可点击的高级标记位于交互元素下方时,交互元素仍然可以点击的错误。

3.52.2

2023 年 2 月 23 日

变更:

  • [beta 通道] 数据驱动样式:移除 PlaceFeature.displayName 属性。
  • [beta 版] 修复调用 setMap(null) 时 WebGLOverlayViews 无法正确移除的问题
  • 修复了有关 search 库未知的错误。
  • 修复了在影子根中时 InfoWindow 关闭按钮不可见的 bug。
  • 为了改进核心 Web 性能并减少不必要的数据传输,Maps JS 现在会将地图图块的加载延迟到地图接近视口时。在页面初始视口内创建的地图应该不会有任何区别。

3.52.1

2023 年 2 月 16 日

变更:

  • 添加了 importLibrary() 函数,该函数可在运行时动态加载库。
  • [Beta 版渠道] 启用在高级标记上打开时信息窗口的自动平移功能。
  • [beta 通道] 将 Journey Sharing 库数据对象中的某些字段设置为不可为空。
  • [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 渠道:向 Place 类添加了新属性
  • Beta 渠道:如果点击位置下方有多个地图项,则数据驱动型样式 FeatureMouseEvent.features 数组可能包含多个地图项,并且点击位置下方的所有 FeatureLayer 点击监听器都会被触发。
  • Beta 渠道:针对传递给 google.maps.Map.getFeatureLayer 的无效参数抛出错误。
  • 修正了全屏地图上高级标记的像素位置。
  • 更改了地图鼠标事件,现在会忽略在已按下另一个鼠标按钮时发生的鼠标按钮点击。
  • 修复了在放大地图时导致高级标记消失的 bug。
  • 改进了在包含许多高级标记的地图上放大时的性能。
  • 更新了 StreetViewPanoramaOptions 文档,以明确说明 clickToGo 不适用于自定义全景图片。
  • 提高了创建 LatLngBounds(包括通过 Map.getBounds() 创建)时的性能。
  • 更新了 onAdd 和 onRemove 的 WebGLOverlayView 参考。
  • 为“结伴出行”添加了固定的标记样式自定义功能。

3.51.3

2022 年 12 月 8 日

变更:

  • 修复了以下 bug:当标记位于地图视口之外时,无法放弃其键盘焦点。
  • Beta 渠道:引入了 Place 类,这是一个新的更简单的 API,支持 promise 等新型使用模式。Place 类包含一些新的数据字段。
  • Beta 渠道:修复了以下错误:当传递封装在代理中的地图时,高级标记无法呈现。
  • 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 版渠道:为 Journey Sharing 位置信息提供程序添加了轮询状态更改事件。
  • Beta 渠道:为行程分享添加了样式自定义功能。弃用了旧的设置方法。
  • 为“路线”面板的各个步骤添加了键盘无障碍功能。现在可以使用 Tab 键浏览路线,并使用空格键或 Enter 键选择路线。
  • google.maps.geometry.spherical.computeArea() 现在接受 LatLngBoundsCircle。现在可以使用 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 说明。
  • 为地图的比例控件启用键盘焦点和互动。
  • 为地理编码器 JS API 引入了语言参数。如果未明确指定,Maps JS API 不再将 US 视为地理编码器中的默认区域。
  • 为 Directions JS API 引入了语言参数。
  • 为 Distance Matrix JS API 引入了语言参数。

bug 修复:

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

3.51

2022 年 11 月 16 日

变更:

  • 每周渠道已更新至版本 3.51。
  • 季度渠道已更新至版本 3.50。
  • 如果按编号请求,仍可使用版本 3.49 和 3.48。

3.50.12a

2022 年 11 月 7 日

变更:

  • 修复了 google.maps.event.addListenerOncegoogle.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 说明和 LocalContextMapViewOptionelement 属性添加了“此字段为只读字段。”

bug 修复:

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

3.50.7

2022 年 9 月 29 日

变更:

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

3.50.6

2022 年 9 月 22 日

bug 修复:

  • 修复了 iOS 版 VoiceOver 可能会浏览键盘快捷键对话框下方元素的问题。
  • 向静态地图图片添加替代文本。

变更:

  • 现在,当调用 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(getMapCapabilitiesmapcapabilities_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 日

变更:

bug 修复:

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

3.49.5

2022 年 6 月 16 日

变更:

  • 为街景视图添加键盘快捷键控件和对话框,提高键盘快捷键的可发现性。

bug 修复:

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

3.49.4

2022 年 6 月 9 日

变更:

  • WebGLOverlayViewCameraParamsLatLngAltitudemoveCamera、小数缩放和 getVisibleRegion 移至每周频道。
  • Map 的默认街景全景图现在会在打开时自动管理焦点。这是新的默认行为。
  • 现在,当街景全景图关闭时,会自动恢复对焦(如果可能)。
  • 现在可以通过按 ESC 键关闭街景(当关闭按钮启用时)。
  • geometry.spherical.computeSignedArea()geometry.spherical.computeArea() 经过优化,提高了稳健性和准确性。

3.49.3a

2022 年 6 月 2 日

变更:

  • 提高了街景运动跟踪控制的色彩对比度。
  • 使街景中的运动轨迹控制功能可通过键盘访问,并支持屏幕阅读器。
  • MapsNetworkErrorMapsRequestErrorMapsServerError 类现已公开并记录在文档中。

3.49.2

2022 年 5 月 26 日

变更:

  • 提高了街景运动跟踪控制的色彩对比度。
  • 使街景中的运动轨迹控制功能可通过键盘访问,并支持屏幕阅读器。
  • MapsNetworkErrorMapsRequestErrorMapsServerError 类现已公开并有文档说明。

3.49.1

2022 年 5 月 19 日

变更:

  • Beta 版渠道:修复了多个 Places JS API 中忽略区域代码的 bug。为各种 Place JS API 引入了语言和区域参数。
  • 改进了深色模式下全屏和指南针控件的色彩对比度。
  • 使街景指南针控制、关闭按钮和地址链接控制更易于访问,并且对屏幕阅读器友好。

3.49

2022 年 5 月 12 日

变更:

  • 每周频道更新至 3.49 版本。
  • 季度频道更新至 3.48 版本。
  • 版本 3.47 和 3.46 仍然可以通过编号申请获得。
  • 3.45 版本已删除,无法再使用。

3.48.11

2022 年 4 月 28 日

变更:

  • 位置自动完成功能现在可以接受更多类型。 了解详情
  • isFractionalZoom 被移至每周频道。

3.48.9

2022 年 4 月 14 日

变更:

  • Beta 通道:为 WebGLOverlayView 启用 WebGL 2.0。
  • Beta 频道:将 JourneySharing 库包含到 Maps JavaScript API TypeScript 类型、外部和参考文档中。
  • 函数 google.maps.event.addDomListener()google.maps.event.addDomListenerOnce() 已弃用,不应使用。请改用标准的addEventListener()方法。这些方法将继续有效,目前没有停用的计划。
  • 在街景标记图标中添加 titlearia-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 客户启用 更新的底图。更新后的底图已在消费者版谷歌地图上使用,它提供了更丰富、更详细的底图,尤其是在地形自然特征方面。

bug 修复:

  • 撤销 先前的修复,以进行 map.fitBounds()(缓解短距离视口过渡),待分析。
  • 修复了高对比度模式下地图类型控件的颜色对比度问题。
  • 将地图类型控件复选框的可访问名称与相应的视觉标签进行匹配。
  • 修复了高对比度模式下信息窗口的颜色对比度问题。

3.48.6

2022 年 3 月 24 日

变更:

  • 修复了 map.fitBounds(),以缓解短距离视口过渡问题。

3.48.5

2022 年 3 月 17 日

变更:

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

bug 修复:

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

3.48.4

2022 年 3 月 10 日

变更:

3.48.3

2022 年 3 月 3 日

变更:

  • Beta 通道:在 Maps JavaScript API 街景服务中启用新的服务调用方式。您可能需要更新您的 内容安全策略,以确保这些调用不会在浏览器级别被阻止。
  • InfoWindow 引入了一个新的 ariaLabel 属性。

3.48.1

2022 年 2 月 17 日

变更:

  • Beta 版:新增了对设置全局体验 ID 的支持。请在此处查看 API 参考文档
  • Beta 通道:fromLatLngAltitude 的第一个和第二个参数现在将合并为 LatLngAltitude,而不是 LatLngnumber
  • LatLngnoWrap 参数重命名为 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 日

变更:

  • LatLngLatLngBoundsCircle 现在在构造函数中接受同一类的实例。

3.47.2

2021 年 12 月 2 日

变更:

  • 现在,只要 projection 允许使用 LatLng,就允许使用 LatLngLiteral 作为参数。

bug 修复:

  • 修复了在较小缩放值(小于 1.0)下可能会出现的一些渲染问题。

3.47.1

2021 年 11 月 18 日

变更:

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

bug 修复:

  • 将不符合 WCAG 标准的 controlHeightcontrolWidth 属性替换为符合标准的 data-* 属性。

3.47

2021 年 11 月 11 日

变更:

  • 每周渠道已更新至版本 3.47。
  • 季度渠道已更新至版本 3.46。
  • 如果按编号请求,版本 3.45 仍可使用。
  • 版本 3.44 已被删除,无法再使用。

3.46.12

2021 年 11 月 4 日

bug 修复:

  • 更新了“地图类型”菜单栏,添加了更准确的 ARIA 标签。
  • 嵌入 API:为多个链接添加了 ARIA 标签,以改善屏幕阅读器体验。
  • Embed API:修复了部分文本项的颜色对比度。
  • 修复了外部声明中 google.maps.Marker.MAX_ZINDEX 的类型。

3.46.11

2021 年 10 月 28 日

变更:

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

3.46.8

2021 年 10 月 7 日

变更:

  • 本地情境:从本地情境信息窗口照片中移除了提供方信息链接。

3.46.6

2021 年 9 月 23 日

变更:

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

3.46.5

2021 年 9 月 16 日

bug 修复:

  • 修复了“地点”自动完成组件中颜色对比度的错误。

3.46.3

2021 年 9 月 2 日

变更:

  • 滚动说明现在显示在打开的 InfoWindowCustomOverlay 上方。

3.46.2

2021 年 8 月 26 日

变更:

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

3.46

2021 年 8 月 18 日

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

变更:

  • PlaceResulticon_mask_base_uriicon_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。 Internet Explorer 11 的支持将于 2022 年 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:当绘图管理器从地图中移除并重新添加到地图中时,未完成的多边形绘制会自动完成。
  • 修复了某些语言中“嵌入地图”弹出窗口中“方向”字符串被截断的错误。

3.45.5

2021 年 7 月 1 日

变更:

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

bug 修复:

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

3.45.4

2021 年 6 月 24 日

变更:

  • 修复了导致在提交表单时打开键盘快捷键对话框的 bug。
  • 修复了“键盘快捷键”按钮未对齐的 bug。
  • 移除了意外添加到 window(球面、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。

变更:

3.45.1

2021 年 6 月 3 日

变更:

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

bug 修复:

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

新功能:

  • 在路线、距离矩阵、海拔、地理编码器、最大缩放比例影像、StreetView 和 AutcompleteService.getPlacePredictions() 服务中启用了对 Promise 的支持。
  • 在地图上添加了键盘快捷键控件和对话框,以提高键盘快捷键的可发现性。
  • 矢量地图现已在每周更新渠道中推出(仅提供基本功能;WebGL 功能可在 Beta 版渠道中使用)。

3.44.14

2021 年 5 月 13 日

变更:

  • 现在,当调用 InfoWindow.open() 但没有关联的 Map 或 StreetView 实例时,系统会向控制台记录警告。

3.44.12

2021 年 4 月 28 日

bug 修复:

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

Local Context:

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

3.44.11a

2021 年 4 月 20 日

变更:

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

bug 修复:

  • 修复了在初始化基础地图之前加载静态标记时可能发生错误的 bug。

3.44.9

2021 年 4 月 8 日

bug 修复:

  • 修复了以下 bug:启用街景时,地图控件可通过键盘访问。

3.44.8

2021 年 4 月 1 日

变更:

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

3.44.7

2021 年 3 月 25 日

变更:

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

3.44.4

2021 年 3 月 4 日

变更:

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

bug 修复:

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

3.44.2

2021 年 2 月 25 日

变更:

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

3.44.1

2021 年 2 月 18 日

变更:

  • 现在,重新加载显示的地点时,LocalContext 地点选择器按钮处于停用状态。
  • 未优化的标记现在可聚焦,并且可通过键盘访问。
  • Beta 版渠道:移除了意外添加到 window 中的对象(SphericalPolylineCodecPolyGeometry)。这些对象应通过其完全限定的命名空间进行访问。
  • 在 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 修复:

  • 修复了有时会填充 geojson 多边形孔洞的 bug。
  • 修复了在地图和街景之间切换时导致叠加层消失的 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:标记的可点击区域的大小绘制得过大。
  • 修复了 polyfill 冲突的 bug,该 bug 会影响 IE11 上的符号。

3.43.2

2020 年 12 月 1 日

变更:

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

bug 修复:

  • 修复了以下 bug:在某些情况下,取消标记动画可能会导致相应标记提前终止未来的动画。

3.43.1a

2020 年 11 月 20 日

变更:

  • MarkerLabel 接口添加 className 属性,以设置 label 元素的 CSS 类。
  • 图像最大缩放级别服务添加了对 Promise 的 Beta 版支持。
  • StreetView 服务中添加了对 Promise 的 Beta 版支持。
  • 在提供 titlelabel 时,向未优化的标记添加了无障碍功能文本。
  • MapType 控制下拉菜单按钮中移除了 aria-pressed 标签,以提升无障碍功能。
  • DropdownMenuDropdownMenuItem 转换为语义元素,以提高无障碍性。
  • 修改版权信息文本,使其符合颜色对比度标准。
  • 现在可以使用 Enter 键或空格键打开和关闭下拉菜单。
  • 下拉菜单项现在可以聚焦。
  • 本地情境库:现在,当轮播界面控件不起作用时,系统会将其停用,并且这些控件不再与列表中的第一项或最后一项重叠。

bug 修复:

  • 修复了 GroundOverlays 跨越 180 度经线时可能会发生的 bug。
  • disableDefaultUI 设置为 true 时,键盘快捷键不再默认处于停用状态。
  • 修复了地图切换按钮的屏幕阅读器文本不正确的 bug。
  • Map 添加了无障碍名称和类型。
  • 修复了界面文档中将一些可选属性错误地显示为必需属性的问题。
  • 修复了以下 bug:当传递 LatLngLiteral 时,noWrap LatLng 构造函数参数会被忽略。

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 日

变更:

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

支持更新的地点图标

2020 年 10 月 1 日

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

3.42.7

2020 年 9 月 29 日

变更:

  • 修复了以下 bug:在“报告地图错误”控件提示中,RTL(从右到左)语言的字词顺序错误。
  • RTL 文字方向的居中标记标签。

3.42.6

2020 年 9 月 21 日

变更:

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 版现已推出。请参阅版本控制指南。

变更:

  • 信息窗口现在具有 648 像素的默认最大宽度,您可以通过设置 InfoWindow maxWidth 属性来替换此默认值。信息窗口的宽度现在可以超过 648 像素,但仍会受到地图宽度的限制。(之前,信息窗口始终限制为 648 像素或地图宽度,以较小者为准。)
  • 防止在渲染大型 GeoJson 数据集时出现默认样式渲染闪烁。
  • 每周渠道已更新至版本 3.42。
  • 季度渠道已更新至版本 3.41。
  • 如果按编号请求,版本 3.40 仍可使用。
  • 版本 3.39 已被删除,无法再使用。

3.41.7

2020 年 7 月 22 日

已修复:

  • 修复了以下 bug:使用云端样式设置时,将 clickableIcons 属性设置为 false 无效。

3.41.5

2020 年 7 月 6 日

变更:

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

3.41.2

2020 年 5 月 27 日

变更:

  • Places Library 和 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 不是元素,则地图现在会抛出更易于诊断的 InvalidValueError。
  • Chrome 浏览器将地址自动填充到 google.maps.places.Autocomplete 中时,不应再触发向服务器发送的自动补全请求(这样可以避免产生费用)。
  • 使 maxWidth 属性更加准确。在此更改之前,如果您将 InfoWindowmaxWidth 指定为 100,则 InfoWindow 的实际最大宽度为 94px。 更改后,最大宽度实际上将为 100 像素。
  • 修复了使用标记和地图边界时,绘制请求构建器的内存泄漏问题。

3.40.6

2020 年 3 月 24 日

变更:

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

3.40.4

2020 年 3 月 10 日

变更:

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

3.40.2

2020 年 2 月 23 日

变更:

  • 从标签页导航中移除了地图中的隐藏 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_nowutc_offset 已于 2019 年 11 月 20 日弃用,并将于 2021 年 2 月 20 日关闭。请参阅 Places 字段迁移 以了解更多信息。
  • 每周渠道已更新至版本 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 表格已无法使用(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 版本现已发布。 请参阅版本控制指南。

变更:

  • 新增功能:
  • 信息窗口已得到改进。
  • 每周频道已更新至 3.36 版本。
  • 季度频道已更新至 3.35 版本。
  • 版本 3.34 仍然可以通过电话申请获取。
  • 3.33 版本已被删除,无法再使用。

3.35

2019 年 1 月 29 日

变更:

  • API 现在可以返回每个地点的评论总数。
  • 增加了对 Plus 代码 的支持。Plus 代码是一种短代码,可以为世界上的每个地方提供地址,即使在没有传统街道地址的地区也是如此。
  • Internet Explorer 9 已停止支持。

弃用:

  • AutocompleteplaceIdOnly 参数已弃用。
  • 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 的客户将改而收到其默认渠道(每周渠道或季度渠道,请参阅版本控制指南)。
  • 现在,系统会启用更大的控制界面。 随着各种设备上的触控操作不断增加,我们调整了控制界面,使其既适合手指触控,也适合鼠标点击。 (您可以通过加载 API 时指定 v=quarterly、v=3.33 或 v=3.32 来选择停用。)

3.33

2018 年 6 月 11 日

变更:

2018 年 5 月 16 日

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

变更:

3.32

2018 年 2 月 13 日

变更:

  • 一个新的实验性渲染器 renderer 现已可用。
  • 我们现已推出新的实验性基本地图

3.31

2018 年 2 月 13 日

变更:

  • 默认情况下,将前 256 个标记设为 DOM 标记,然后将后续标记设为 Tile 标记。当前默认值为所有功能块标记。
  • 在高缩放级别(放大)拖动街景小人时,优先选择 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 版本控制的指南。

变更:

3.29

2017 年 5 月 16 日

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

变更:

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

3.28

2017 年 4 月 18 日

draggable财产MapOptions对象是已弃用。要禁用桌面设备上的地图拖动功能,请使用 gestureHandling 属性并将其设置为 none

2017 年 2 月 15 日

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

变更:

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

3.27

2017 年 2 月 2 日

已修复:

2017 年 1 月 10 日

现在您可以将自动完成预测结果限制为仅显示来自多个国家/地区的内容。您可以通过在 AutocompleteOptionscomponentRestrictions 字段中指定最多 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 服务响应中的 via_waypoints 字段包含原始请求中未指定的航点数组。via_waypoints 字段将继续出现在可拖动方向响应中,但在备选路线响应中已弃用 。版本 3.27 将是最后一个在备用路由中支持 via_waypoints 的 API 版本。

建议的做法是请求备选路线,然后将所有路线显示为不可拖动,并将主路线显示为可拖动。用户可以拖动主路线,直到它与备选路线匹配。via_waypoints 字段在生成的路线中可用(由用户拖动)。

3.26

2016 年 8 月 18 日

Maps JavaScript API 的 3.26 版本现已作为实验版本提供。(参见指南)API 版本控制。)

变更:

  • 全新的街景渲染器带来了渲染方面的改进,包括更流畅的过渡和动画、改进的对象建模、更好的移动设备支持以及更清晰的控制。详情请参阅 Google Geo Developers Blog
  • API 现在支持街景中的设备方向事件,因此移动设备用户可以通过移动手机来环顾四周。作为开发者,您可以启用或禁用此功能。详情请参阅开发者指南

3.25

2016 年 5 月 25 日

Maps JavaScript API 的 3.25 版本现已作为实验版本提供。(参见指南)API 版本控制。)

Internet Explorer 9 支持终止

2016 年 5 月 2 日

截至 2016 年 4 月 30 日,Internet Explorer 9 已不再受到 Maps JavaScript API 的官方支持。查看 个受支持的浏览器列表

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 内容安全策略 指令来使用 API。

2015 年 12 月 21 日

变更:

  • 地图选项:禁用已登录地图的登录按钮(启用此选项后,已登录用户的头像仍会显示,仍可通过已登录用户的操作(例如加星标)登录,但地图上将不再显示登录按钮)。
  • 文本搜索请求的界面已更改。自 2016 年 3 月 1 日起,types 参数已弃用,取而代之的是新的 type 参数,该参数每个搜索请求仅支持一种类型。 此外,establishmentfoodgrocery_or_supermarket 类型将不再支持作为搜索参数(但是这些类型仍然可能出现在搜索结果中)。使用旧版 types 参数的请求将继续受支持,直至 2017 年 3 月 1 日,之后所有文本搜索都必须使用新的实现方式。

2015 年 12 月 2 日

变更:

  • Autocomplete 构造函数会验证它是否接收到输入元素。
  • 底图兴趣点信息窗口在未登录模式下显示的内容与登录模式下显示的内容相同。
  • Closure Compiler 的 Google Maps API externs 现在为枚举指定类型(数字或字符串)。

2015 年 11 月 25 日

变更:

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

2015 年 11 月 19 日

变更:

  • 白色谷歌标志,适用于风格化地图

已修复:

3.22

2016 年 1 月 7 日

已修复:

  • 问题 9009: 从触摸合成鼠标事件时,为了与 jQuery 兼容,请使用左键而不是中键。

2015 年 11 月 10 日

变更:

  • 当出行方式为驾车时,路线服务和距离矩阵服务现在会返回预测的交通时间(在响应字段 duration_in_traffic 中)。要接收预测的旅行时间,请在请求中包含一个 drivingOptions 对象字面量,指定当前或未来的 departureTime。您还可以指定 trafficModel 乐观值、悲观值或最佳猜测值(默认值),以影响计算旅行时间时使用的假设。有关详细信息,请参阅 Directions 服务Distance Matrix 服务 的开发者指南。duration_in_traffic 仅适用于 Google Maps Platform Premium Plan 客户。

已弃用:

  • 请求字段 durationInTraffic 现已 弃用。以前,使用 Google Maps Platform 专业版方案的客户如果想指定结果中是否应包含基于当前路况信息的时长,我们会建议他们使用此字段。现在您应该改用 drivingOptions 字段。

2015 年 11 月 5 日

已弃用:

  • AdSense 库自 2015 年 5 月起已被弃用,并且在 Maps JavaScript API 的实验版本中不再可用。该库将很快从 API 的发布版本和冻结版本中移除。另一种解决方案是使用谷歌广告联盟。请参阅指南创建 AdSense 广告单元

2015 年 9 月 22 日

变更:

  • 在发出方向和距离矩阵请求时,增加了对地点 ID 的支持:DirectionsRequest.originDirectionsRequest.destinationDirectionsWaypoint.location 现在接受 Place 对象,DistanceMatrixRequest.originsDistanceMatrixRequest.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 出现多边形内存不足错误
  • IE10 及更高版本上的触摸事件修复
  • 现在,对开发者提供的输入进行错误验证时,系统会将输出内容发送到控制台,而不是抛出错误。

2015 年 7 月 6 日

已修复:

  • 问题 8159:bug:StrokePosition.OUTSIDE 呈现不正确

2015 年 6 月 17 日

变更:

  • 已修复:问题 6321:错误:“未捕获的类型错误:无法读取未定义对象的属性 '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:错误:KML 地面/图像 - 叠加层突然变得非常低分辨率
  • “保存”微件文本与星形图标更好地对齐

2015 年 3 月 17 日

已修复:

  • 问题 7756: Bug: Safari 8 性能回归
  • 已移除人口统计层
  • 对 InfoWindow Chrome 的改进

2015 年 2 月 17 日

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

3.17 版本将被移除。现在,对 3.17 或任何先前版本的请求都将由 3.18 版处理。

版本控制文档可在以下网址获取:https://developers.google.com/maps/documentation/javascript/versions

转换后的可用版本:

实验版: 3.20

版本:3.19

冻结:3.18

3.19

2015 年 4 月 24 日

已修复:

  • 已登录模式下的光标。

2015 年 3 月 19 日

已修复:

2015 年 1 月 20 日

已修复:

  • 问题 7475: Bug: phantomjs TypeError: 无法删除属性

2015 年 1 月 13 日

已修复:

  • 现在屏幕阅读器已对图块隐藏

2014 年 12 月 17 日

已修复:

  • 问题 6917:bug:形状不遵循地图的“draggable”属性
  • 问题 7445: 错误:使用 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:Bug:键盘箭头键在 v=3.exp 中无法正常使用

2014 年 7 月 31 日

添加时间:

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

2014 年 7 月 7 日

添加时间:

  • toGeoJson 已添加到“数据层”和各个“数据层要素”,允许将几何图形导出为 GeoJSON。

2014 年 6 月 24 日

添加时间:

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

2014 年 5 月 26 日

添加时间:

  • 地图 API 网址中不再需要 sensor 参数。

2014 年 5 月 20 日

3.17 已发布到实验版。

3.16

2014 年 4 月 15 日

已修复:

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 日

添加时间:

2014 年 3 月 12 日

添加时间:

2014 年 2 月 24 日

添加时间:

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

2014 年 2 月 17 日

3.16 已发布到实验版。

3.15

2014 年 3 月 3 日

已修复:

2014 年 2 月 10 日

已修复:

  • 在 Chrome/Linux 上停用所有 tile 硬件加速,以解决更大的 Chrome 硬件加速问题。

2014 年 2 月 3 日

已修复:

2014 年 1 月 29 日

已修复:

  • 在 Chrome/Windows 上停用所有 tile 硬件加速功能,以解决更大的 Chrome 硬件加速问题。(第 6219 期

2014 年 1 月 22 日

已修复:

2014 年 1 月 16 日

已修复:

  • 使视觉刷新 CSS 的特异性降低,以覆盖更少的用户设置样式。

2013 年 11 月 27 日

已修复:

  • 在实例化地图后创建标记时抛出“包含未定义”错误(问题 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 日

添加时间:

已修复:

  • Bug:自定义街景全景和 90 度向下视角(问题 4875

3.12

2013 年 6 月 4 日

已修复:

  • 当 visualRefresh=true 时,信息窗口 domready 不会触发(问题 5415
  • Bug:iOS 上的 visualRefresh 信息窗口(问题 5396

2013 年 5 月 15 日

添加时间:

2013 年 4 月 29 日

已修复:

  • 移除的标记在安卓和 Dolphin 浏览器上仍会保留在地图上。

3.11

2013 年 2 月 19 日

已修复:

  • 在绘图过程中更改绘图模式会导致错误
  • 点击说明面板中的步骤即可更改缩放级别

2013 年 2 月 12 日

已修复:

  • 不可拖动的多边形可以通过触摸输入拖动到可拖动的多边形中(问题 4868
  • 当 travelMode 切换时,“路线替代方案”面板中的公交图标不正确(问题 4581
  • 在某些情况下,panTo(latLng) 并不总是能将地图中心精确地定位在 latLng 处。

2013 年 1 月 29 日

添加时间:

  • 添加了 StreetViewCoverageLayer,用于以编程方式添加覆盖图层。
  • 街景全景图的公开街景视角

已修复:

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

2013 年 1 月 22 日

添加时间:

  • 为多段线、多边形、圆形、矩形添加了可拖动选项
  • PlaceResult 中的 price_level 字段

2013 年 1 月 15 日

已修复:

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

2013 年 1 月 7 日

已修复:

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 画布,以获得最佳标记效果。

已修复:

3.10

2013 年 2 月 4 日

已修复:

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

2012 年 9 月 25 日

添加时间:

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

2012 年 9 月 11 日

新的:

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

2012 年 8 月 28 日

添加时间:

  • Places API textSearch 的类型

已修复:

  • 在 GWT 下,Symbol 对象不能传递给 MarkerOptions。
  • 回归:在 iOS 5 上,当网页滚动时,双指张合缩放功能失效(问题 4046

2012 年 8 月 14 日

显著变更:

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

3.9

2012 年 9 月 10 日

已修复:

  • 在 GWT 下,无法将符号对象传递给 MarkerOptions
  • 回归问题:iOS 5 中页面滚动时捏合缩放功能失效(问题 4046

2012 年 8 月 9 日

已修复:

  • Android 3.x 版本出现语法错误

2012 年 7 月 31 日

显著变更:

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

已修复:

  • 在 Safari 浏览器中,当缩放比例大于 35 时,标记符号不会触发事件。
  • 自定义地图(地图类型+投影)上的标记未触发点击事件

2012 年 7 月 25 日

已修复:

  • 自动补全中的 componentRestrictions(问题 4302

2012 年 7 月 17 日

已修复:

  • 在 IE 浏览器中,信息窗口中的文本框无法点击。
  • bounds_changed 应该在 zoom_changed 之前触发(问题 1399
  • 调用街景视图后,地图选项背景颜色未保留。
  • 从样式地图切换到卫星地图会不必要地加载地图图块。
  • 地图可拖动/滚轮属性在绘图模式下被忽略(问题 4012
  • 当显示多个世界地图副本时,LatLngBounds 应返回完整的经度范围。
  • 双击时不要绘制空形状(问题 3964
  • 点击时出现多余的标记事件(问题 3911)

显著变更:

  • 将搜索和查询端点重命名为 NearbySearch 和 TextSearch。

2012 年 7 月 10 日

显著变更:

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

2012 年 6 月 27 日

添加时间:

显著变更:

  • 认识到“透明”是一种颜色。

2012 年 6 月 23 日

添加时间:

  • 符号
  • HeatmapLayer
http://mapsplatform.googleblog.com/2012/06/powerful-data-visualization-with.html
  • 新增造型器选项“重量”和“颜色”:

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

2012 年 5 月 15 日

添加时间:

  • 自动完成功能的国家/地区限制 (AutocompleteOptions.componentRestrictions) ( 问题 3899)
  • 区域和城市类型过滤器

3.8

2012 年 5 月 1 日

已修复:

2012 年 4 月 23 日

已修复:

  • 关闭街景后,Pegman 仍保留在自定义地图类型地图上(问题 4076
  • 已移除的动画标记无法重新添加到地图中(问题 4052

2012 年 4 月 18 日

已修复:

  • 天气信息窗口始终在 Firefox 上显示下雨图标(问题 4063

添加时间:

  • FusionTablesLayer 的 orderBy、limit 和 offset(Issue 3557

2012 年 4 月 10 日

已修复:

  • 即使整个视口内没有航拍图像,也会显示航拍图像(第 3913 号问题

2012 年 4 月 3 日

添加时间:

  • WeatherLayer 和 CloudLayer(问题 3555
  • DemographicsLayer

已修复:

  • IE 9 怪癖:多边形的图块边界可见
  • 在 Canvas 街景中平移时,标记会跳动。

2012 年 3 月 28 日

已修复:

  • 使用小写标签名称以符合 XHTML 标准(第 3868 号问题
  • 更改了 Apple 触控板的缩放行为,使其灵敏度降低(问题 2416

2012 年 3 月 20 日

已修复:

  • 创建带有不存在的阴影图像的标记会导致错误(问题 4014

添加时间:

显著变更:

  • 街景视图中默认禁用双击缩放功能。

2012 年 3 月 6 日

已修复:

添加时间:

  • 透明度到 GroundOverlay(问题 2767
  • 将 utc_offset 和 opening_hours 赋值给 PlaceResult ( Issue 2431)
  • clickToGo 选项到 StreetViewPanoramaOptions(问题 2447

2012 年 2 月 21 日

已修复:

  • IE 9 上的地图模糊问题(问题 3875
  • 由 LatLng 空间中共线边构成的折线被错误简化(问题 3739

添加时间:

  • google.maps.geometry.poly.containsLocation() 和 isLocationOnEdge() ( Issue 1978)

2012 年 2 月 15 日

已修复:

  • 回归:使用无效的“size”参数时,缩放标记渲染不正确(问题 3908
  • 当用户拖动控制点时调用 setEditable(false) 会导致地图卡在编辑模式(问题 3842

显著变更:

  • 街景全景图之间淡入淡出。

3.7

2012 年 2 月 7 日

已修复:

  • 标记在最终位置闪烁,然后才会触发下落动画(问题 3608
  • 同时打开信息窗口并设置缩放会导致地图中心不正确(问题 3738
  • 拖动标记时忽略右键单击(问题 3237
  • 标记标题有时在 Firefox 上不显示(问题 3773

显著变更:

  • 现在,缩放标记已在 Canvas 中渲染(如有)。
已添加:
  • setOpacity() for ImageMapType ( Issue 3125)
  • setOpacity() for GroundOverlay ( Issue 2767)
  • ImageMapType 的“tilesLoaded”事件(问题 1744
  • stop() 到 MouseEvent,它会停止事件传播(问题 2172

2012 年 1 月 31 日

已修复:

  • 已修复:环游世界后出现的韩语图块错误(问题 2722
  • 已修复:无法准确放置小人以显示街景(问题 3861
  • 为多边形添加了“visible”属性(问题 2861
  • 即使视口间距很远,panTo 和 panBy 动画仍然存在(回归)

2012 年 1 月 24 日

已修复:

  • 鼠标事件通过信息窗口冒泡显示(问题 3573
  • 已在 IE9 上启用 CSS 转换
  • 街景全景图添加了 imageDateControl
  • 在 IE 9、Opera 和 Safari/Windows 上启用了 Canvas 街景

2012 年 1 月 16 日

已修复:

  • 在绘图模式下,小人不应该可以拖动。
  • 正确触发事件,并遵循多边形和其他图层的 zIndex 属性。
  • 添加 KmlLayer“status”属性(问题 3015

2012 年 1 月 10 日

已修复:

  • 如果 disableDefaultUI 为真且 streetViewControl 为真,则显示小人。

2011 年 12 月 7 日

已修复:

  • 控制出入高速公路的样式可以与普通高速公路的样式分开设置(road.highway.controlled_access)
  • 当用户在自动完成时按下“Enter”键时触发 place_changed 事件(问题 3407

1011 年 11 月 28 日

已修复:

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

2011 年 11 月 22 日

已修复:

  • 信息窗口内容大小现在会考虑层叠样式进行计算。
  • 航拍地图旋转控制与地图创建时的航向不匹配

2011 年 11 月 7 日

显著变更:

  • 默认控件的新视觉风格
  • 可编辑形状(多边形、折线、圆形、矩形)
  • 新增绘图管理器,用于添加新的叠加层
  • 新增 PlaceResult 字段:网站和国际电话号码
  • 新增 ElevationResult 字段:分辨率

已修复:

  • 在 IE 7 及更高版本中,方向结果中的起点和终点图标现在以透明背景显示。

3.6

2011 年 10 月 31 日

已修复:

  • 在 IE7 上使用 Prototype 库并结合 Maps API 时出错

2011 年 10 月 25 日

已修复:

  • KmlLayer 地图在图层加载完成前发生更改时出错
  • 在 IE 浏览器中添加和删除多边形时出现内存泄漏

2011 年 10 月 18 日

显著变更:

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

2011 年 10 月 10 日

已修复:

  • 街景预览中的地址过长

2011 年 9 月 27 日

已修复:

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

2011 年 9 月 27 日

已修复:

  • Chrome 浏览器中初始图块的双重获取
  • 平移时出现内存泄漏
  • 当平移到超出覆盖范围的区域时,不要让街景小人消失。
  • 回归:跨越-180 经度的地面叠加层消失
  • 回归问题:在平移和缩放过程中打开信息窗口时,地图中心位置不正确

显著变更:

  • 在小人被拖拽时显示街景预览。

2011年9月20日

已修复:

  • 使用 Canvas 渲染标记时,Chrome/Windows 系统存在内存泄漏。
  • 航向角为 90 度或 270 度的航拍图标记渲染

显著变更:

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

2011 年 9 月 12 日

已解决的问题:

  • Firefox 4+ 中工具提示出现后标记卡在凸起位置(问题 3334

显著变更:

  • GeocoderResult.formatted_address 未记录。

2011 年 9 月 6 日

已修复:

  • 在 Firefox 中,选择元素(下拉菜单)信息窗口不会跟随地图平移。
  • 韩国某些移动设备上的磁贴

2011 年 8 月 29 日

显著变更:

  • 允许自定义控件的 z-index 高于 API 控件
  • 链接会将用户引导至 maps.google.com 的相应语言版本。
  • 如果没有信息窗口的 HTML 代码、名称或描述,请不要在 KML 功能上打开信息窗口。
  • 已修复回归问题:高 DPI 图块损坏

2011 年 8 月 24 日

已解决的问题:

  • 已禁用 Chrome/Mac 的硬件加速:修复标记渲染问题和叠加层点击问题(问题 3544问题 3551
  • 修复了 Android 系统页面滚动时捏合缩放的问题(问题 3373

显著变更:

  • 商务图标现在默认开启。

2011 年 8 月 17 日

显著变更:

  • 可点击的地图图标,用于显示兴趣点。
  • 可以在 MapOptions 中设置样式,并将其应用于所有默认地图类型。
  • 除非明确禁用,否则 Pegman 会显示在自定义地图类型中。

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

显著变更:

  • 新增了自定义“地点自动完成”控件和下拉菜单样式的功能
  • 地点自动完成组件会在用户选择建议后保留服务器返回的描述

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 日

已解决的问题:

  • 已修复:支持命名 CSS 颜色,例如多边形描边颜色和填充颜色。
  • 修复了以下问题:如果将 strokeOpacity 设置为 0.0,则多边形不可见。 ( 问题 3241)
  • 已修复:在 IE8 中,当 AdUnit 可见时平移会出错(问题 3159
  • 允许在地图类型控件中显示地形图和混合地图,而不显示地图和卫星图像(问题 3089
  • 为高 DPI 屏幕加载高 DPI 图块(第 2614 版

显著变更:

  • 启用并提供航拍图像时,航拍倾斜角度默认为 45 度
  • 改进了 iPad 上的开合手势
  • 将 DirectionsTravelMode 和 DirectionsUnitSystem 重命名为 TravelMode 和 UnitSystem(旧名称保持向后兼容)

2011 年 4 月 14 日

已解决的问题:

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

显著变更:

  • 现在,多段线和多边形可在 Canvas 中尽可能地呈现。
  • 现在,折线和多边形边界上的事件的 LatLngs 会捕捉到线上最近的点。

2011 年 4 月 5 日

已解决的问题:

2011 年 3 月 28 日

已解决的问题:

  • 在卫星模式下无法更改街景中的朝向(问题 3174)
  • 禁用 VML 时地图损坏(问题 3119

显著变更:

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

2011 年 3 月 22 日

已解决的问题:

  • Pegman 显示在自定义地图类型中(第 3154 期

显著变更:

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

2011 年 3 月 17 日

已解决的问题:

显著变更:

  • 已修复:圆形和矩形忽略 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 时的 Hybrid 问题(问题 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) 问题 2920
  • Safari/Mac 中的文本渲染问题(问题 3024
  • 在 IE 中无法正确打印路线地图

2011 年 1 月 21 日

显著变更:

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

2011 年 1 月 17 日

已解决的问题:

  • 修复了以下问题:zoom_changed 的时间不正确导致 fromLatLngToContainerPixel 的结果不正确(问题 2539

2011 年 1 月 6 日

已解决的问题:

显著变更:

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

2010 年 12 月 23 日

已解决的问题:

  • 修复了可拖动方向上的航点点击处理程序(问题 2871

2010 年 12 月 21 日

已解决的问题:

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

显著变更:

  • 在触摸设备上,无论请求的是 ZOOM_PAN 还是 SMALL 导航控制,我们都将显示一个易于触摸的缩放控制。如果设备在浏览器中支持多点触控,则不会显示缩放控件,因为缩放是通过捏合手势实现的。

2010 年 12 月 9 日

已解决的问题:

  • InfoWindows 现在在 IE 中打印效果很好(版本 1343
  • 修复了 IE8 中 ImageMapType 的不透明度问题

显著变更:

  • 拖动时,自定义图标的标记下方会显示一个十字,并且 raiseOnDrag 已启用

2010 年 12 月 5 日

已解决的问题:

  • 提供一个界面,用于查找给定位置的卫星图像的最大缩放级别。(第 2049 期
  • 添加了一个选项 (raiseOnDrag),用于在标记被拖动时启用/停用动画。(第 2910 期

显著变更:

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

2010 年 11 月 28 日

已解决的问题:

  • maptypeid_changed 不再触发两次(问题 2449
  • 现在可以访问 MarkerImage 对象的“size”属性了(问题 2465
  • 标记形状引用的是图标而不是精灵(问题 2629
  • 已改进在标记拖动时平移地图的功能,尤其适用于较小的地图(第 2868 版)。
显著变化:
  • 现在,无需启用背景图片打印功能即可打印地图
  • 修复了当“draggable”设置为 false 时,可拖动方向标记仍然可以拖动的错误。

2010 年 11 月 16 日

更改的问题:

显著变更:

  • 修复了以下 bug:在 FF 中,如果按住 Shift 键点击标记,系统会打开新窗口。
  • 当使用 DirectionsRenderer 指定 markerOptions 时,字母标记图标丢失

3.2

2010 年 11 月 11 日

显著变更:

  • 修复了在 IE7/IE8 中使用 RTL 时多边形被裁剪​​/截断的错误。
  • 修复了因 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: IE8 中 ImageMapTypeOptions 的不透明度属性损坏
  • 问题 2661: 信息窗口 - 右键点击输入字段时未显示上下文菜单
  • 问题 2741:在 iOS 4 上,地图平移后标记放置功能无法正常工作

显著变更:

  • 街景默认启用。
  • 修复了“this”未传递给.getTileUrl 的错误。
  • 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 日

更改的问题:

显著变更:

  • 测地线已针对更高缩放级别进行了改进。

2010 年 8 月 24 日

更改的问题:

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

显著变更:

  • 当反复放大或缩小(例如使用滚轮时)时,我们现在会从中间缩放级别加载更少的图块。

2010 年 8 月 16 日

更改的问题:

  • 问题 2416:苹果妙控鼠标平移和缩放过于灵敏
  • 问题 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 的 Map 的问题
  • 修复了调用 GroundOverlay.setMap(null) 的问题
  • IE 不再泄漏内存(缩放/平移)

2010 年 8 月 5 日

更改的问题:

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

显著变更:

  • 修复了 IE6 中标记在缩放级别发生变化时消失的问题

2010 年 7 月 29 日

更改的问题:

显著变更:

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

2010 年 7 月 22 日

更改的问题:

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

显著变更:

  • 拖动多边形时不再触发点击事件
  • 点击扩展到 InfoWindow 之外的表单选择元素不再触发地图点击事件
  • 点击 KML 叠加层不再触发地图点击事件
  • Streetview 现在会自动平移,以使 InfoWindow 适合屏幕
  • KML 和 FusionTables MouseEvent LatLng 已从“position”更改为“latLng”
  • Android 缩放控件不再将点击传递给地图

2010 年 6 月 17 日

更改的问题:

  • 问题 2346: 提供用于停用平滑动画的选项

显著变更:

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

2010 年 6 月 11 日

更改的问题:

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

3.0

2010 年 5 月 18 日

更改的问题:

显著变化:
  • 修复了自定义地图类型中 Google 版权信息不正确的错误
  • 为多边形和折线添加了测地线属性
  • 为多边形和折线添加了可点击选项
  • 地面覆盖层添加了可点击选项

2010 年 5 月 13 日

变更的问题

  • 问题 1724:通过元素而非字符串设置内容时,信息窗口大小/边距不正确

显著变更:

  • 修复了跨越国际日期变更线时地面叠加层过早裁剪的错误。
  • 标记 setIcon 现在支持 网址 中包含反斜杠 (\)。
  • IE 中多边形和折线的鼠标移出事件触发
  • 更改标记图标不再闪烁

2010年5月7日

变更的问题

  • 问题 1458: 功能请求:在 Google API v3 中支持 KML
  • 问题 1658:添加流量叠加层
  • 问题 2209: 堆栈溢出
  • 问题 2254:对 Circle 对象多次调用“setMap(gMap)”和“setMap(null)”会改变其描边和填充不透明度

显著变更:

  • 添加了 KML 和 GeoRSS 图层
  • 新增 地面叠加层
  • 新增图层:交通自行车
  • 针对 DirectionsRendererOptions 添加了“suppressBicyclingLayer”属性
  • 修复了地图类型更改时缩放图层引用不正确的错误
  • 将 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:为多边形和折线添加鼠标悬停和鼠标移出事件
  • 问题 2177:在“maptypeid_changed”事件期间,map.setZoom(z) 无法正常工作
  • 问题 2247:DirectionsRenderer 上的 hideRouteList 选项未按预期工作

显著变更:

  • 修复了平移地图时自定义图标会从地图底部消失的错误。

2010 年 4 月 13 日

变更的问题

  • 问题 2275: MarkerImage 无法重复使用
  • 问题 2181:当您添加 google.maps.Marker 并使用鼠标滚轮放大或缩小地图时,该标记会被隐藏。

2010 年 4 月 11 日

没有明显变化或问题改变。

2010 年 4 月 5 日

变更的问题

显著变更:

  • 在 DirectionsRoute 中公开方向概览折线作为 overview_path。
  • 将地图的当前投影方式公开为只读属性。

2010 年 3 月 23 日

显著变更:

  • 海拔高度现已在 API 中公开
  • 改进了慢速网络连接下的图块加载速度。

2010 年 3 月 15 日

显著变更:

  • 现在,当样式发生变化时,多边形会正确重新绘制。
  • 使用旧式“Directions”时,会通过 console.log 输出已弃用的警告消息。

2010 年 3 月 10 日

变更的问题

  • 第 1801 期:折线/多边形 z 轴索引
  • 问题 2144:DirectionsRequest 应提供避开高速公路选项
  • 问题 2207:错误:折线在 IE 中会被填充
  • 问题 2113:1 月版本发布后,在高缩放级别下,Firefox 中的折线出现断裂

显著变更:

2010 年 3 月 3 日

变更的问题

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

显著变更:

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

2010 年 2 月 26 日

变更的问题

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

显著变更:

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

2010 年 2 月 8 日

变更的问题

  • 问题 2135: Bug: 如果在 Polyline 中重用 Polygon 的 MVCArray,则 Polyline 是闭合的。

显著变更:

  • 添加了新的矩形类
  • 新增 Circle 类
  • 修复了在创建然后移除标记时发生的内存泄漏问题。
  • 停止对 LatLngs 的 MVCArray 进行注释以闭合多边形,因为这会导致共享同一 MVCArray 的折线也被闭合(参见 问题 2135)。
  • 修复了地图缩放设置为当前值时有时会隐藏屏幕上标记的错误。
  • 修复了 ImageMapType 在 Android 上正确显示的问题。
  • 更改了多边形裁剪方案,允许包含北极或南极的多边形。
  • 在浮点精度允许的范围内,将墨卡托投影的纬度范围增加到最大可能值。

2010 年 1 月 28 日

变更的问题

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

显著变更:

  • 新增对印度语言的支持:
    • bn、gu、kn、ml、mr、ta、te
  • event 命名空间添加了新的静态方法:
    • addListenerOnce
    • addDomListenerOnce
  • DirectionsStep 对象添加了新的“encoded_lat_lngs”属性,以压缩 ASCII 格式公开纬度值集。
  • 通过移除屏幕外标记 DOM 元素提升了性能
  • 修复了 Google Chrome 中的平移 bug
  • 修复了 iPhone 上的捏合缩放错误

2010 年 1 月 19 日

变更的问题

  • 问题 1422:功能请求:允许开发者创建自定义地图类型
  • 问题 1523:功能请求:从容器像素到经纬度(反之亦然)
  • 问题 1443: extend() 和 union() 应该返回 LatLngBounds 对象
  • 问题 1960: bug: 使用 provideTripAlternatives 提供的信息不完整
  • 问题 1675:教程文档错误
  • 问题 1676: 教程文档错误 - 控制选项
  • 问题 1856:Opera 中多边形无法渲染!!!
  • 问题 1954: 保加利亚语本地化不正确。
  • 问题 1976:错误:自定义图标和可拖动标记问题
  • 问题 2063:压缩 OverlayView 子类时出现的变量名冲突

显著变更:

2009 年 12 月 17 日

显著变更:

  • 修复了地图平移动画开始前出现的初始抖动问题。
  • 修复了使用滚轮或双击放大超过最大缩放级别时地图跳转到不同位置的问题。
  • 版权、地图类型和导航控件会调整大小以适应地图大小。
  • 旧式的 getter、setter 和事件名称已被正式弃用,不再定义。

2009 年 12 月 10 日

变更的问题

  • 问题 1820:使用鼠标滚轮放大地图时,似乎会放大到超过最大缩放级别,并且地图位置会“跳过/跳跃”。
  • 问题 1743:滚动缩放会导致地图移动到完全不同的位置

其他值得注意的变化:

  • 新增方法 panToBounds
  • 新增地图动画。影响所有浏览器中的拖拽、平移、缩放以及对 setCenter/setZoom 的调用。
  • 如果使用了 已弃用的方法,则添加控制台日志警告消息。

2009 年 11 月 25 日

变更的问题

其他值得注意的变化:

  • 新增 RTL 支持,可启用以下语言:阿拉伯语、波斯语、希伯来语
  • 为 DirectionsResult 步骤公开 lat_lngs 属性。

2009 年 11 月 11 日

变更的问题

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

其他值得注意的变化:

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

2009 年 10 月 29 日

变更的问题

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

其他值得注意的变化:

2009 年 10 月 26 日

变更的问题

  • 问题 1647:功能请求:为信息窗口 DOM 就绪提供事件
  • 问题 1710: 能够在双击时取消用户缩放事件

其他值得注意的变化:

  • 当无效实参传递到 new google.maps.LatLng() 时,系统会抛出 JS 错误
  • 修复了以下 bug:静态地图在地图加载时加载了两次

2009 年 10 月 15 日

变更的问题

其他值得注意的变化:

  • 文档更新:
    • 公开了新方法: 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)中使用,包括受支持的移动设备。
  • 添加了新的地图事件“idle”,当地图在一段时间内未移动时触发。解决了问题 1371
  • 修复了点击事件返回的 LatLng 值不正确的问题。
  • 修复了 iPhone 上的双指张合缩放 bug。请参阅问题 1723

2009 年 9 月 10 日

变更的问题

  • 问题 1659: 平移后,点击和双击事件中报告的 latLng 不正确,Firefox 3.5
  • 问题 1621: 在 IE8 中点击地图后,使用 doctype 获取错误的位置
  • 问题 1642: InfoWindow overflow:auto
  • 问题 1531: 每次打开信息窗口时,其高度都会增加

其他值得注意的变化:

  • 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:错误:地图滚动轮不必要地
  • 问题 1379:我无法在 V3 中看到韩国地图数据

其他值得注意的变化:

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

2009 年 8 月 24 日

变更的问题

其他值得注意的变化:

  • 默认启用滚轮缩放功能。要禁用此功能,请将地图选项的滚动轮属性设置为 false。
  • 文档已更新,新增了 panTo 和 panBy 函数。

2009 年 8 月 14 日

变更的问题

  • 问题 1575:可拖动标记方法 set_draggable() 中的错误

其他值得注意的变化:

  • 已启用滚轮缩放。
  • 修复了 iPhone 用户拖动地图后地图跳动的问题。

2009 年 8 月 4 日

变更的问题

  • 问题 1393:允许可拖动标记
  • 问题 1448:错误:API v3 需要一个 checkResize() 函数(或等效函数)
  • 问题 1404:Opera 浏览器中光标错误
  • 问题 1514:HTML 4.01 严格模式下 MapType 选择箭头显示不正确
  • 问题 1426: 信息窗口 z-index 控件

其他值得注意的变化:

  • iPhone 上的捏合和拖动操作应该更加稳定可靠。
  • 为 InfoWindow 对象添加了 zIndex 设置器和获取器。

文档变更:

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

2009 年 7 月 13 日

变更的问题

  • 问题 1415: 信息窗口内容:可选择 true/ false
  • 问题 1432:调用 set_icon 后 Mouseout 事件不会触发
  • 问题 1365:使用严格的文档类型声明时,地图类型控件渲染不正确

其他值得注意的变化:

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

2009 年 6 月 12 日

更改的问题:

  • 问题 1363:错误:iPhone 上地图点击事件未被分发

其他值得注意的变化:

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