Maps JavaScript API 版本说明

订阅这些版本说明。 订阅

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

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

本页面列出了 2025 年和 2026 年的版本说明。如需了解更早的版本，请参阅 Maps JavaScript API 版本说明归档。

如需接收有关新版地图 API 的更新，请订阅 google-maps-js-api-v3-notify 群组。

3.66.9d

2026 年 10 月 14 日

变更：

  • 修复了以下问题：在 AdvancedMarkerElement 上完成拖动操作会错误地触发地图点击事件。
  • 修复了重新打开同一 POI 后，POI 信息窗口无法使用 Esc 键关闭的问题。
  • [Alpha 渠道] AdvancedPlaceDetailsElement、AdvancedPlaceDetailsCompactElement 和 AdvancedPlaceItemElement 现在支持 Alpha 渠道中的 basic-section-top 和 basic-section-bottom 槽。
  • [Alpha 版渠道] PlacePinElement现已上架，用于在地图上显示地点信息
  • 修复了以下问题：当地图为 gmp-map 元素时，InfoWindow 无法通过 Escape 键关闭，且焦点无法返回到之前获得焦点的元素。

3.66.8b

2026 年 10 月 8 日

变更：

  • 修复了以下问题：再次点击 POI 图标后，无法使用 Escape 键关闭 POI 信息窗口。
  • 修复了键盘箭头键导航将焦点移至可见地图区域之外的 AdvancedMarkerElement 的问题。
  • [Beta 渠道] 向 3D 地图 (Map3DElement) 添加了 MapMode.ROADMAP、地图模式界面控件 Map3DElement.colorScheme（用于浅色和深色地图样式设置）以及 Label3DElement (<gmp-label-3d>)。

3.66.7

2026 年 10 月 1 日

变更：

  • [Alpha 版渠道] 修复了在强制颜色模式下，Route3DElement 弹出式窗口中的公交车辆图标消失的问题。
  • [Alpha 渠道] Route.createWaypointMarkers() 现在会在其创建的标记上设置本地化的默认 title（“起点”或“终点”）。
  • [Alpha 渠道] 修复了 Route3DElement 弹出式窗口文本在混合和卫星地图模式下不可见的问题。
  • [Alpha 渠道] 由 Route.createWaypointMarkers() 创建的 3D 标记现在会保持恒定的屏幕尺寸（sizePreserved 默认为 true）。
  • [Alpha 版渠道] Route3DElement 现在，您可以使用键盘访问起点和终点标记，屏幕阅读器也会朗读这些标记。将鼠标悬停在标记上时，其标题会显示为提示。
  • [Beta 渠道] 添加了 Map3DElement.maxMemoryMegabytes 和 Map3DElement.qualityMode 属性以及 QualityMode 枚举，以帮助减少 3D 地图的内存用量。
  • 修复了在 Safari 中更改页面缩放比例时 PopoverElement (<gmp-popover>) 偏离其锚点的问题。
  • 通过 gmp-pointerover、gmp-pointerout 和 gmp-pointermove 为 Maps3D 中的互动元素添加了指针事件支持。
  • 修复了 3D 地图绘制元素（Marker3DElement、Model3DElement、Polygon3DElement、Polyline3DElement、FlattenerElement、CirclePathElement）和 PopoverElement 的 TypeScript 定义，以接受 google.maps.LatLng。

3.66.6c

2026 年 9 月 22 日

变更：

  • 修复了以下问题：通过构造函数选项或值属性以编程方式填充 PlaceAutocompleteElement 时，该元素不显示其清除按钮。
  • [alpha channel] 从 google.maps.routes.RoutePolyline3DOptions 中移除了 colorScheme。Route3DElement 现在会跟踪父级 Map3D 的有效配色方案。
  • [Beta 渠道] 修复了街景全景图片渲染生命周期中的内存泄漏问题。
  • [Beta 渠道] PlaceLinkElement 默认图标可以使用 default-icon-hidden 属性隐藏，从而允许仅显示文本的地点链接。

3.66.4d

2026 年 9 月 9 日

变更：

  • [Alpha 渠道] AutofitsCamera 最小范围从 2,000 米更改为 80 米。
  • 已弃用 AdvancedMarkerElement.addListener() 和旧版事件（click、dragstart、drag、dragend）。请改用标准 addEventListener() 和带有 gmp- 前缀的事件。

