Maps JavaScript API 版本说明

订阅这些版本说明。 订阅

Maps JavaScript API 团队会定期更新 API，以加入新功能、修复 bug 并提升性能。您可以在 Maps JavaScript API 引导程序请求的 v 参数中指定具体的版本号，从而指示要在应用中加载哪个版本的 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 图标后，POI 信息窗口无法通过 Escape 键关闭的问题。
  • 修复了键盘箭头键导航将焦点移至可见地图区域之外的 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 渠道] 向 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 时出现的路线 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”slot，以实现图标自定义。
  • 为 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 浏览器中呈现。
  • 地点库已为地点引入 isPureServiceAreaBusiness。现在，您可以在地点自动补全（Google Data API 和微件）和文本搜索请求中设置 pureServiceAreaBusinessesIncluded，以请求纯上门服务商家的结果。
  • 地点库已为地点引入 addressDescriptor、containingPlaces 和 timeZone。
  • 地点库已为地点引入 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 版] 新增了用于使用 Polygon3DElement 渲染圆圈的 CirclePathElement。
  • [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 支持。
  • 地点库针对已识别的地点引入了 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 部分 input

3.63.5d

2025 年 12 月 11 日

变更：

  • 在 Maps JavaScript API 中发布 Address Validation API
  • 现在，当设置为 null 或未定义时，mapTypeId 默认设置为 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 时出现的内存泄漏问题。
  • 修复了当 Map3DElement 动态添加到 DOM 并从 DOM 中移除时发生的内存泄漏问题。
  • 修复了在 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 渠道中发挥作用。
  • 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。这两个元素上的所有“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 日

变更：

  • 基本地点自动补全 widget 现已在每周更新的渠道中提供。
  • [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 上下文丢失添加了额外的处理。3D 地图现在会在 WebGL 上下文恢复时尝试自行恢复。

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 的支持。
  • 确保启动时的静态地图叠加层与底层地图具有相同的 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 版] altitudeMode 在 Polygon3DElement 和 Polyline3DElement 上现在默认为 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 channel] 推出了新的 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 及更深的缩放级别下显示。

3.59.3

2024 年 12 月 12 日

变更：

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

3.59.2

2024 年 12 月 5 日

变更：

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

3.59.1

2024 年 11 月 21 日

变更：

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

3.58.11a

2024 年 10 月 31 日

变更：

  • [Beta 渠道] 修复了导致街景小人在 Web 组件地图上无法使用的 bug。
  • 防止屏幕阅读器在 Embed API 地图上隐藏滚动消息时聚焦于该消息。

3.58.10

2024 年 10 月 24 日

变更：

  • 解决了访问会话存储空间时导致异常的问题。

3.58.9（已回滚）

2024 年 10 月 17 日

变更：

  • [Alpha 版渠道] 现在，您可以使用自定义图片和 SVG 来渲染 3D 地图上的标记。

3.58.8

2024 年 10 月 10 日

变更：

  • 移除了错误的 WebGLOverlayView 控制台警告。
  • 修复了以下问题：如果地图是网页上第一个与指针或鼠标互动的元素，Chrome 会错误地在地图周围显示蓝色焦点线。
  • 为 Mobility Services JavaScript Fleet Tracking 添加了 ODRD 车辆和车队位置信息提供程序。

3.58.7

2024 年 10 月 3 日

没有面向公众的更改。

3.58.6

2024 年 9 月 25 日

变更：

  • [Alpha 渠道] 从 Polyline3DElement 和 Polygon3DElement 中移除了 *Opacity 属性。您可以使用 #rgba、#rrggbbaa、rgba(r, g, b, a) 或 rgb(r g b / a) 颜色格式在相应的 *Color 属性中指定 Alpha 值。
  • [Alpha 渠道] 实验版 3D 地图现已支持默认界面控件、标记、3D 模型和预设镜头动画功能。
  • 修复了导致无法在矢量地图上切换自定义地图类型的 bug。
  • 对于像素密度较高的设备，请使用高 DPI 卫星图像。

3.58.5a

2024 年 9 月 19 日

没有面向公众的变更。

3.58.4a

2024 年 9 月 12 日

没有面向公众的更改。

3.58.3

2024 年 9 月 5 日

没有面向公众的变更。

3.58.2

2024 年 8 月 29 日

变更：

  • PinElement 的文字字形现在会随 PinElement 进行缩放，其默认颜色与 PinElement 的默认 glyphColor 相匹配。

3.58.1a

2024 年 8 月 22 日

变更：

  • [Beta 渠道] 默认将缩放控件替换为相机控件。相机控件同时具有缩放和平移控件。
  • 将 cameraControl 和 cameraControlOptions 属性发布到 MapOptions。
  • 允许在地图实例化时设置配色方案（浅色或深色）。
  • 更新地图类型控件，以便在地图宽度过小时换行
  • 集成了一个新的标签器，用于渲染矢量地图标签。
  • 对于不使用地图 ID 的开发者，新版基本地图颜色现在是 v=weekly 渠道中的默认颜色。如需了解详情，请参阅 https://developers.google.com/maps/new-basemap-style-opt-in。

3.57.13

2024 年 8 月 8 日

变更：

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

3.57.12

2024 年 8 月 1 日

变更：

  • [Beta 渠道] 为反向地理编码、正向地理编码和地点 ID 查找的地理编码响应添加了地址描述符。
  • [Beta 渠道] 允许在地图实例化时设置配色方案（浅色或深色）。
  • 减少在矢量地图中点击地图项时 IconMouseEvent 的延迟时间

3.57.10

2024 年 7 月 25 日

变更：

  • [Beta 渠道] 为反向地理编码、正向地理编码和地点 ID 查找的地理编码响应添加了地址描述符。
  • 向 Place 类添加了多个主要类型和显示名称属性。

3.57.9

2024 年 7 月 18 日

变更：

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

3.57.8b

2024 年 7 月 11 日

没有面向公众的变更。

3.57.7

2024 年 7 月 4 日

变更：

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

3.57.6a

2024 年 6 月 27 日

没有面向公众的变更。

3.57.5

2024 年 6 月 20 日

没有面向公众的更改。

3.57.4

2024 年 6 月 13 日

变更：

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

3.57.3a

2024 年 6 月 6 日

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

3.57.2

2024 年 5 月 28 日

变更：

  • 修复了 Web 组件中的地图类型控件无法打开菜单的问题。
  • 修复了导致 AdvancedMarkerElement 的拖动指示器缺失的 bug。
  • 为新版 Place API 添加自动补全功能。
  • 地图光栅图块现在以 WebP 图片格式提供。
  • 更新了 Place.searchByText 和 Place.searchNearby 的文档，以指向正确的字段列表。
  • 每周更新渠道中现已提供新的 InfoWindow 关闭按钮和可选的标题。

3.57.0

2024 年 5 月 24 日

没有面向公众的更改。

3.56.12a

2024 年 5 月 9 日

变更：

  • 修复了导致 AdvancedMarkerElement 的拖动指示器缺失的 bug。

3.56.11

2024 年 5 月 2 日

变更：

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

3.56.10

2024 年 4 月 25 日

变更：

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

3.56.8

2024 年 4 月 11 日

变更：

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

3.56.7

2024 年 4 月 4 日

变更：

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

3.56.6

2024 年 3 月 28 日

变更：

  • [Beta 渠道] 地图光栅图块现在以 WebP 图片格式提供。
  • 修复了矢量地图上地图内 POI 的信息窗口锚点位置。
  • 修复了以下 bug：AdvancedMarkerElement 在显示时没有设置位置。
  • 向 InfoWindow API 添加了“close”事件。

3.56.5

2024 年 3 月 21 日

变更：

  • [Beta 渠道] 对于未使用地图 ID 的开发者，新的基本地图颜色现在是默认颜色。如需了解详情，请参阅 https://developers.google.com/maps/new-basemap-style-opt-in。
  • 修复了矢量地图标签和图标的信息窗口的基本位置。

3.56.4

2024 年 3 月 14 日

没有面向公众的变更。

3.56.3

2024 年 3 月 7 日

没有面向公众的更改。

3.56.1

2024 年 2 月 22 日

变更：

  • 修复了 Place.searchByText 的“fields”参数中的文档错误。
  • [Beta 渠道] 在 <gmp-map> 中创建默认槽，并允许创建自定义元素来封装 Maps JavaScript API Web 组件。
  • 向新的 Place 类 API 添加了停车选项。
  • 弃用 google.maps.Marker。请改为使用 google.maps.marker.AdvancedMarkerElement。目前，google.maps.Marker 尚未规划停用时间，但建议优先使用 google.maps.marker.AdvancedMarkerElement，而非 google.maps.Marker。虽然 google.maps.Marker 仍会针对任何重大回归问题提供 bug 修复，但 google.maps.Marker 中的现有 bug 将不再处理。服务停用前，我们将至少提前 12 个月发出通知。如需了解弃用详情，请访问 https://developers.google.com/maps/deprecations。
  • 向新的 Place 类 API 添加了其他属性。
  • 向新的 Place 类 API 添加支付方式。

3.55.11a

2024 年 2 月 15 日

变更：

  • 防止地图在点击时自动滚动到视图中。

3.55.11

2024 年 2 月 8 日

变更：

  • [Alpha 渠道] 从 PlaceAutocompleteElement 中移除了 inputElement 属性。
  • [Alpha 渠道] 为地点自动补全元素添加 CSS 部分
  • [Beta 渠道] PlaceAutocompleteElement 现已发布预览版 (v=beta)
  • 向 Places V2 API 添加了无障碍选项。