3.66.3d

2026 年 9 月 2 日

变更：

  • [Alpha 渠道] 向 RoutePolyline3DOptions 添加了 trafficPolylinesDisabled 字段。这样，开发者在创建 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 版渠道] 将 <gmp-label-3d> (google.maps.maps3d.Label3DElement) 添加到 3D Maps JS API 的 Alpha 版渠道。开发者现在可以使用新元素来声明标签文本，并独立于其关联的 3D 标记元素（例如 <gmp-marker-3d> 和 <gmp-marker-3d-interactive>）配置其冲突行为。
  • 为“地点详情”微件中的“更多选项”按钮提供唯一的无障碍名称。
  • [Alpha 渠道] 改进了在 Alpha 版/Beta 版之外使用 TravelMode.TWO_WHEELER 时显示的 Route 3D 出错提示
  • [Alpha 版渠道] Route3D 组件现在支持 trafficPolylinesDisabled 属性。这样，开发者在使用 TRAFFIC_AWARE 或 TRAFFIC_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 地图倾斜和航向界面控件，以便在相机限制范围扩大时重新启用。

3.65.8c（已回滚）

2026 年 7 月 7 日

变更：

  • [Alpha 版渠道] Route3DElement 会为公交路线呈现额外的多段线和弹出式窗口数据。
  • 向 Address Validation API 添加了对 internalUsageAttributionIds 的支持。此属性允许将 API 调用归因于特定软件包或 OSS 库。
  • 更新了在 2D 地图上点击地图注点时显示的默认信息窗口，以使用地点微件。
  • 提高了街景全景图片在高流量条件下的可靠性。

3.65.6a

2026 年 6 月 25 日

变更：

  • [Beta 渠道] 更新了在 2D 地图上点击地图注点时显示的默认信息窗口，以使用地点微件。
  • 修复了 3D 地图偶尔会在 fov 值达到极端时抛出错误的 bug。
  • 更新了默认路线标记，不再使用已废弃的 glyph PinElement 选项。

3.65.5e

2026 年 6 月 17 日

变更：

  • 修复了 OverlayView.getMap() 的类型
  • 更新了 BasicPlaceAutocompleteElement 和 PlaceAutocompleteElement 的类型，以指明构造函数选项参数是可选的

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 (New) API 添加了对 internalUsageAttributionIds 的支持。借助此属性，开发者可以将 API 调用归因于特定软件包或 OSS 库。
  • [Alpha 版渠道] 缩小了 Route3DElement 属性的 getter 类型，以匹配 setter 规范化。
  • [Alpha 版渠道] Route3DElement 公开了 routes、fallbackInfo 和 geocodingResults 属性。

3.65.2d

2026 年 5 月 27 日

变更：

  • 修复了在具有受限边界的地图上缩小时缩放按钮出现的问题。
  • Places 库引入了 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-text 和 prediction-item-nonmatch 阴影部分，以便为不匹配的主要文本和次要文本自定义样式。
  • 向 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 添加了 no-clear-button 属性和 noClearButton 属性，以便隐藏清除按钮
  • Maps JavaScript API 中的热图图层功能现已停用。
  • 改进了地图配置检索的错误处理。
  • 光栅地图现已停用 45 度角图像。
  • 在 PlacesLibrary 文档中添加了缺失的类。还记录了 FormattableText 上的 toString() 方法。
  • 改进了“报告地图错误”链接的无障碍功能。

3.64.12d

2026 年 5 月 6 日