3.55.10

2024 年 2 月 1 日

变更：

  • [Beta 渠道] 弃用了 SearchByTextRequest.rankBy。请改用 SearchByTextRequest.rankPreference。
  • [Beta 渠道] Place.findPlaceFromQuery 和 Place.findPlaceFromPhoneNumber 已无法使用；请改用 Place.searchByText。
  • 修复了按渠道跟踪用量的问题。
  • 在 JavaScript Journey Sharing 中为 Trip 和车辆位置信息提供程序启用可感知流量的多段线。
  • 新的 Place 类现已在每周渠道中推出。
  • 弃用了 Place.openingHours。请改用 regularOpeningHours。

3.55.9

2024 年 1 月 25 日

变更：

  • [Beta 渠道] 修复了以下问题：在 MapElement 上按 Esc 键时，无法关闭键盘快捷键对话框。
  • 为直接脚本加载的引导网址添加了新的网址参数 loading=async。这表示 Maps JavaScript API 未同步加载，并且脚本的 load 事件未触发任何 JavaScript 代码。强烈建议您尽可能将此值设置为 async，以提高性能。

3.55.8

2024 年 1 月 18 日

变更：

  • [Alpha 渠道] 现在，系统会在 PlaceAutocompleteElement 请求中发送会话令牌。
  • [Beta 渠道] 在 AdvancedMarkerElement 中引入了新属性 gmpClickable。对于在 Beta 渠道中使用 addEventListener() 注册 gmp-click 事件的用户，这是一项破坏性更改。如需在点击时接收 gmp-click 事件，请将 gmpClickable 属性设置为 true，或向 Web 组件添加 gmp-clickable 属性。对于使用 addListener() 注册 gmp-click 事件的用户，目前无需进行任何更改。

3.55.7

2024 年 1 月 11 日

变更：

  • [Beta 渠道] AdvancedMarkerElement 的 element 属性现在指向 AdvancedMarkerElement 的实例。
  • [Beta 渠道] 高级标记现在可以使用子节点自定义内容。
  • 修复了点击地图后平移和缩放键盘快捷键不起作用的 bug。
  • 为 JavaScript 行程分享功能启用多段线自定义。
  • [Alpha 渠道] 向 PlaceAutocomplete 添加了 types、requestedLanguage、requestedRegion 和 name 属性
  • [Beta 渠道] 修复了导致调用 document.createElement('gmp-advanced-marker') 时无法创建高级标记元素的 bug。

3.55.3

2023 年 11 月 30 日

没有面向公众的变更。

3.55.2

2023 年 11 月 23 日

变更：

  • 修复了导致街景中出现与样式相关的 CSP 错误的 bug

3.55.1

2023 年 11 月 16 日

没有面向公众的变更。

3.54.12a

2023 年 11 月 8 日

变更：

  • 修复了导致 WebGLOverlayView 在某些情况下无法渲染的 bug。

3.54.12

2023 年 11 月 2 日

变更：

3.54.11

2023 年 10 月 26 日

变更：

  • 修复了在地图上设置控件可能会抛出错误的问题。
  • 添加了通过 StreetViewLocationRequest 和 StreetViewControlOptions 将街景图像限制为仅来自 Google 官方来源的功能。

3.54.10

2023 年 10 月 18 日

变更：

  • [Beta 渠道] MapElement 现在会根据其计算出的 direction 样式，自动调整其控件布局，以适应从左到右或从右到左的阅读方向。此外，还提供用于添加自定义控件的 slot。ControlPosition 现在支持逻辑值，以便支持 LTR/RTL 布局。现在，Maps Embed API 还会根据语言自动调整其控件布局，以适应从左到右或从右到左的阅读习惯。
  • [Beta 渠道] MapElement 现在已启用 delegatesFocus

3.54.9

2023 年 10 月 12 日

  • [Beta 渠道] 向 Places v2 API 添加了编辑摘要。

3.54.7a

2023 年 9 月 28 日

变更：

  • 在行程分享 JavaScript 中添加了对多个位置信息提供方的支持。

3.54.6

2023 年 9 月 21 日

变更：

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

3.54.5

2023 年 9 月 14 日

变更：

  • [Beta 渠道] 修复了导致 AdvancedMarkerElement 的 addEventListener() 不可用的 bug。

3.54.4

2023 年 9 月 7 日

变更：

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

3.54.2

2023 年 8 月 24 日

变更：

  • 修复了 DirectionsRenderer 中的一个 bug：如果在呈现 DirectionsResult 之前未设置缩放比例和中心，地图将无法加载。

3.54.1

2023 年 8 月 18 日

变更：

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

3.53.13

2023 年 7 月 27 日

变更：

  • [Beta 渠道] 新 Place 类中的提供方信息已重构。PhotoAttribution 现为 AuthorAttribution。author 现更名为 displayName。authorURI 现更名为 uri。photoURI{?string}现已在AuthorAttribution上架。Photo.attributions 现更名为 Photo.authorAttributions。Review.authorAttribution {?AuthorAttribution} 取代了 Photo.author/authorURI/authorPhotoURI。
  • [Beta 渠道] 在 Place 类的 searchByText() 方法中添加了必填字段 textQuery，并弃用了 query。
  • 调整了光栅地图标签和图标的信息窗口锚点偏移量。

3.53.12

2023 年 7 月 20 日

变更：

  • [Beta 渠道] 为 JavaScript 行程分享添加了 ODRD 车辆和车队位置信息提供程序 - 车队跟踪。
  • 更新了在传递给 LatLng() 构造函数的参数被忽略时显示的警告消息。
  • 废弃了 Marker.collisionBehavior，取而代之的是 AdvancedMarkerElement.collisionBehavior。

3.53.11

2023 年 7 月 13 日

变更：

  • 如果指定点足够接近多段线的起点或边缘，函数 isLocationOnEdge() 现在会返回 true。
  • 添加了错误日志，以便在矢量地图加载失败并回退到光栅地图时通知开发者。

3.53.7

2023 年 6 月 15 日

变更：

  • [Alpha 渠道] 更新了地点自动补全元素，以更好地支持屏幕阅读器和其他辅助技术。

3.53.5

2023 年 6 月 1 日

变更：

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

3.53.4a

2023 年 5 月 24 日

bug 修复：

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

3.53.3

2023 年 5 月 18 日

变更：

  • [Alpha 渠道] 修复了以下 bug：如果您使用箭头键突出显示联想查询，然后点击“Esc”键，地点自动补全元素不会恢复原始文本。
  • [Alpha 渠道] 更新了地点自动补全联想查询样式，以确保在文本溢出时显示省略号。
  • [Beta 渠道] Local Context 现在会显示一条通知，告知用户 Local Context 地图上的地点情境信息即将停用。
  • 修复了以下 bug：除非街景小人已至少返回到停靠栏一次，否则不会显示拖动悬停预览。
  • 已弃用的地点自动补全服务中的 bounds、location 和 radius。请改为使用 locationBias 和 locationRestriction。

3.53.2

2023 年 5 月 4 日

变更：

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

3.53.1a

2023 年 4 月 27 日

变更：

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

3.52.9

2023 年 4 月 13 日

变更：

  • [Beta 渠道] 将 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 会导致错误的 bug。

3.52.8

2023 年 4 月 6 日

变更：

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

bug 修复：

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

3.52.6

2023 年 3 月 23 日

变更：

  • [Alpha 渠道] 发布了地点自动补全微件（新）（实验性）。
  • 向每周渠道发布 JavaScript 行程分享。

3.52.5

2023 年 3 月 16 日

变更：

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

bug 修复：

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

3.52.4

2023 年 3 月 9 日

变更：

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

3.52.3

2023 年 3 月 2 日

变更：

  • [Beta 渠道] 为 JavaScript 旅程分享添加了 TaskTrackingInfo 实体。
  • [Beta 渠道] 升级了 Maps JavaScript API，以原生支持 ECMAScript 2020。

bug 修复：

  • 修复了在地图中添加和移除标记时可能发生的内存泄漏问题。
  • 修复了以下 bug：在触摸设备上，当互动元素位于可点击的高级标记下方时，该互动元素仍可点击。

3.52.2

2023 年 2 月 23 日

变更：

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

3.52.1

2023 年 2 月 16 日

变更：

  • 添加了 importLibrary() 函数，该函数可在运行时动态加载库。
  • [Beta 渠道] 启用 InfoWindow 在高级标记上打开时的自动平移功能。
  • [Beta 版渠道] 将 Journey Sharing 库数据对象中的某些字段设为不可为 null
  • [Beta 渠道] 数据驱动型样式：NEIGHBORHOOD、ADMINISTRATIVE_AREA_LEVEL_3、ADMINISTRATIVE_AREA_LEVEL_4 和 SUBLOCALITY_LEVEL_1 FeatureType 已被弃用。这些功能将于 2023 年 3 月移除。

3.51.8

2023 年 2 月 2 日

变更：

  • Beta 渠道：支持在自定义地图类型上渲染高级标记。
  • 最新版本的内嵌引导加载程序现在将重用在文档其他位置找到的 CSP 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：将高级标记与 InfoWindow 搭配使用时，使用键盘拖动标记后，InfoWindow 可能无法打开。

3.51.4

2023 年 1 月 5 日

变更：

  • Beta 渠道：向地点类添加新属性
  • Beta 渠道：如果点击位置有多个地图项，则数据驱动型样式 FeatureMouseEvent.features 数组可能包含多个地图项，并且点击位置的所有 FeatureLayer 点击监听器都会触发。
  • Beta 渠道：如果 google.maps.Map.getFeatureLayer 的参数无效，则会抛出错误。
  • 更正了全屏地图上高级标记的像素位置。
  • 更改了地图鼠标事件，现在会忽略在已按下某个鼠标按钮的情况下发生的其他鼠标按钮点击。
  • 修复了导致高级标记在放大地图时消失的问题。
  • 改进了在缩放包含许多高级标记的地图时的性能。
  • 更新了 StreetViewPanoramaOptions 文档，以明确说明 clickToGo 不适用于自定义全景图片。
  • 提高了创建 LatLngBounds（包括通过 Map.getBounds() 创建）时的性能。
  • 更新了 onAdd 和 onRemove 的 WebGLOverlayView 引用。
  • 为行程分享添加了固定标记样式自定义功能。

3.51.3

2022 年 12 月 8 日

变更：

  • 修复了以下 bug：当标记位于地图视口之外时，无法放弃其键盘焦点。
  • Beta 渠道：引入了 Place 类，这是一个更简单的新 API，支持 promise 等新型使用模式。Place 类包含一些新数据字段。
  • Beta 渠道：修复了在传递封装在代理中的地图时导致高级标记无法呈现的 bug。
  • Beta 渠道：为 JavaScript 行程分享添加了行程位置信息提供程序标记自定义功能。

3.51.2

2022 年 12 月 1 日

变更：

  • Beta 版渠道：google.maps.importLibrary() API 现已推出。
  • Beta 渠道：已弃用：Local Context 已弃用，不再建议新网站使用。此功能可继续正常使用；我们若计划停止支持，会提前 12 个月发出通知。如果您有兴趣自行打造类似于 Local Context 的体验，建议您在快速构建器中查看“街区探索”解决方案或使用 Places Library, Maps JavaScript API。 地点库的代码示例和 Codelab 可以为您提供帮助。
  • Beta 渠道：为了改进 Core Web Vitals 并减少不必要的数据传输，Maps JS 现在会延迟加载地图图块，直到地图接近视口。在网页的初始视口内创建的地图应该不会有任何区别。
  • Beta 版渠道：为 Journey Sharing 位置信息提供程序添加了轮询状态更改事件。
  • Beta 渠道：为行程分享添加了样式自定义功能。弃用了较旧的设置方法。
  • 为“路线”面板的各个步骤添加了键盘无障碍功能。现在，您可以使用 Tab 键浏览路线，并使用空格键或 Enter 键选择路线。
  • google.maps.geometry.spherical.computeArea() 现在接受 LatLngBounds 和 Circle。现在可以使用 LatLngBoundsLiteral 构建 LatLngBounds。
  • 在 DirectionRenderer 的建议路线面板中为图片添加 alt 文本。

3.51.1

2022 年 11 月 17 日

变更：

  • Beta 渠道：发布了 Places 库中的 Place 类。
  • Beta 渠道：为行程分享添加了样式自定义功能。旧版设置方法已弃用。
  • Maps Embed API 现已停用 Internet Explorer 11。
  • 在 Maps Embed API 中，使用混合或卫星地图类型时，Google 徽标会更改样式，以提高可见性
  • 提升了高级标记的加载性能。
  • 使绘制“撤消”按钮可通过键盘访问，并对屏幕阅读器友好。
  • 使路线渲染器的标记可通过键盘访问，并支持屏幕阅读器。
  • 向地图比例尺控件添加了 ARIA 说明。
  • 为地图的比例控件启用键盘焦点和互动。
  • 在 Geocoder JS API 中引入了语言参数。如果未明确指定，Maps JS API 不再将 US 视为 Geocoder 中的默认区域。
  • 在 Directions JS API 中引入了语言参数。
  • 为 Distance Matrix JS API 引入了语言参数。

bug 修复：

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

3.51

2022 年 11 月 16 日

变更：

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

3.50.12a

2022 年 11 月 7 日

变更：

  • 修复了 google.maps.event.addListenerOnce 和 google.maps.event.addDomListenerOnce 具有不正确的 this 绑定问题。

3.50.12

2022 年 11 月 3 日

变更：

  • Beta 渠道：高级标记现在支持在倾斜地图上使用海拔高度。

3.50.11

2022 年 10 月 27 日

变更：

  • Beta 渠道：现在，当数据驱动型样式地图项图层不可用时，系统会记录错误。
  • Beta 渠道：改进了默认高级标记的加载性能。

3.50.10

2022 年 10 月 20 日

bug 修复：

  • 修复了 iOS 上的 InfoWindow 右侧和底部内边距。

3.50.9

2022 年 10 月 13 日

变更：

  • 所选步骤现在会在路线面板中突出显示。
  • 修复了 PinView 构造函数的 TypeScript 类型。
  • 修复了 LagLngAltitude 构造函数的 TypeScript 类型。
  • 更新 DirectionsRenderer 中的默认标记图标图片。

3.50.8

2022 年 10 月 6 日

变更：

  • Beta 渠道：高级标记预览版已发布。
  • Beta 渠道：针对 getMapCapabilities() 返回对象中的 isAdvancedMarkersAvailable 添加了文档。
  • 将“此字段为只读”添加到 LocalContextMapView 的 API 说明和 LocalContextMapViewOption 的 element 属性中

bug 修复：

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

3.50.7

2022 年 9 月 29 日

变更：

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

3.50.6

2022 年 9 月 22 日

bug 修复：

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

变更：

  • 现在，当调用 map.getMapCapabilities() 且出现错误时，系统会将错误记录到控制台。

3.50.5

2022 年 9 月 15 日

变更：

  • 为 LatLngBounds 添加了 MAX_BOUNDS 常量，用于指示地图的最大 LatLng 边界
  • 允许屏幕阅读器对默认标记执行点击操作。

3.50.3

2022 年 9 月 1 日

变更：

  • Beta 渠道：更新了 JavaScript 行程共享的 DeliveryVehicle 类，以包含自定义属性。
  • 修复了以下 bug：地图倾斜后，事件中的 LatLng 不正确。

3.50.2

2022 年 8 月 25 日

变更：

  • Beta 渠道：更改了 FleetEngineDeliveryFleetLocationProvider 以接受字符串传送载具过滤条件。
  • 更新默认标记图标图片。

3.50.1

2022 年 8 月 18 日

变更：

  • Beta 渠道：向 Beta 渠道引入了地图功能 API（getMapCapabilities 和 mapcapabilities_changed 事件）。
  • Beta 渠道：向 google.maps.Geocoder 引入了 language 参数。
  • Beta 渠道：向 google.maps.DistanceMatrixService 引入了 language 参数。
  • Beta 渠道：向 google.maps.DirectionsService 引入了 language 参数。
  • 修复了多个 Places JS API 中忽略地区代码的 bug。为各种 Place JS API 引入了语言和区域参数。
  • 移除了 Maps JavaScript API 街景中对内容安全政策设置中不含 googleapis.com 网域的网站的支持。如需了解详情，请参阅内容安全政策指南。

3.49.12

2022 年 8 月 4 日

变更：

  • 添加 DEMO_MAP_ID，这是一个地图 ID，可用于需要地图 ID 的代码示例。此地图 ID 不适用于生产应用，也不能用于需要云配置的功能（例如云端样式设置）。
  • 阐明需要 FleetEngineDeliverFleetLocationProvider.locationRestriction 才能开始跟踪。

3.49.11

2022 年 7 月 28 日

变更：

  • 现在，google.maps.VehicleType 可以作为运行时枚举进行引用。

3.49.10

2022 年 7 月 21 日

变更：

  • 验证标记图标大小、标记图标缩放大小或信息窗口大小时，系统会拒绝宽度或高度的 NaN 值。
  • 修复了在 iOS 设备上使用街景时动作追踪控件不可见的 bug。
  • 修复了以下 bug：在 Embed API 中，从右到左 (RTL) 语言的路线悬停文本会被截断。
  • 使公交信息窗口更易于访问，并更适合屏幕阅读器。

3.49.9

2022 年 7 月 14 日

变更：

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

3.49.8

2022 年 7 月 7 日

变更：

  • 使街景导航链接支持键盘操作，并对屏幕阅读器友好。
  • 在 StreetViewPanorama 中引入了新的 focus 方法。

3.49

2022 年 6 月 23 日

变更：

bug 修复：

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

3.49.5

2022 年 6 月 16 日

变更：

  • 向街景添加了键盘快捷键控件和对话框，从而提高了键盘快捷键的可发现性。

bug 修复：

  • 修复了导致表单在关闭街景时提交的 bug。

3.49.4

2022 年 6 月 9 日

变更：

  • 将 WebGLOverlayView、CameraParams、LatLngAltitude、moveCamera、分数缩放和 getVisibleRegion 移至每周频道。
  • 现在，Map 的默认街景全景图片在打开时会自动管理焦点。这是新的默认行为。
  • 现在，街景全景图片在关闭时会自动恢复焦点（如果可能）。
  • 现在，当关闭按钮处于启用状态时，您可以按 ESC 键关闭街景。
  • geometry.spherical.computeSignedArea() 和 geometry.spherical.computeArea() 经过优化，可提高稳健性和准确性。

3.49.3a

2022 年 6 月 2 日

变更：

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

3.49.2

2022 年 5 月 26 日

变更：

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

3.49.1

2022 年 5 月 19 日

变更：

  • Beta 渠道：修复了多个 Places JS API 中忽略地区代码的 bug。为各种 Place JS API 引入了语言和地区参数。
  • 提高了深色模式下全屏和罗盘控件的色彩对比度。
  • 使街景罗盘控件、关闭按钮和地址链接控件可供屏幕阅读器读取。