变更：

  • LatLng 的 equals() 方法现在接受 LatLngLiteral 对象，而不是抛出错误。LatLng 和 LatLngAltitude 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。现在，您可以在地点自动补全（Google Data API 和微件）和文本搜索请求中设置 pureServiceAreaBusinessesIncluded，以请求纯上门服务商家的结果。
  • Places 库为地点引入了 addressDescriptor、containingPlaces 和 timeZone。
  • Places 库已为地点引入 futureOpeningDate。现在，您可以在地点自动补全（数据 API 和 widget）、附近搜索和文本搜索请求中设置 futureOpeningBusinessesIncluded，以请求尚未开业的商家的结果。
  • 现在，无论是否具有地图 ID 或自定义样式，浅色路线图的 Google 徽标都将保持一致。之前，对于所有使用地图 ID 的路线图地图，我们都会显示深色模式的 Google 徽标。如需保持白色 Google 徽标，用户应切换到深色模式。
  • 在 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 中添加了 focus-ring 作为 CSS 阴影部分。
  • 添加了新的 FuelType DIESEL_PLUS 和 E100。添加了新的 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 版渠道] 具有 autofitsCamera 的 Route3DElement、Marker3DElement 和 Polyline3DElement 从 DOM 中移除时不会导致镜头更新。对于 Route3DElement，错误或空响应对镜头没有影响。此外，如果将给定元素的 autofitsCamera 从 true 更改为 false，则不会更新摄像头以排除该元素，但会使该元素不参与未来的摄像头更新。
  • AdvancedMarkerElement 的 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 版渠道] 添加了新的 Route3DElement，用于在 3D 地图上呈现路线。
  • [Alpha 版渠道] 添加了新的 Route.create3DPolylines() 和 Route.createPopover() API。
  • [Alpha 渠道] 添加了新的 spherical.traversePath() API。
  • [Alpha 版渠道] 为 Marker3DElement、Polyline3DElement 和 Route3DElement 添加了新的 autofitsCamera API，并为 Map3DElement 添加了新的 autofitsCameraAnimation API。
  • [Alpha 版渠道] 添加了新的 CirclePathElement，用于使用 Polygon3DElement 渲染圆圈。
  • [Alpha 版渠道] alpha 渠道中的 3D 地图现已推出新的 ROADMAP 地图模式。
  • 修复了以下 bug：在移动设备上，如果街景小人位于附加到 DOM 元素的地图中，而该 DOM 元素是在与 Maps JS 库代码不同的框架上下文中创建的，则街景小人无法正常工作。

3.64.6d

2026 年 3 月 26 日

变更：

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

3.64.5d

2026 年 3 月 18 日

变更：

  • weekly 渠道现在提供多项 3D 地图更新，包括新的 MarkerElement 和 FlattenerElement。此外，我们还添加了 cameraPosition 和 fov 属性，并为 flyCameraTo 和 flyCameraAround 方法添加了 altitudeMode 支持。
  • Places 库针对已识别的地点引入了 currentOpeningHours、regularSecondaryOpeningHours 和 currentSecondaryOpeningHours。currentOpeningHours 提供接下来一周的营业时间，包括节假日等任何特殊营业时间。次要营业时间与地点的主要营业时间不同，表示地点提供免下车服务、自提或外卖等服务的时间。
  • 修复了 3D 地图中的一个问题：地图移动后，指向 Google 地图的链接有时无法正确更新。

3.64.4d

2026 年 3 月 12 日

变更：

  • 在位置发生变化时同步 InfoWindow 地图属性，以解决导致不必要的控制台警告的问题。
  • 修复了对 Map3DElement 的程序化 fov 更新偶尔会被丢弃的问题。
  • Map3DElement 上的 flyCameraAround 方法现在接受 Number.Infinity 作为 repeatCount 参数，从而实现无休止的动画。

3.64.3a

2026 年 3 月 2 日

变更：

  • Maps Embed API 现在使用 Places UI Kit 显示地点详情。
  • [Beta 渠道] 之前在 3.64.2 中针对 Map3DElement 引入的 cameraPosition 属性现在也支持 flyCameraTo 目标。如需了解详情，请参阅 Maps JavaScript 中的 3D 地图。

3.64.2b

2026 年 2 月 26 日

变更：

  • google.maps.DirectionsService、google.maps.DirectionsRenderer 和 google.maps.DistanceMatrixService 将于 2026 年 2 月 25 日弃用。目前，我们不打算停用这些库，并且会继续针对任何重大回归问题提供 bug 修复。服务停用前，我们将至少提前 12 个月发出通知。如需了解更多详情（包括更新、推荐的替代方案），请参阅旧版。
  • [Beta 渠道] 引入了新的 MarkerElement，可让您在 3D 地图上的标记内显示自定义 HTML 内容。此外，新的 FlattenerElement 现在可以展平特定区域中的 3D 网格。
  • [Beta 渠道] Map3DElement 已更新，添加了 fov 和 cameraPosition 属性，而 flyCameraTo 和 flyCameraAround 方法现在支持 altitudeMode。如需了解详情，请参阅 Maps JavaScript 中的 3D 地图。
  • 修复了导致使用 document.createElement('gmp-pin') 创建 PinElement 时抛出 NotSupportedError 的 bug。

3.64.1c

2026 年 2 月 19 日

变更：

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

3.63.14d

2026 年 2 月 5 日

变更：

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

3.63.13

2026 年 1 月 29 日

变更：

  • 将鼠标光标放在地图注点上时，Maps Embed API 不再显示悬停卡片。
  • 针对配置错误的 Places UI Kit（地点详情 + 地点搜索）元素添加了控制台警告
  • PlaceDetailsElement 现在会显示 AI 生成的地点摘要（如果有）。
  • PlaceDetailsElement 现已支持 AI 生成的评价摘要。

3.63.10a

2026 年 1 月 13 日

变更：

  • 修复了导致无法在弹出式窗口内执行滚动和点击手势的问题。
  • 现在可以通过 Places API 使用 resourceName 和 shortFormattedAddress 字段

3.63.9d

2026 年 1 月 8 日

变更：

  • PlaceSearchElement 会在照片加载期间，以稍快的速度显示非照片内容。Places UI Kit 中的照片淡入动画经过了优化。
  • 提升了在倾斜地图上渲染多段线时的性能。
  • 修复了在某些情况下通过编程方式设置 3D 地图镜头时，镜头无法更新的 bug。
  • 略微提升了为PlaceDetailsElement和PlaceSearchElement加载照片时的性能。
  • 阐明了 MapOptions 中 draggable 属性的行为，以便更好地解释用户互动限制。
  • 在地址验证库中强制执行 possibleNextAction 的 Beta 渠道访问权限
  • 向 PlaceAutocompleteElement 添加了 placeholder 属性和 HTML 属性支持
  • PlaceAutocompleteElement 现在支持自定义更多标准 CSS 字体属性，包括：font、font-size、font-family、font-weight、line-height、font-style 和 color。默认字号现在变为 16px。
  • 向 PlaceAutocompleteElement 添加了 value 属性和 HTML 属性支持
  • 优化 Places UI Kit 中的图片加载。
  • 向 PlaceAutocompleteElement 添加了 CSS Part input

3.63.5d

2025 年 12 月 11 日

变更：

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

3.63.4a

2025 年 12 月 4 日

变更：

  • --gmp-mat-spacing-medium 现在适用于 PlaceDetailsCompactElement 横向视图的内部容器内边距。
  • 修复了在 MacOS Safari 上与界面控件互动时 3D 地图发生偏移的问题。
  • 现在，您可以在 Map3DElement 上动态更改 language 和 region 属性，而无需重新创建地图。

3.63.1b

2025 年 11 月 20 日

变更：

  • 修复了信息窗口附加到 AdvancedMarkerElement 时位置不正确的问题。
  • 使 PlaceAutocompleteElement 的清除按钮仅在输入框中有文本时可见。
  • 在 PlaceDetailsCompactElement 样式中，使方向属性匹配不区分大小写。
  • 添加了在 3D 地图上打开 PopoverElement 时停用平移地图的功能。
  • 修复了导致无法在 PinElement 上使用 addEventListener() 的 bug。
  • 现在，点击内容区域外部即可关闭模态对话框（例如地图上的键盘快捷键对话框和 Places UI Kit 中的披露信息对话框）。
  • 地点数据现在包含 AI 生成的评价和附近设施信息摘要。新增了 evChargeAmenitySummary、neighborhoodSummary、generativeSummary 和 reviewSummary 属性。

3.62.13e

2025 年 11 月 6 日

变更：

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

3.62.12c

2025 年 10 月 30 日

变更：

  • [Alpha 版渠道] 移除了实验性 ElevationElement。
  • 为 3D 地图 PopoverElement 添加了 background-color、border-radius、box-shadow 和 padding 的 CSS 变量。
  • 点击照片外部时，Places UI Kit 照片灯箱不再关闭。

3.62.11d

2025 年 10 月 23 日