3.49

2022 年 5 月 12 日

变更：

  • 每周渠道更新至版本 3.49。
  • 季度渠道更新至版本 3.48。
  • 3.47 和 3.46 版 API 仍可按编号请求。
  • 版本 3.45 已被删除，无法再使用。

3.48.11

2022 年 4 月 28 日

变更：

  • 地点自动补全功能现在可以接受更多类型。 了解详情。
  • isFractionalZoom 已移至每周频道。

3.48.9

2022 年 4 月 14 日

变更：

  • Beta 版渠道：为 WebGLOverlayView 启用 WebGL 2.0。
  • Beta 渠道：将 JourneySharing 库纳入 Maps JavaScript API TypeScript 类型、外部声明和参考文档中。
  • 函数 google.maps.event.addDomListener() 和 google.maps.event.addDomListenerOnce() 已弃用，不应继续使用。请改用标准 addEventListener() 方法。这些方法仍继续有效，并且我们不打算停用它们。
  • 向街景标记图标添加 title 和 aria-label。
  • 向全屏控件添加了 aria-pressed 属性。
  • 改进了地图类型控件的下拉菜单的间距。
  • 更新了地图类型下拉菜单控件的 aria 标签。

bug 修复：

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

3.48.8

2022 年 4 月 7 日

变更：

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

3.48.7a

2022 年 3 月 31 日

变更：

  • Beta 渠道：移除了已弃用的 WebGL 叠加视图 API。
  • 为 Maps JavaScript API 客户启用更新后的基本地图。更新后的基本地图已在面向消费者的 Google 地图中投入使用，可提供更丰富、更详细的基本地图，尤其是在陆地自然地貌方面。

bug 修复：

  • 还原了 map.fitBounds() 的先前修复（简化了短距离的视口过渡），有待分析。
  • 修复了高色彩对比度模式下地图类型控件的色彩对比度问题。
  • 将地图类型控件复选框的无障碍名称与相应的视觉标签进行匹配。
  • 修复了高色彩对比度模式下信息窗口中的色彩对比度问题。

3.48.6

2022 年 3 月 24 日

变更：

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

3.48.5

2022 年 3 月 17 日

变更：

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

bug 修复：

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

3.48.4

2022 年 3 月 10 日

变更：

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

3.48.3

2022 年 3 月 3 日

变更：

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

3.48.1

2022 年 2 月 17 日

变更：

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

3.48

2022 年 2 月 10 日

变更：

  • 每周渠道已更新至版本 3.48。
  • 季度渠道已更新至版本 3.47。
  • 如果按编号请求，版本 3.46 和 3.45 仍可使用。

3.47.6

2022 年 1 月 20 日

bug 修复：

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

3.47.4

2022 年 1 月 6 日

变更：

  • Beta 渠道：Beta 版 WebGLOverlayView API 更新 - 弃用名称中包含“gl”的所有类和方法，改用名称中包含“GL”的新类和方法；弃用 WebglCameraParams，改用新的 CameraParams 类（CameraOptions 的子类）。
  • 更新了 PlaceOpeningHours 方法文档，以反映其计算中不使用特殊营业时间。

3.47.3

2021 年 12 月 9 日

变更：

  • LatLng、LatLngBounds 和 Circle 现在接受构造函数中同一类的实例。

3.47.2

2021 年 12 月 2 日

变更：

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

bug 修复：

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

3.47

2021 年 11 月 11 日

变更：

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

3.46.12

2021 年 11 月 4 日

bug 修复：

  • 更新了“地图类型”菜单栏，使其具有更准确的 ARIA 标签。
  • 嵌入 API：为多个链接添加了 ARIA 标签，以改善屏幕阅读器体验。
  • Embed API：修正了某些文本项的颜色对比度。
  • 修复了 externs 中 google.maps.Marker.MAX_ZINDEX 的类型。

3.46.11

2021 年 10 月 28 日

变更：

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

3.46.8

2021 年 10 月 7 日

变更：

  • Local Context：从 Local Context 信息窗口照片中移除了提供方信息链接。

3.46.6

2021 年 9 月 23 日

变更：

  • 修复了以下 bug：当地图不可拖动时，地图光标显示为手形。

3.46.5

2021 年 9 月 16 日

bug 修复：

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

3.46.3

2021 年 9 月 2 日

变更：

  • 滚动说明现在会显示在打开的 InfoWindow 和 CustomOverlay 上方。

3.46.2

2021 年 8 月 26 日

变更：

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

3.46

2021 年 8 月 18 日

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

变更：

  • 向 PlaceResult 添加了两个新字段：icon_mask_base_uri 和 icon_background_color。
  • 每周渠道已更新至版本 3.46。
  • 季度渠道提供的版本已更新至版本 3.45。
  • 按编号请求时，版本 3.44 仍然可用。
  • 版本 3.43 已被删除，无法再使用。

弃用：

  • 我们正在弃用对 Internet Explorer 的支持。从 2021 年 8 月开始，使用 Maps JavaScript API v3.46 的 Internet Explorer 11 用户会在地图顶部看到一条警告消息。支持 Internet Explorer 11 的最后一版 Maps JavaScript API 是 v3.47。我们将于 2022 年 11 月完全停止对 Internet Explorer 11 的支持。

bug 修复：

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

3.45.8

2021 年 7 月 29 日

变更：

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

3.45.7

2021 年 7 月 22 日

变更：

  • 对 IE11 的支持已弃用。现在，IE11 中的地图将在 Beta 渠道中显示横幅。
  • 更新了嵌入式地图中的“获取路线”链接，使其更加准确。

bug 修复：

  • 修复了 getFeatureById() 方法无法检索 ID 为 0 的功能的问题。
  • 修复了如果 ComponentRestriction 值为未定义或 null，则会抛出 UNKNOWN ERROR/SERVICE BACKGROUND ERROR 的问题。

3.45.6a

2021 年 7 月 15 日

变更：

  • 现在，当第一个可聚焦控件不在 InfoWindow 视口中或 disableAutoPan=true 时，焦点会在打开时移至 InfoWindow 容器。

bug 修复：

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

3.45.5

2021 年 7 月 1 日

变更：

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

bug 修复：

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

3.45.4

2021 年 6 月 24 日

变更：

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

3.45.3

2021 年 6 月 16 日

bug 修复：

  • 更新了 InfoWindow，以便在 open() 与地图实例化位于同一运行循环中时，焦点不会移动。

变更：

  • 更新了 InfoWindowOpenOptions API 参考文档部分，提供了更详细的信息。
  • 修复了在 Safari 中使用键盘导航（Tab + Option）时的焦点环问题。

3.45.2

2021 年 6 月 10 日

bug 修复：

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

变更：

3.45.1

2021 年 6 月 3 日

变更：

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

bug 修复：

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

新功能：

  • 在以下服务中启用了对 Promise 的支持：路线、距离矩阵、海拔、地理编码器、最大缩放比例影像、StreetView 和 AutcompleteService.getPlacePredictions()。
  • 在地图上添加了键盘快捷键控件和对话框，以便用户更容易发现键盘快捷键。
  • 矢量地图现已在每周渠道中推出（仅限基本功能；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 修复：

  • 修复了在初始化基本地图之前加载静态标记时可能出错的问题。

3.44.9

2021 年 4 月 8 日

bug 修复：

  • 修复了在启用街景时，地图控件可通过键盘访问的 bug。

3.44.8

2021 年 4 月 1 日

变更：

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

3.44.7

2021 年 3 月 25 日

变更：

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

3.44.4

2021 年 3 月 4 日

变更：

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

bug 修复：

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

3.44.2

2021 年 2 月 25 日

变更：

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

3.44.1

2021 年 2 月 18 日

变更：

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

3.43.8a

2021 年 2 月 25 日

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

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

3.43.8

2021 年 2 月 5 日

变更：

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

bug 修复：

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

3.43.7a

2021 年 1 月 28 日

bug 修复：

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

3.43.6

2021 年 1 月 21 日

bug 修复：

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

3.43.5

2021 年 1 月 14 日

变更：

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

bug 修复：

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

3.43.3

2020 年 12 月 9 日

变更：

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

bug 修复：

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

3.43.2

2020 年 12 月 1 日

变更：

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

bug 修复：

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

3.43.1a

2020 年 11 月 20 日

变更：

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

bug 修复：

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

3.43

2020 年 11 月 18 日

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

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

3.42.9

2020 年 10 月 15 日

变更：

  • 修复了屏幕阅读器传达了错误的复选框状态的 bug。
  • 修复了地图控件中 Tab/Shift+Tab 顺序错误的问题。
  • 将地图按钮从 div 转换为原生按钮，以提高无障碍性。
  • 现在，WebGL 地图的倾斜度会根据缩放级别受到限制。
  • 修复了以下问题：当 controlSize 小于 27 时，全屏按钮在 Internet Explorer 上部分消失。

3.42.8

2020 年 10 月 7 日

变更：

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

支持更新后的地点图标

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() 实现时，系统会将错误记录到控制台。
  • 在 Elevation 服务方法中添加了对 Promise 的 Beta 版支持。
  • 引入了新的 InfoWindow.minWidth 属性，用于指定 InfoWindow 的最小宽度。
  • 修复了更改目的地后路线变得模糊的 bug。

3.42

2020 年 8 月 19 日

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

变更：

  • 信息窗口现在的默认最大宽度为 648 像素，您可以通过设置 InfoWindow maxWidth 属性来替换此值。InfoWindow 的宽度现在可以超过 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 日