变更：

  • [Alpha 版渠道] 使深色模式可用于突出显示地点上下文列表项。
  • 向 AdvancedMarkerElementOptions 添加了 anchorLeft 和 anchorTop 属性。
  • <gmp-pin> Web 组件现已推出。使用新的 glyphSrc 属性为字形提供图片网址，或使用 glyphText 属性显示文本。glyph 属性现已在 PinElement 上弃用。
  • 防止在视口之外创建关联的 AdvancedMarker 时意外显示 InfoWindow。
  • 3D 地图现已在每周渠道中推出。此版本包含新的罗盘控件和简化的默认界面控件；支持云端地图样式设置和协作手势处理；通过 Map3DElement 上的新 language 和 region 属性改进了本地化，并改进了基本地图标签的无障碍功能。如需了解详情，请参阅 Maps JavaScript 中的 3D 地图。
  • 改进了 3D 地图的内存管理，以避免 iOS 设备上出现内存不足问题。
  • 发布了 Routes JS。允许开发者进行 Routes API 调用，并使用 Maps JS API 绘制路线。

3.62.9c

2025 年 10 月 9 日

变更：

  • 向 AdvancedMarkerElement 添加了 anchorTop 和 anchorLeft 属性。这样，您就可以将标记的锚点更改为默认的底部中间位置以外的其他位置。

3.62.8d

2025 年 10 月 2 日

变更：

  • 为 Maps Embed API 启用了新的镜头控件。
  • [Beta 渠道] Map3DElement 类和 Map3DElementOptions 接口中的 defaultUIDisabled 属性已替换为 defaultUIHidden。defaultUIDisabled 将继续在 beta 渠道中运行。
  • [Beta 渠道] FlyAroundAnimationOptions 接口中的 rounds 属性已替换为 repeatCount。rounds 将继续在 beta 渠道中运行。
  • PlaceContextualElement 上的 mapMode 属性现已废弃。

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。这两个元素上的所有“coordinates”属性均已弃用，但仍可在 Beta 渠道中正常运行。

3.62.3c

2025 年 9 月 3 日

没有面向公众的变更。

3.62.2c

2025 年 8 月 28 日

变更：

3.62.1

2025 年 8 月 21 日

变更：

  • [Beta 渠道] 为 Address Validation API 添加了 sessionToken 和 placeAutocompleteElement 作为可选选项，用于在 AddressValidation.fetchAddressValidation() 中进行会话管理
  • [Beta 渠道] 推出了 Routes JS。允许开发者进行 Routes API 调用，并使用 Maps JS 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。允许用户在 ROADMAP、HYBRID 和 NONE 之间切换。
  • [Beta 渠道] 如果地图初始化失败（例如，由于用户的浏览器不支持 WebGL），Map3DElement 现在会触发事件。
  • 地图上的 45° 角航拍图像现已弃用。如需了解详情，请参阅弃用 - 45° 角航拍图像。

3.61.10d

2025 年 7 月 17 日

变更：

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

3.61.9a

2025 年 7 月 10 日

变更：

  • 更新了标记，以防止在使用屏幕阅读器时对每个项目重复导航说明。现在，每次进入群组时，系统只会播报一次说明。
  • 修复了深色模式下键盘快捷键对话框的对比度问题。
  • 为地点自动补全元素启用边框、边框半径、微件背景颜色和配色方案自定义支持。地点自动补全元素现在会自动遵循深色模式。如需停用此功能，请在 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 发布到不受限制的实验阶段。
  • [Alpha 版渠道] 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 的支持。
  • 确保启动时的静态地图叠加层与底层地图具有相同的 colorScheme。

3.60.7b

2025 年 4 月 3 日

变更：

  • 地点自动补全 widget 现已在每周渠道中推出。

3.60.6

2025 年 3 月 27 日

变更：

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

3.60.5（已回滚）

2025 年 3 月 20 日

变更：

  • 修复了点击或轻触高级标记时导致页面无法滚动的问题。
  • 修复了导致全屏模式在 <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 渠道] Polygon3DElement 和 Polyline3DElement 上的 altitudeMode 现在默认为 CLAMP_TO_GROUND。
  • [Alpha 版渠道] 现在必须在 Map3DElement 上设置新的 mode 选项，才能渲染 3D 地图（有 2 个新值 HYBRID 和 SATELLITE 可用）。现有的 defaultLabelsDisabled 选项已被移除，请将 mode 设置为 HYBRID 或 SATELLITE。
  • [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：types 已替换为 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 及更高级别的缩放级别显示。

早期版本说明

如需查看 2024 年及更早的版本说明，请参阅 Maps JavaScript API 版本说明归档。