变更：

  • Maps JavaScript API 地点库中的“地点”字段 permanently_closed 已弃用。

3.41

2020 年 5 月 20 日

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

  • 每周渠道已更新至版本 3.41。
  • 季度渠道已更新至版本 3.40。
  • 如果按编号请求，版本 3.39 仍然可用。
  • 版本 3.38 已被删除，无法再使用。

3.40.11

2020 年 4 月 28 日

变更：

  • 向地点搜索和地点详情结果中添加了一个新字段 business_status。请使用此字段，而非 permanently_closed。
  • 修复了请求（新）PlaceResult.utc_offset_minutes 时出现的错误控制台警告；现在，系统会针对已弃用的 PlaceResult.utc_offset 返回警告。

3.40.9

2020 年 4 月 14 日

变更：

  • 如果传递的 mapDiv 不是 Element，Map 现在会抛出更易于诊断的 InvalidValueError。
  • Chrome 浏览器将地址自动填充到 google.maps.places.Autocomplete 中时，不应再触发向服务器发送的自动补全请求（这样可以避免产生费用）。
  • 提高了 maxWidth 属性的准确性。在此变更生效之前，如果您将 InfoWindow 的 maxWidth 指定为 100，则 InfoWindow 的实际最大宽度为 94 像素。 此项更改生效后，最大宽度实际上将为 100 像素。
  • 修复了使用标记和地图边界时绘制请求构建器出现的内存泄漏问题。

3.40.6

2020 年 3 月 24 日

变更：

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

3.40.4

2020 年 3 月 10 日

变更：

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

3.40.2

2020 年 2 月 23 日

变更：

  • 已从标签页导航中移除地图内的隐藏 iframe。

3.40.1

2020 年 2 月 18 日

变更：

  • 对于 v=beta，不发出有关 InvalidVersion 的警告。
  • 修复了显示街景时出现的滚动问题。

3.40

2020 年 2 月 11 日

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

  • 每周渠道已更新至版本 3.40。
  • 季度渠道已更新至版本 3.39。
  • 按编号请求时，版本 3.38 仍然可用。
  • 版本 3.37 已被删除，无法再使用。

3.39.6

2020 年 1 月 8 日

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

已修复：

  • 对于路线请求，ZERO_RESULTS 现在会记录到控制台，而不会再导致错误日志。

3.39

2019 年 11 月 20 日

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

变更：

  • 我们已不再支持 Internet Explorer 10（3.38 版是支持该浏览器的最后一个版本）。
  • AutocompletePrediction 现在会返回从指定原点纬度/经度到所选地点的直线距离。

弃用：

  • “地点”字段 open_now 和 utc_offset 自 2019 年 11 月 20 日起弃用，自 2021 年 2 月 20 日起停用。如需了解详情，请参阅“地点”字段迁移。
  • 每周渠道已更新至版本 3.39。
  • 季度渠道已更新至版本 3.38。
  • 如果按编号请求，版本 3.37 仍然可用。
  • 版本 3.36 已被删除，不能再使用。

3.38

2019 年 8 月 20 日

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

  • 每周渠道已更新至版本 3.38。
  • 季度渠道已更新至版本 3.37。
  • 如果按编号请求，版本 3.36 仍然可用。
  • 版本 3.35 已被删除，无法再使用。
  • Fusion Tables 不再可用（3.37 版是支持它的最后一个版本）。
  • 对 Internet Explorer 10 的支持现已弃用，并将于 2019 年 11 月至 2020 年 5 月期间终止，具体取决于您使用的发布渠道或版本号。

3.37

2019 年 5 月 15 日

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

  • 每周渠道已更新至版本 3.37。
  • 季度渠道已更新至版本 3.36。
  • 版本 3.35 仍可按编号请求。
  • 版本 3.34 已被删除，不能再使用。
  • Internet Explorer 9 无法再使用（3.34 是支持它的最后一个版本）。

3.36

2019 年 2 月 14 日

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

变更：

  • 添加的新功能：
  • 信息窗口已得到改进。
  • 每周渠道已更新至版本 3.36。
  • 季度渠道已更新至版本 3.35。
  • 按编号请求时，版本 3.34 仍然可用。
  • 版本 3.33 已被删除，无法再使用。

3.35

2019 年 1 月 29 日

变更：

  • 该 API 现在可以返回每个地点的评价总数。
  • 添加了对 Plus Code 的支持。Plus Code 是简短的代码，可为世界上每个地点提供地址，即使在没有传统街道地址的区域也是如此。
  • 我们已不再支持 Internet Explorer 9。

弃用：

  • Autocomplete 的 placeIdOnly 参数已弃用。
  • Maps JavaScript API 中的 Fusion Tables 图层自 2018 年 12 月 3 日起弃用。 Fusion Tables 图层将于 2019 年 12 月 3 日完全停用，此后将不再提供。 了解详情。

2018 年 11 月 13 日

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

变更：

  • 每周渠道已更新至版本 3.35。
  • 季度渠道已更新至版本 3.34。
  • 如果按编号请求，版本 3.33 仍然可用。
  • 版本 3.32 已被删除，无法再使用。

3.34

2018 年 8 月 14 日

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

变更：

  • 已实现新的版本名称。 您现在可以指定发布渠道或版本号：
    • 每周渠道已更新至版本 3.34。
    • 季度渠道已更新至版本 3.33。
    • 版本 3.32 仍可使用。
    • 版本 3.31 已被删除，不能再使用。 指定版本 3.0 至 3.31 的客户将改为采用其默认渠道，即每周渠道或季度渠道（请参阅版本控制指南）。
  • 现在，系统会启用更大的控制界面。 随着各种设备上触控操作的增加，我们调整了控制界面，使其既适合手指触控，也适合鼠标点击。 （您可以通过加载 v=quarterly、v=3.33 或 v=3.32 的 API 来选择停用。）

3.33

2018 年 6 月 11 日

变更：

2018 年 5 月 16 日

Maps JavaScript API 3.33 版现已作为实验性版本推出。 请参阅 API 版本控制指南。

变更：

3.32

2018 年 2 月 13 日

变更：

3.31

2018 年 2 月 13 日

变更：

  • 默认情况下，将前 256 个标记设为 DOM 标记，然后将后续标记设为图块标记。当前默认设置为所有图块标记。
  • 在高缩放级别（放大）下拖动街景小人时，首选 NEAREST，而不是 Google 选择的 BEST 全景图片。
  • 现在，当在 mousedown 处理程序中更改 gestureHandling: none 时，其行为与 draggable: false 相同（现在会在 mousedown 上生效）。

2017 年 11 月 21 日

Maps JavaScript API 3.31 版现已作为实验性版本推出。 请参阅 API 版本控制指南。

变更：

  • 现在，region 字段会随“地点详情”请求一起返回。

3.30

2017 年 8 月 16 日

Maps JavaScript API 3.30 版现已作为实验性版本推出。 请参阅 API 版本控制指南。

变更：

3.29

2017 年 5 月 16 日

Maps JavaScript API 3.29 版现已作为实验性版本推出。请参阅有关 API 版本控制的指南。

变更：

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

3.28

2017 年 4 月 18 日

MapOptions 对象的 draggable 属性已弃用。如需在桌面设备上禁止拖动地图，请使用 gestureHandling 属性并将其设置为 none。

2017 年 2 月 15 日

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

变更：

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

3.27

2017 年 2 月 2 日

已修复：

2017 年 1 月 10 日

现在，您可以限制自动补全联想查询仅在多个国家/地区显示。为此，您可以在 AutocompleteOptions 的 componentRestrictions 字段中指定最多 5 个国家/地区。

2016 年 11 月 15 日

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

变更：

  • MapOptions 对象中新增的 gestureHandling 选项可帮助您优化用户在移动设备上与地图互动时的体验。可供选择的值如下：
    • greedy：当用户在屏幕上滑动（拖动）时，地图始终会平移（向上或向下、向左或向右）。换句话说，单指滑动和双指滑动都会导致地图平移。
    • cooperative：用户必须用单指滑动才能滚动页面，用双指滑动才能平移地图。如果用户用单指滑动地图，地图上会显示一个叠加层，其中包含提示，告知用户使用双指移动地图。在移动设备上查看上述示例，了解协作模式的实际效果。
    • none：地图无法平移或捏合。
    • auto（默认）：行为为 cooperative 或 greedy，具体取决于网页是否可滚动。

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

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

已弃用登录地图

2016 年 10 月 6 日

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

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

2016 年 8 月 29 日

Directions Service 响应中的 via_waypoints 字段包含原始请求中未指定的航点数组。via_waypoints 字段将继续显示在可拖动路线响应中，但在备选路线响应中已弃用。版本 3.27 将是最后一版支持在备选路线中使用 via_waypoints 的 API。

建议的方法是请求备选路线，然后将所有路线显示为不可拖动，并将主路线显示为可拖动。用户可以拖动主路线，直到它与备选路线一致为止。via_waypoints 字段位于生成的路线（由用户拖动）上。

3.26

2016 年 8 月 18 日

Maps JavaScript API 3.26 版现已作为实验性版本推出。（请参阅 API 版本控制指南。）

变更：

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

3.25

2016 年 5 月 25 日

Maps JavaScript API 3.25 版现已作为实验性版本推出。（请参阅 API 版本控制指南。）

Internet Explorer 9 支持结束

2016 年 5 月 2 日

自 2016 年 4 月 30 日起，Maps JavaScript API 不再正式支持 Internet Explorer 9。请参阅支持的浏览器列表。

3.24

2016 年 4 月 14 日

变更：

  • 现在，您可以停用地图图标的可点击性。地图图标表示地图注点 (POI)。请参阅 google.maps.Map 上的 setClickableIcons 方法。

2016 年 3 月 31 日

已修复：

  • 问题 9507：街景中的链接现在可以在 Safari 中再次正常运行。

2016 年 3 月 28 日

已修复：

  • 问题 9394：当用户打开基本地图图标的信息窗口时，信息窗口会自动关闭，反之亦然。
  • 当使用地图上的 styles 属性设置基本地图的样式时，显示白色 Google 徽标（以前，只有在使用 StyledMapType 应用样式时，徽标才会变为白色）。

2016 年 3 月 18 日

已修复：

  • 问题 9424：new LatLng({lat: 0, lng: 0})
  • 修复了使用新街景渲染器（带有 google.maps.streetViewViewer = 'photosphere'）时鼠标平移的问题。

2016 年 2 月 15 日

变更：

  • 使用 google.maps.controlStyle = 'azteca' 选择停用新控件的功能已被移除。

3.23

2016 年 1 月 18 日

变更：

  • 此版本包含一个适用于地图的新全屏控件。用户可以点击该控件来最大化地图，使其占据整个屏幕。 默认情况下，此控件处于关闭状态。您可以在 MapOptions 中启用它，并使用 FullscreenControlOptions 进行配置。其默认位置为 RIGHT_TOP。
  • 街景的全屏控件默认处于启用状态。您可以通过 StreetViewPanoramaOptions 停用该功能，并使用 FullscreenControlOptions 对其进行配置。其默认位置现在为 RIGHT_TOP。

2016 年 1 月 4 日

已修复：

  • 问题 9009：从触摸合成鼠标事件时，使用左键而不是中键，以便与 jQuery 兼容。
  • 问题 4201：该 API 不再使用 eval()。 因此，现在无需使用 unsafe-eval Content Security Policy 指令即可使用该 API。

2015 年 12 月 21 日

变更：

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

2015 年 12 月 2 日

变更：

  • Autocomplete 构造函数会验证是否已提供输入元素。
  • 无论是在已登录模式还是未登录模式下，基本地图上的地图注点信息窗口都会显示相同的内容。
  • Closure 编译器的 Google Maps API externs 现在为枚举指定了类型（数字或字符串）。

2015 年 11 月 25 日

变更：

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

2015 年 11 月 19 日

变更：

  • 白色 Google 徽标（适用于自定样式的地图）

已修复：

3.22

2016 年 1 月 7 日

已修复：

  • 问题 9009：从触摸合成鼠标事件时，使用左键而不是中键，以便与 jQuery 兼容。

2015 年 11 月 10 日

变更：

  • 如果出行方式为驾车，路线服务和距离矩阵服务现在会返回预测的交通时间（在响应字段 duration_in_traffic 中）。如需接收预测的行程时间，请在请求中添加 drivingOptions 对象字面量，并指定当前或未来的 departureTime。您还可以指定 trafficModel 为乐观、悲观或最佳猜测（默认），以影响计算行程时间时使用的假设。如需了解详情，请参阅路线服务和距离矩阵服务的开发者指南。注意：duration_in_traffic 仅适用于 Google Maps Platform 专业版方案客户。

已弃用：

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

2015 年 11 月 5 日

已弃用：

  • AdSense 库自 2015 年 5 月起已弃用，并且不再在 Maps JavaScript API 的实验性版本中提供。该库很快就会从 API 的发布版本和冻结版本中移除。另一种解决方案是 Google AdSense。请参阅创建 AdSense 广告单元指南。

2015 年 9 月 22 日

变更：

  • 在发出路线和距离矩阵请求时，新增了对地点 ID 的支持：DirectionsRequest.origin、DirectionsRequest.destination 和 DirectionsWaypoint.location 现在接受 Place 对象，而 DistanceMatrixRequest.origins 和 DistanceMatrixRequest.destinations 现在接受 Place 对象的数组。

2015 年 9 月 15 日

变更：

  • 地图和街景全景图片上的许多控件的默认位置和外观都发生了变化。现在，无论地图是否使用登录模式，用户体验都是一致的，并且与 Google 地图网站也更加一致。如果您想在一段时间内继续使用旧版控件，可以在 v3.22 中设置 google.maps.controlStyle = 'azteca'。
  • 街景中的新全屏控件可让用户以全屏模式打开街景全景图片。

已弃用：

  • 总览图控件已不再可用。
  • 地图上的平移控件已不再提供。如需平移视图，用户可以点击并拖动或滑动地图。（请注意，街景中的平移控件仍然可用。）
  • 缩放控件仅提供一种样式，因此 google.maps.ZoomControlStyle 不再可用。

2015 年 9 月 1 日

变更：

  • 添加了 LatLngBounds 字面值
  • 修复了 CSS 类过于宽泛的问题
  • 改进了地图调整大小后的图块加载

Internet Explorer 8 支持终止

2015 年 8 月 31 日

自 2015 年 8 月 31 日起，Maps JavaScript API 不再正式支持 Internet Explorer 8。请参阅支持的浏览器列表。如需了解 Microsoft 的浏览器支持政策，请参阅 2014 年 8 月 7 日的 IEBlog 帖子。

3.21

2015 年 8 月 5 日

变更：

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

2015 年 7 月 21 日

变更：

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

2015 年 7 月 6 日

已修复：

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

2015 年 6 月 17 日

变更：

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

2015 年 6 月 2 日

变更：

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

2015 年 6 月 2 日

变更：

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

2015 年 5 月 28 日

变更：

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

2015 年 5 月 19 日

已修复：

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

3.20

2015 年 4 月 24 日

已修复：

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

2015 年 4 月 13 日

已修复：

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

2015 年 3 月 25 日

已修复：

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

2015 年 3 月 17 日

已修复：

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

2015 年 2 月 17 日

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

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

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

滚动更新后的可用版本：

实验性：3.20

版本：3.19

冻结：3.18

3.19

2015 年 4 月 24 日

已修复：

  • 已登录模式下的光标。

2015 年 3 月 19 日

已修复：

2015 年 1 月 20 日

已修复：

  • 问题 7475： 错误：phantomjs TypeError：无法删除属性

2015 年 1 月 13 日

已修复：

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

2014 年 12 月 17 日

已修复：

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

2014 年 12 月 2 日

已修复：

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

2014 年 11 月 25 日

已修复：

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

3.18

2014 年 12 月 4 日

已修复：

  • 问题 7390： Bug：weather.com 超链接无法正常运行

2014 年 9 月 18 日

已修复：

  • 问题 7136： Firefox 中多个标记标题无法正常运行

2014 年 9 月 9 日

已修复：

  • 问题 7098： 设置街景 POV 航向时抛出错误

2014 年 8 月 26 日

3.18 已发布到实验版。

3.17 现已稳定。

3.17

2014 年 8 月 20 日

已修复：

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

2014 年 8 月 12 日

已修复：

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

2014 年 7 月 31 日

添加时间:

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

2014 年 7 月 7 日

添加时间:

  • toGeoJson 添加到数据层和各个数据层功能，允许将几何图形导出为 GeoJSON。

2014 年 6 月 24 日

添加时间:

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

2014 年 5 月 26 日

添加时间:

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

2014 年 5 月 20 日

3.17 已发布到实验版。

3.16

2014 年 4 月 15 日

已修复：

2014 年 4 月 8 日

添加时间:

  • 在绘制时，地图会随鼠标移动而平移。

已修复：

  • 在更多位置接受 LatLngLiteral。
  • InfoWindow 会在 Roboto 加载完成后自行调整大小（问题 5713）

2014 年 3 月 31 日

已修复：

  • 半透明 KML 图层在 IE 8 上不再透明（问题 6540）

2014 年 3 月 26 日

已修复：

  • 移除了 Chrome 中的 event.returnValue 调用，以防止出现控制台警告。
  • 双指张合缩放功能在 IE11 中无法正常运行（问题 5747）

2014 年 3 月 18 日

添加时间:

2014 年 3 月 12 日

添加时间:

2014 年 2 月 24 日

添加时间:

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

2014 年 2 月 17 日

3.16 已发布到实验版。

3.15

2014 年 3 月 3 日

已修复：

2014 年 2 月 10 日

已修复：

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

2014 年 2 月 3 日

已修复：

  • 滚轮在 IE 11 中无法正常工作（问题 5944）

2014 年 1 月 29 日

已修复：

  • 在 Chrome/Windows 上停用所有 tile 硬件加速，以解决更大的 Chrome 硬件加速问题。（ 问题 6219）

2014 年 1 月 22 日

已修复：

2014 年 1 月 16 日

已修复：

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

2013 年 11 月 27 日

已修复：

  • 在实例化地图后创建标记会抛出“contains”未定义错误（问题 5798）

2013 年 11 月 19 日

已修复：

  • 在 Firefox 中，路线面板中的操作图标无法正常显示

3.14

2013 年 9 月 10 日

已修复：

  • Google 官方信息窗口中的链接不会在新标签页/窗口中打开 (问题 5794)

2013 年 8 月 15 日

  • 在 API 的发布版本中，视觉刷新将成为默认地图渲染模式。
  • DynamicMapsEngineLayer：矢量、图像和 KML 图层的地图项报告

3.13

2013 年 6 月 25 日

添加时间:

  • DynamicMapsEngineLayer

2013 年 6 月 11 日

添加时间:

已修复：

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

3.12

2013 年 6 月 4 日

已修复：

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

2013 年 5 月 15 日

添加时间:

2013 年 4 月 29 日

已修复：

  • 在 Android 和 Dolphin 浏览器中，已移除的标记仍会显示在地图上

3.11

2013 年 2 月 19 日

已修复：

  • 在绘制过程中更改 DrawingMode 会导致错误
  • 点击路线面板中的步骤可更改缩放级别

2013 年 2 月 12 日

已修复：

  • 不可拖动的多边形可通过触控输入拖动到可拖动的多边形上（问题 4868）
  • 当 travelMode 切换时，“路线替代方案”面板中的公交图标不正确（问题 4581）
  • 在某些条件下，panTo(latLng) 并不总是将地图精确地居中于 latLng

2013 年 1 月 29 日

添加时间:

  • 添加了 StreetViewCoverageLayer，用于以编程方式添加覆盖层
  • 公开了 StreetViewPanorama 的 StreetViewPov

已修复：

  • 使用 Google 地图 JavaScript V3.8 时，内存用量增加会导致崩溃（在 IE 9、Chrome 等浏览器中观察到）（ 问题 4162）
  • InfoWindow 中的下拉（选择）菜单在 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 日

已修复：

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

2012 年 9 月 25 日

添加时间:

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

2012 年 9 月 11 日

新功能：

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

2012 年 8 月 28 日

添加时间:

  • types 传递给 Places API textSearch

已修复：

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

2012 年 8 月 14 日

显著变化：

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

3.9

2012 年 9 月 10 日

已修复：

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

2012 年 8 月 9 日

已修复：

  • Android 3.x 上的语法错误

2012 年 7 月 31 日

显著变更：

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

已修复：

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

2012 年 7 月 25 日

已修复：

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

2012 年 7 月 17 日

已修复：

  • 在 IE 中，信息窗口中的文本框无法点击
  • bounds_changed 应在 zoom_changed 之前触发（问题 1399）
  • 在调用街景视图后，地图选项 backgroundColor 未保留
  • 从自定样式的地图切换到卫星地图时，不必要地加载了地图图块
  • 在绘制模式下，地图可拖动/滚轮属性会被忽略（问题 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
  • 新增了样式设置工具选项“weight”和“color”：

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

2012 年 5 月 15 日

添加时间:

  • 自动补全的国家/地区限制 (AutocompleteOptions.componentRestrictions)（问题 3899）
  • “地区和城市”类型过滤条件

3.8

2012 年 5 月 1 日

已修复：

2012 年 4 月 23 日

已修复：

  • 关闭街景后，街景小人仍会留在具有自定义地图类型的地图上（问题 4076）
  • 无法将已移除的动画标记重新添加到地图中（问题 4052）

2012 年 4 月 18 日

已修复：

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

添加时间:

  • FusionTablesLayer 的 orderBy、limit 和 offset（问题 3557）

2012 年 4 月 10 日

已修复：

  • 即使整个视口无法显示航拍图像，也会显示航拍图像（问题 3913）

2012 年 4 月 3 日

添加时间:

  • WeatherLayer 和 CloudLayer（问题 3555）
  • DemographicsLayer

已修复：

  • 在 IE 9 Quirks 中，多边形的图块边界可见
  • 在 Canvas 街景中平移时，标记会跳动

2012 年 3 月 28 日

已修复：

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

2012 年 3 月 20 日

已修复：

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

添加时间:

  • 点击即可前往/点击即可放大街景（问题 2447）

显著变化：

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

2012 年 3 月 6 日

已修复：

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

添加时间:

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

2012 年 2 月 21 日

已修复：

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

添加时间:

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

2012 年 2 月 15 日

已修复：

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

显著变化：

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

3.7

2012 年 2 月 7 日

已修复：

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

显著变更：

  • 现在，在 Canvas 中（如果可用）会呈现缩放的标记
新增：
  • ImageMapType 的 setOpacity()（问题 3125）
  • GroundOverlay 的 setOpacity()（问题 2767）
  • ImageMapType 的“tilesLoaded”事件（问题 1744）
  • 向 MouseEvent 添加了 stop()，用于停止事件传播（问题 2172）

2012 年 1 月 31 日

已修复：

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

2012 年 1 月 24 日

已修复：

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

2012 年 1 月 16 日

已修复：

  • 在绘制模式下，Pegman 不应可拖动
  • 正确触发事件，遵循多边形和其他图层的 zIndex
  • 添加了 KmlLayer“status”属性（问题 3015）

2012 年 1 月 10 日

已修复：

  • 如果 disableDefaultUI 为 true 且 streetViewControl 为 true，则显示小人

2011 年 12 月 7 日

已修复：

  • 高速公路可以与普通公路分开设置样式 (road.highway.controlled_access)
  • 当用户在自动补全中按“Enter”时，会触发 place_changed（问题 3407）

1011 年 11 月 28 日

已修复：

  • 在窗口大小调整时重新定位自动补全。 可以在 Autocomplete 对象上触发“resize”事件。

2011 年 11 月 22 日

已修复：

  • 现在，InfoWindow 内容大小的计算会考虑级联样式表
  • 航拍地图旋转控件与创建地图时的航向不一致

2011 年 11 月 7 日

显著变化：

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

已修复：

  • 现在，在 IE 7+ 中，路线结果中的起点和终点图标会以透明背景呈现

3.6

2011 年 10 月 31 日

已修复：

  • 在 IE7 上将地图 API 与 Prototype 库搭配使用时出错

2011 年 10 月 25 日

已修复：

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

2011 年 10 月 18 日

显著变化：

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

2011 年 10 月 10 日

已修复：

  • 街景预览中的地址过长

2011 年 9 月 27 日

已修复：

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

2011 年 9 月 27 日

已修复：

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

显著变更：

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

2011年9月20日

已修复：

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

显著变更：

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

2011 年 9 月 12 日

已解决的问题：

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

显著变更：

  • GeocoderResult.formatted_address 未记录

2011 年 9 月 6 日

已修复：

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

2011 年 8 月 29 日

显著变化：

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

2011 年 8 月 24 日

已解决的问题：

  • 针对 Chrome/Mac 停用了硬件加速： 修复了标记渲染问题和叠加层点击问题（ 问题 3544、 问题 3551）
  • 修复了 Android 上滚动页面时双指张合缩放功能无法正常工作的问题 (问题 3373)

显著变化：

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

2011 年 8 月 17 日

显著变化：

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

3.5

2011 年 8 月 10 日

已修复：

  • 在街景中将标记拖动到地平线时，标记会卡在向上拖动的位置
  • 地图或窗口大小调整时，街景大小未调整
  • 具有共享 InfoWindow 的街景视图会导致浏览器崩溃

2011 年 8 月 2 日

已解决的问题：

  • IE 上的信息窗口中的超链接无法正常工作（问题 3503）
  • 比例尺控件无法打印（问题 2966）
  • 回归：将 OverviewMapControl 与样式化地图搭配使用时出错（问题 3489）

显著变化：

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

2011 年 7 月 18 日

已解决的问题：

  • 在 iOS >= 4.1 上滚动页面时，事件 LatLng 不正确（问题 3373）

2011 年 7 月 11 日

已解决的问题：

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

显著变化：

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

2011 年 7 月 5 日

已解决的问题：

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

显著变化：

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

2011 年 6 月 30 日

已解决的问题：

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

显著变化：

  • 地点自动补全功能已更改为附加到正文而不是输入父级
  • BOTTOM_RIGHT 现在可正确定位

2011 年 6 月 8 日

已解决的问题：

  • 已修复：如果缩放级别变化大于 2，则不再为缩放添加动画效果（问题 3033）

显著变更：

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

2011 年 5 月 17 日

已解决的问题：

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

显著变化：

  • 为地图图块启用了淡入淡出过渡效果，以便在加载和更改地图类型时使用。

2011 年 5 月 7 日

没有明显变化。

3.4

2011 年 5 月 7 日

没有明显变化。

2011 年 5 月 6 日

已解决的问题：

  • 已修复：街景全景图片未在 IE7 中显示（问题 3272）
  • 已修复：具有 ImageMapType 的半透明 PNG 在 IE7 和 IE8 中会失去透明度（问题 3275）

显著变化：

  • 距离矩阵服务

2011 年 4 月 14 日

已解决的问题：

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

显著变化：

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

2011 年 4 月 14 日

已解决的问题：

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

显著变更：

  • 现在，多段线和多边形会尽可能在 Canvas 中渲染。
  • 多段线和多边形边界上事件的 LatLng 现在会贴靠到线上最近的点。

2011 年 4 月 5 日

已解决的问题：

2011 年 3 月 28 日

已解决的问题：

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

显著变更：

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

2011 年 3 月 22 日

已解决的问题：

  • 街景小人显示在自定义地图类型中（问题 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 时的混合模式问题（问题 3062）
  • 修复了快速向地图添加/从中移除圆形/矩形时出现的问题 (Issue 3052)
  • 修复了在触摸设备上 draggable: false 的问题（问题 3044）

2011 年 2 月 18 日

已解决的问题：

  • 街景中的标记只会缩小，不会放大（问题 2969）
  • 现在，当 routeIndex 不为 0 时，可拖动路线也能正常使用了（问题 2995）
  • 修复了 Flash 与地图拖动之间的冲突（问题 2956）
  • 在 maptypeid_changed 监听器中更改 mapTypeId 时，地图类型控件现在保持一致

显著变更：

  • 现在，当从地图类型控件点击“卫星”模式时，标签默认处于开启状态

2011 年 2 月 8 日

显著变化：

  • 新的分层地图类型控件 - 触控友好！
  • 新徽标（问题 2574）
  • 将 MarkerShape.coord 重命名为 MarkerShape.coords，以与 HTML <area> coords 属性保持一致

3.3

2011 年 3 月 17 日

已解决的问题：

  • 多边形未渲染

2011 年 2 月 8 日

已解决的问题：

  • 未在 Chrome 中取消图块请求（问题 3011）
  • 在 FF/Mac 中未触发 rightclick 事件（问题 2920）
  • Safari/Mac 中的文本渲染问题（问题 3024）
  • 在 IE 中无法正确打印路线地图

2011 年 1 月 21 日

显著变化：

  • 现在，球体几何库中接受 MVCArrays
  • 修复了在 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 日

已解决的问题：

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

显著变更：

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

2010 年 12 月 5 日

已解决的问题：

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

显著变化：

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

2010 年 11 月 28 日

已解决的问题：

  • maptypeid_changed 不再触发两次（问题 2449）
  • MarkerImage 对象的“size”属性现在可供访问（问题 2465）
  • 标记形状引用的是图标，而不是精灵 ( 问题 2629)
  • 改进了在拖动标记时平移小地图的功能（问题 2868）
显著变化：
  • 现在，无需启用背景图片打印功能即可打印地图
  • 修复了以下 bug：当“draggable”设置为 false 时，可拖动的方向标记仍可拖动

2010 年 11 月 16 日

已更改的问题：

显著变化：

  • 修复了在 Firefox 中按住 Shift 键点击标记时会打开新窗口的 bug。
  • 使用 DirectionsRenderer 指定 markerOptions 时，字母标记图标丢失

3.2

2010 年 11 月 11 日

显著变化：

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

2010 年 10 月 11 日

更改的问题：

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

显著变化：

  • 街景服务默认处于启用状态
  • 修复了“this”未传递到 .getTileUrl 的 bug
  • InfoWindow domready 事件现在会在窗口可见后触发

2010 年 9 月 28 日

更改的问题：

  • 问题 2712： 内存泄漏（添加/移除标记、显示/隐藏标记、缩放/平移地图）

显著变化：

  • 当 V2 和 V3 地图位于同一页面上时，它们可以更好地协同工作
  • 修复了在 HTML5 街景中快速向下拖动时出现的错误

2010 年 9 月 16 日

更改的问题：

  • 问题 2701： 初始街景导航器控制朝向不跟随主视角

2010 年 9 月 14 日

更改的问题：

  • 问题 157： 支持可拖动的行车路线
  • 问题 1852：google.maps.Marker 上的“rightclick”事件在没有参数的情况下触发
  • 问题 2673：小人图标在位置更改后消失

显著变化：

  • 标记性能已得到改进

2010 年 8 月 31 日

已更改的问题：

显著变化：

  • 改进了测地线，以便在更高的缩放级别下显示

2010 年 8 月 24 日

已更改的问题：

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

显著变更：

  • 现在，在反复放大或缩小（例如使用滚轮）时，我们从中间缩放级别加载的图块会减少。

2010 年 8 月 16 日

已更改的问题：

  • 问题 2416：Apple Magic Mouse 鼠标平移和缩放过于敏感
  • 问题 2606：在地图上设置 draggable: false 会停用链接
  • 问题 2640：浏览器刷新 / onunload (IE) 时未清除内存

显著变更：

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

2010 年 8 月 9 日

显著变化：

  • 已移除废弃的属性 KMLMouseEvent.position 和 FusionTablesMouseEvent.position。请改用 .latLng
  • 已移除废弃的属性 StreetViewService.getNearestPanorama。请改用 .getPanoramaByLocation

3.1

2010 年 9 月 28 日

显著变化：

  • 修复了起点和终点相同的路线抛出 JS 错误的问题

2010 年 8 月 9 日

显著变化：

  • 已修复更改 OverlayView 的地图的问题
  • 修复了调用 GroundOverlay.setMap(null) 的问题
  • IE 不再出现缩放/平移内存泄漏问题

2010 年 8 月 5 日

更改的问题：

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

显著变更：

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

2010 年 7 月 29 日

已更改的问题：

显著变化：

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

2010 年 7 月 22 日

更改的问题：

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

显著变更：

  • 拖动多边形时不再触发点击事件
  • 点击扩展到 InfoWindow 之外的表单选择元素不再触发地图点击事件
  • 点击 KML 叠加层不再触发地图点击事件
  • 现在，街景会自动平移，以在屏幕上容纳 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 版权信息的 bug
  • 向多边形和多段线添加了测地属性
  • 为多边形和多段线添加了 clickable 选项
  • 为 GroundOverlay 添加了 clickable 选项

2010 年 5 月 13 日

已更改的问题：

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

显著变更：

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

2010年5月7日

已更改的问题：

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

显著变更：

  • 添加了 KML 图层和 GeoRSS 图层
  • 添加了 地面叠加层
  • 添加了新图层： 路况和 骑行
  • 针对 DirectionsRendererOptions 添加了“suppressBicyclingLayer”属性
  • 修复了 bug，以确保在 MapType 更改时正确引用缩放层
  • 将 DirectionsResult 属性“start/end_point”重命名为“start/end_location”
  • 将 DirectionsLeg 属性“start/end_geocode”重命名为“start/end_address”
  • 将 DirectionsRoute“optimized_waypoint_order”属性重命名为“waypoint_order”
  • 移除了对旧版 Directions 属性名称（setTripIndex、getTripIndex、hideTripList、provideTripAlternatives）的支持，并继续记录警告。此外，还移除了将路线转换为路段再转换为步骤，以及将行程转换为路线再转换为步骤的功能。
  • 将 GeocoderGeometry.latLng 更新为 GeocoderGeometry.location

2010 年 4 月 30 日

已更改的问题：

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

显著变更：

  • 现在，点击地图即可聚焦键盘
  • iPad 现在支持双指张合缩放

2010 年 4 月 26 日

已更改的问题：

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

显著变更：

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

2010 年 4 月 13 日

已更改的问题：

  • 问题 2275：MarkerImage 无法重复使用
  • 问题 2181： 当您添加 google.maps.Marker，然后使用鼠标滚轮放大或缩小时，标记会被隐藏

2010 年 4 月 11 日

没有明显变化或已更改的问题。

2010 年 4 月 5 日

已更改的问题：

显著变化：

  • 在 DirectionsRoute 中将路线概览多段线公开为 overview_path。
  • 将地图的当前投影公开为只读属性。

2010 年 3 月 23 日

显著变更：

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

2010 年 3 月 15 日

显著变化：

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

2010 年 3 月 10 日

已更改的问题：

  • 问题 1801：多段线/多边形 zIndex
  • 问题 2144：DirectionsRequest 应提供 avoidHighways 选项
  • 问题 2207： Bug：多段线在 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： 错误：NavigationControlStyle.ZOOM_PAN 在 IE8 中无法正确显示
  • 问题 2153：MVCArray.push() 不返回新长度

显著变更：

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

2010 年 2 月 8 日

已更改的问题：

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

显著变更：

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

2010 年 1 月 28 日

已更改的问题：

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

显著变更：

  • 新增了对印度语系的支持：
    • bn、gu、kn、ml、mr、ta、te
  • 向事件命名空间添加了新的静态方法：
    • addListenerOnce
    • addDomListenerOnce
  • 向 DirectionsStep 对象添加了新的“encoded_lat_lngs”属性，以公开压缩 ASCII 格式的纬度和经度集
  • 通过移除屏幕外标记 DOM 元素来提升性能
  • 修复了 Google Chrome 中的平移 bug
  • 修复了 iPhone 上的双指开合缩放 bug

2010 年 1 月 19 日

已更改的问题：

  • 问题 1422： 功能请求：允许开发者创建自定义地图类型
  • 问题 1523：功能请求：fromContainerPixelToLatLng（反之亦然）
  • 问题 1443：extend() 和 union() 应返回 LatLngBounds 对象
  • 问题 1960：bug：使用 provideTripAlternatives 时信息不完整
  • 问题 1675：教程文档错误
  • 问题 1676：教程文档错误 - 控制选项
  • 问题 1856： 多边形在 Opera 中无法呈现！
  • 问题 1954：保加利亚语本地化不正确。
  • 问题 1976： 错误：自定义图标和可拖动标记问题
  • 问题 2063：缩减 OverlayView 子类大小时发生变量名称冲突

显著变化：

2009 年 12 月 17 日

显著变化：

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

2009 年 12 月 10 日

已更改的问题：

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

其他显著变化：

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

2009 年 11 月 25 日

已更改的问题：

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

其他显著变化：

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

2009 年 11 月 11 日

已更改的问题：

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

其他明显变化：

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

2009 年 10 月 29 日

已更改的问题：

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

其他明显变化：

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：在 Firefox 3.5 中，平移后点击和双击事件中报告的 latLng 不正确
  • 问题 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 日

已更改的问题：

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

其他明显变化：

  • 默认启用滚轮缩放。如需停用此功能，请将地图选项的 scrollwheel 属性设置为 false。
  • 更新了文档，以包含 panTo 和 panBy 函数。

2009 年 8 月 14 日

已更改的问题：

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

其他明显变化：

  • 已启用滚轮缩放功能。
  • 修复了影响 iPhone 的问题，即拖动后地图会跳动。

2009 年 8 月 4 日

已更改的问题：

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

其他明显变化：

  • iPhone 上的捏合和拖动操作应更可靠。
  • 向 InfoWindow 对象添加了 zIndex setter 和 getter。

文档变更：

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

2009 年 7 月 13 日

已更改的问题：

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

其他明显变化：

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

2009 年 6 月 12 日

更改的问题：

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

其他明显变化：

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