Maps JavaScript API 版本说明

订阅以下版本说明。 订阅

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

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

如需接收有关新 Maps API 版本的最新动态,请订阅 google-maps-js-api-v3-notify 群组。

3.61.9a

2025 年 7 月 10 日

变更:

  • 更新了标记,以防止在使用屏幕阅读器时在每个项目上重复显示导航说明。现在,每次进入群组时,系统只会播报一次指令。
  • 修复了深色模式下键盘快捷键对话框的对比度问题。
  • 为 Place Autocomplete Element 启用边框、边框半径、widget 背景颜色和配色方案自定义支持。地点自动补全元素现在会自动遵循深色模式 - 如要停用,请在 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 中添加了对地址验证 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 的支持。
  • 确保启动时的静态地图叠加层与底层地图具有相同的颜色方案。

3.60.7b

2025 年 4 月 3 日

变更:

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

3.60.6

2025 年 3 月 27 日

变更:

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

3.60.5(已回滚)

2025 年 3 月 20 日

变更:

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

3.60.4

2025 年 3 月 11 日

变更:

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

3.60.3(已回滚)

2025 年 3 月 5 日

变更:

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

3.60.2

2025 年 2 月 27 日

变更:

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

3.60.1

2025 年 2 月 20 日

变更:

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

3.59.8

2025 年 2 月 6 日

变更:

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

3.59.7

2025 年 1 月 30 日

变更:

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

3.59.6

2025 年 1 月 23 日

没有面向公众的变更。

3.59.5

2025 年 1 月 16 日

变更:

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

3.59.4a

2025 年 1 月 9 日

变更:

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

3.59.3

2024 年 12 月 12 日

变更:

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

3.59.2

2024 年 12 月 5 日

变更:

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

3.59.1

2024 年 11 月 21 日

变更:

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

3.58.11a

2024 年 10 月 31 日

变更:

  • [Beta 版渠道] 修复了导致街景小人在网页组件地图上无法使用的 bug。
  • 防止屏幕阅读器在嵌入式 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 版] 从 Polyline3DElementPolygon3DElement 中移除了 *Opacity 属性。可以使用 #rgba#rrggbbaargba(r, g, b, a)rgb(r g b / a) 颜色格式在相应的 *Color 属性中指定 Alpha 值。
  • [Alpha 版] 默认界面控件、标记、3D 模型和预设的相机动画功能现在可用于实验版中的 3D 地图。
  • 修复了导致无法在矢量地图上切换自定义地图类型的 bug。
  • 对于像素密度较高的设备,请使用高 DPI 卫星图像。

3.58.5a

2024 年 9 月 19 日

没有面向公众的变更。

3.58.4a

2024 年 9 月 12 日

没有面向公众的变更。

3.58.3

2024 年 9 月 5 日

没有面向公众的变更。

3.58.2

2024 年 8 月 29 日

变更:

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

3.58.1a

2024 年 8 月 22 日

变更:

  • [Beta 版渠道] 默认情况下,将缩放控件替换为相机控件。相机控制功能同时提供缩放和平移控件。
  • cameraControlcameraControlOptions 属性发布到 MapOptions
  • 允许在地图实例化时设置配色方案(浅色或深色)。
  • 更新了地图类型控件,使其在地图宽度过小时换行
  • 集成了一个新的标签器,用于渲染矢量地图标签。
  • 对于不使用地图 ID 的开发者,新版基本地图颜色现在已成为 v=weekly 渠道中的默认颜色。如需了解详情,请访问 https://developers.google.com/maps/new-basemap-style-opt-in

3.57.13

2024 年 8 月 8 日

变更:

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

3.57.12

2024 年 8 月 1 日

变更:

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

3.57.10

2024 年 7 月 25 日

变更:

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

3.57.9

2024 年 7 月 18 日

变更:

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

3.57.8b

2024 年 7 月 11 日

没有面向公众的变更。

3.57.7

2024 年 7 月 4 日

变更:

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

3.57.6a

2024 年 6 月 27 日

没有面向公众的变更。

3.57.5

2024 年 6 月 20 日

没有面向公众的变更。

3.57.4

2024 年 6 月 13 日

变更:

  • [Beta 版渠道] 集成了一个新的标签器,用于渲染矢量地图标签。
  • InfoWindow 新增了属性 isOpen,用于指示信息窗口是否在地图或街景上处于打开状态。
  • 修复了地点自动补全 PlacePrediction 类的错误参考文档。

3.57.3a

2024 年 6 月 6 日

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

3.57.2

2024 年 5 月 28 日

变更:

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

3.57.0

2024 年 5 月 24 日

没有面向公众的变更。

3.56.12a

2024 年 5 月 9 日

变更:

  • 修复了导致 AdvancedMarkerElement 的拖动指示器缺失的 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 版渠道] 现在提供新的 InfoWindow 关闭按钮和可选的标题。
  • [Beta 版渠道] 改进了街景小人控件的键盘和单指针无障碍功能。
  • 修复了因移除高级标记而导致的内存泄漏问题。
  • 修复了圆形无法绘制平滑周界的问题。
  • 添加了在 google.maps.Map 实例化期间设置矢量模式的 API(不需要 mapId)。

3.56.8

2024 年 4 月 11 日

变更:

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

3.56.7

2024 年 4 月 4 日

变更:

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

3.56.6

2024 年 3 月 28 日

变更:

  • [Beta 版渠道] 地图栅格图块现在以 WebP 图片格式提供。
  • 修复了矢量地图上地图内 POI 的信息窗口锚点位置。
  • 修复了显示未设置位置的 AdvancedMarkerElement 的 bug。
  • 为 InfoWindow API 添加了“关闭”事件。

3.56.5

2024 年 3 月 21 日

变更:

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

3.56.4

2024 年 3 月 14 日

没有面向公众的变更。

3.56.3

2024 年 3 月 7 日

没有面向公众的变更。

3.56.1

2024 年 2 月 22 日

变更:

  • 修复了 Place.searchByText 的“fields”参数中的文档错误。
  • [Beta 版渠道] 在 <gmp-map> 中创建默认 slot,并允许创建自定义元素来封装 Maps JavaScript API Web 组件。
  • 向新的 Place 类 API 添加了停车选项。
  • 弃用了 google.maps.Marker。请改为使用 google.maps.marker.AdvancedMarkerElement。目前,google.maps.Marker 尚未计划停用,但建议使用 google.maps.marker.AdvancedMarkerElement 而不是 google.maps.Marker。虽然 google.maps.Marker 将继续接收针对任何重大回归的 bug 修复,但不会解决 google.maps.Marker 中的现有 bug。我们若计划停止支持,会提前至少 12 个月发出通知。如需了解弃用详情,请访问 https://developers.google.com/maps/deprecations
  • 向新的 Place 类 API 添加了其他属性。
  • 向新的 Place 类 API 添加了付款选项。

3.55.11a

2024 年 2 月 15 日

变更:

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

3.55.11

2024 年 2 月 8 日

变更:

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

3.55.10

2024 年 2 月 1 日

变更:

  • [Beta 版渠道] 废弃了 SearchByTextRequest.rankBy。请改用 SearchByTextRequest.rankPreference。
  • [Beta 版渠道] Place.findPlaceFromQuery 和 Place.findPlaceFromPhoneNumber 不再可用;请改用 Place.searchByText。
  • 修复了“按渠道跟踪用量”功能。
  • 在 JavaScript Journey Sharing 中为 Trip 和车辆位置信息提供程序启用可感知流量的多段线。
  • 新的 Place 类现已在每周更新的渠道中提供。
  • 弃用了 Place.openingHours。请改用 regularOpeningHours。

3.55.9

2024 年 1 月 25 日

变更:

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

3.55.8

2024 年 1 月 18 日

变更:

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

3.55.7

2024 年 1 月 11 日

变更:

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

3.55.3

2023 年 11 月 30 日

没有面向公众的变更。

3.55.2

2023 年 11 月 23 日

变更:

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

3.55.1

2023 年 11 月 16 日

没有面向公众的变更。

3.54.12a

2023 年 11 月 8 日

变更:

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

3.54.12

2023 年 11 月 2 日

变更:

3.54.11

2023 年 10 月 26 日

变更:

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

3.54.10

2023 年 10 月 18 日

变更:

  • [Beta 版渠道] MapElement 现在会根据其计算出的 direction 样式自动调整其控件布局,以适应从左到右或从右到左的阅读方向。此外,还提供用于添加自定义控件的 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 现为 AuthorAttributionauthor 现为 displayNameauthorURI 现为 uriphotoURI {?string} 现已在 AuthorAttribution 上架。Photo.attributions 现为 Photo.authorAttributionsReview.authorAttribution {?AuthorAttribution} 取代了 Photo.author/authorURI/authorPhotoURI
  • [Beta 版渠道] 在 Place 类的 searchByText() 方法中添加了必需字段 textQuery 并弃用了 query
  • 调整了光栅地图的标签和图标的信息窗口锚点偏移量。

3.53.12

2023 年 7 月 20 日

变更:

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

3.53.11

2023 年 7 月 13 日

变更:

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

3.53.7

2023 年 6 月 15 日

变更:

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

3.53.5

2023 年 6 月 1 日

变更:

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

3.53.4a

2023 年 5 月 24 日

bug 修复:

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

3.53.3

2023 年 5 月 18 日

变更:

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

3.53.2

2023 年 5 月 4 日

变更:

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

3.53.1a

2023 年 4 月 27 日

变更:

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

3.52.9

2023 年 4 月 13 日

变更:

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

bug 修复:

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

3.52.8

2023 年 4 月 6 日

变更:

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

bug 修复:

  • 修复了地点评价的 publishTime 显示错误日期的问题。
  • 修复了创建自定义元素时会全局中断的问题。
  • [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) 时 WebGLOverlayViews 未正确移除的问题
  • 修复了报告 search 库未知的问题。
  • 修复了在影子根中时信息窗口关闭按钮不可见的 bug。
  • 为了改进核心网页指标并减少不必要的数据传输,Maps JavaScript API 现在会延迟加载地图图块,直到地图接近视口时才开始加载。在网页的初始视口内创建的地图应该不会有任何变化。

3.52.1

2023 年 2 月 16 日

变更:

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

3.51.8

2023 年 2 月 2 日

变更:

  • Beta 版渠道:支持在自定义地图类型上渲染高级标记。
  • 最新版本的内嵌引导加载程序现在将重用在文档其他位置找到的 CSP nonce。

3.51.7

2023 年 1 月 26 日

变更:

  • Beta 版渠道:数据驱动的样式:添加了 fetchPlace 方法,用于获取 PlaceFeature 的显示名称。PlaceFeature.displayName 属性将被弃用,并于 2023 年 2 月移除。

3.51.6

2023 年 1 月 19 日

bug 修复:

  • 修复了高级标记存在的问题,即从地图中移除发生碰撞的标记有时可能会导致 DOM 中留下虚影标记元素。

3.51.5

2023 年 1 月 12 日

变更:

  • 将 AdvancedMarkerView、PinView 和 LocalContextMapView 上 element 的类型从 Element 更正为 HTMLElement | SVGElement,以更准确地表示所需的元素类型。

bug 修复:

  • 修复了以下 bug:在使用带有信息窗口的高级标记时,使用键盘拖动标记后,信息窗口可能无法打开。

3.51.4

2023 年 1 月 5 日

变更:

  • Beta 版渠道:为 Place 类添加了新属性
  • Beta 版渠道:如果点击位置下方有多个地图项,则数据驱动的样式 FeatureMouseEvent.features 数组可能包含多个地图项,并且点击位置下方的所有 FeatureLayer 点击监听器都会被触发。
  • Beta 版渠道:针对传递给 google.maps.Map.getFeatureLayer 的无效实参抛出错误。
  • 修正了全屏地图上高级标记的像素位置。
  • 更改了地图鼠标事件,现在会忽略在已按下另一个鼠标按钮时发生的鼠标按钮点击。
  • 修复了在放大地图时导致高级标记消失的 bug。
  • 改进了在包含许多高级标记的地图上放大时的性能。
  • 更新了 StreetViewPanoramaOptions 文档,以明确说明自定义全景图片不支持 clickToGo。
  • 提高了创建 LatLngBounds(包括通过 Map.getBounds() 创建)时的性能。
  • 更新了 onAdd 和 onRemove 的 WebGLOverlayView 参考。
  • 为行程分享添加了固定的标记样式自定义功能。

3.51.3

2022 年 12 月 8 日

变更:

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

3.51.2

2022 年 12 月 1 日

变更:

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

3.51.1

2022 年 11 月 17 日

变更:

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

bug 修复:

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

3.51

2022 年 11 月 16 日

变更:

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

3.50.12a

2022 年 11 月 7 日

变更:

  • 修复了 google.maps.event.addListenerOncegoogle.maps.event.addDomListenerOnce 具有错误 this 绑定的问题。

3.50.12

2022 年 11 月 3 日

变更:

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

3.50.11

2022 年 10 月 27 日

变更:

  • Beta 版渠道:现在,当数据驱动样式设置功能图层变为不可用时,系统会记录错误。
  • Beta 版渠道:改进了默认高级标记的加载性能。

3.50.10

2022 年 10 月 20 日

bug 修复:

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

3.50.9

2022 年 10 月 13 日

变更:

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

3.50.8

2022 年 10 月 6 日

变更:

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

bug 修复:

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

3.50.7

2022 年 9 月 29 日

变更:

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

3.50.6

2022 年 9 月 22 日

bug 修复:

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

变更:

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

3.50.5

2022 年 9 月 15 日

变更:

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

3.50.3

2022 年 9 月 1 日

变更:

  • Beta 版渠道:更新了 JavaScript 旅程分享的 DeliveryVehicle 类,以包含自定义属性。
  • 修复了在地图倾斜后事件中存在错误 LatLng 的 bug。

3.50.2

2022 年 8 月 25 日

变更:

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

3.50.1

2022 年 8 月 18 日

变更:

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

3.49.12

2022 年 8 月 4 日

变更:

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

3.49.11

2022 年 7 月 28 日

变更:

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

3.49.10

2022 年 7 月 21 日

变更:

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

3.49.9

2022 年 7 月 14 日

变更:

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

3.49.8

2022 年 7 月 7 日

变更:

  • 使街景导航链接可通过键盘访问,并对屏幕阅读器友好。
  • StreetViewPanorama 上引入了新的 focus 方法。

3.49

2022 年 6 月 23 日

变更:

bug 修复:

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

3.49.5

2022 年 6 月 16 日

变更:

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

bug 修复:

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

3.49.4

2022 年 6 月 9 日

变更:

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

3.49.3a

2022 年 6 月 2 日

变更:

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

3.49.2

2022 年 5 月 26 日

变更:

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

3.49.1

2022 年 5 月 19 日

变更:

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

3.49

2022 年 5 月 12 日

变更:

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

3.48.11

2022 年 4 月 28 日

变更:

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

3.48.9

2022 年 4 月 14 日

变更:

  • Beta 版渠道:为 WebGLOverlayView 启用 WebGL 2.0。
  • Beta 版渠道:将 JourneySharing 库纳入 Maps JavaScript API TypeScript 类型、外部声明和参考文档中。
  • 函数 google.maps.event.addDomListener()google.maps.event.addDomListenerOnce() 已弃用,不应继续使用。请改用标准 addEventListener() 方法。这些方法仍继续有效,并且我们不打算停用它们。
  • 为街景标记图标添加了 titlearia-label
  • 全屏控件添加了 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 修复:

  • 修复了 sInfoWindows 上“在 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,而不是 LatLngnumber
  • LatLngnoWrap 参数重命名为 noClampNoWrap
  • 现在,当标记获得焦点时,屏幕阅读器会读出有关如何浏览标记的说明。
  • Maps JavaScript API 现在会报告遥测信息。您可能需要更新内容安全政策,以确保这些调用不会在浏览器级别被阻止。有关详情,请参阅常见问题解答
  • 此版本不支持 Internet Explorer。如需继续支持 Internet Explorer 11,请指定 v=3.47,该版本将提供支持,直至 2022 年 11 月。

3.48

2022 年 2 月 10 日

变更:

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

3.47.6

2022 年 1 月 20 日

bug 修复:

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

3.47.4

2022 年 1 月 6 日

变更:

  • Beta 版渠道:更新了 WebGLOverlayView API(针对 Beta 版)- 弃用了名称中包含“gl”的所有类和方法,取而代之的是名称中包含“GL”的新类和方法;弃用了 WebglCameraParams,取而代之的是新的 CameraParams 类(该类是 CameraOptions 的子类)。
  • 更新了 PlaceOpeningHours 方法文档,以反映在计算中不使用特殊营业时间。

3.47.3

2021 年 12 月 9 日

变更:

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

3.47.2

2021 年 12 月 2 日

变更:

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

bug 修复:

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

3.47.1

2021 年 11 月 18 日

变更:

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

bug 修复:

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

3.47

2021 年 11 月 11 日

变更:

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

3.46.12

2021 年 11 月 4 日

bug 修复:

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

3.46.11

2021 年 10 月 28 日

变更:

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

3.46.8

2021 年 10 月 7 日

变更:

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

3.46.6

2021 年 9 月 23 日

变更:

  • 修复了当地图不可拖动时,地图光标显示为手状的 bug。

3.46.5

2021 年 9 月 16 日

bug 修复:

  • 修复了地点自动补全微件中色彩对比度方面的一个 bug。

3.46.3

2021 年 9 月 2 日

变更:

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

3.46.2

2021 年 8 月 26 日

变更:

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

3.46

2021 年 8 月 18 日

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

变更:

  • PlaceResult 添加了两个新字段:icon_mask_base_uriicon_background_color
  • 每周渠道已更新至版本 3.46。
  • 季度渠道已更新至版本 3.45。
  • 如果按编号请求,版本 3.44 仍可使用。
  • 版本 3.43 已被删除,无法再使用。

弃用:

  • 我们正在弃用对 Internet Explorer 的支持。从 2021 年 8 月开始,如果用户使用的是 Maps JavaScript API v3.46,则在使用 Internet Explorer 11 时会在地图顶部看到一条警告消息。支持 Internet Explorer 11 的最后一版 Maps JavaScript API 是 v3.47。 我们将于 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 接口添加了动画、图标、标签和不透明度属性的相关文档。
  • 重新设计了版权对话框,以提供更好的无障碍支持。
  • 信息窗口现在会在打开时自动管理焦点。这表示新的默认行为。
  • 添加了 InfoWindowOpenOptions API,使开发者能够控制在打开信息窗口时如何管理焦点。
  • 现在,可以通过按 ESC 键关闭信息窗口。
  • 现在,使用屏幕阅读器时,信息窗口会读作“对话框”。
  • 现在已启用 Polyfill 隔离;此更改可防止在宿主网页上安装 Maps API 内部 Polyfill。

bug 修复:

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

新功能:

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

3.44.14

2021 年 5 月 13 日

变更:

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

3.44.12

2021 年 4 月 28 日

bug 修复:

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

本地上下文:

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

3.44.11a

2021 年 4 月 20 日

变更:

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

bug 修复:

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

3.44.9

2021 年 4 月 8 日

bug 修复:

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

3.44.8

2021 年 4 月 1 日

变更:

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

3.44.7

2021 年 3 月 25 日

变更:

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

3.44.4

2021 年 3 月 4 日

变更:

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

bug 修复:

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

3.44.2

2021 年 2 月 25 日

变更:

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

3.44.1

2021 年 2 月 18 日

变更:

  • 现在,重新加载显示的地点时,LocalContext 地点选择器按钮处于停用状态。
  • 未优化的标记现在可聚焦,并且可通过键盘访问。
  • Beta 版渠道:移除了意外添加到 window 中的对象(SphericalPolylineCodecPolyGeometry)。这些对象应通过其完全限定的命名空间进行访问。
  • 在 Beta 版渠道中启用了 Polyfill 隔离。这意味着,Maps JavaScript API 将不再向宿主网页安装 Polyfill。

3.43.8a

2021 年 2 月 25 日

仅季度渠道已更新。变更:

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

3.43.8

2021 年 2 月 5 日

变更:

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

bug 修复:

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

3.43.7a

2021 年 1 月 28 日

bug 修复:

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

3.43.6

2021 年 1 月 21 日

bug 修复:

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

3.43.5

2021 年 1 月 14 日

变更:

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

bug 修复:

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

3.43.3

2020 年 12 月 9 日

变更:

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

bug 修复:

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

3.43.2

2020 年 12 月 1 日

变更:

  • 添加了 contextmenu 事件,作为 rightclick 事件的更好替代方案。 contextmenu 事件添加了在 macOS 上响应 Ctrl-点击的功能。
  • 当提供 titlelabel 时,向非优化标记添加无障碍属性。
  • 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 版支持。
  • 在提供 titlelabel 时,向未优化的标记添加了无障碍功能文本。
  • MapType 控制下拉菜单按钮中移除了 aria-pressed 标签,以提升无障碍功能。
  • DropdownMenuDropdownMenuItem 转换为语义元素,以提高无障碍功能。
  • 更改了版权元素文本,以符合色彩对比度标准。
  • 现在,您可以使用 Enter 键或空格键打开和关闭下拉菜单。
  • 现在可以聚焦下拉菜单项。
  • 本地情境库:现在,当轮播界面控件不会产生任何效果时,系统会将其停用,并且这些控件不再与列表中的第一个或最后一个项重叠。

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 日

变更:

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

支持更新的地点图标

2020 年 10 月 1 日

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

3.42.7

2020 年 9 月 29 日

变更:

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

3.42.6

2020 年 9 月 21 日

变更:

3.42.5

2020 年 9 月 16 日

变更:

  • 更新了 LatLngBounds.union 方法,以处理两个边界均超过 180 度的情况。

3.42.4

2020 年 9 月 8 日

变更:

  • 现在,当检测到无效的 Date.now() 实现时,系统会将错误记录到控制台。
  • 在提权服务方法中添加了对 Promise 的 Beta 版支持。
  • 引入了新的 InfoWindow.minWidth 属性,用于指定 InfoWindow 的最小宽度。
  • 修复了更改目的地后路线指引路线变得模糊的 bug。

3.42

2020 年 8 月 19 日

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

变更:

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

变更:

  • Places Library 和 Maps JavaScript API 中的“地点”字段 permanently_closed弃用

3.41

2020 年 5 月 20 日

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

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

3.40.11

2020 年 4 月 28 日

变更:

  • 向地点搜索和地点详情结果添加了一个新字段 business_status。请使用此字段,而不是 permanently_closed
  • 修复了请求(新)PlaceResult.utc_offset_minutes 时出现的错误控制台警告;现在会针对已弃用PlaceResult.utc_offset 返回警告。

3.40.9

2020 年 4 月 14 日

变更:

  • 如果传递的 mapDiv 不是元素,则 Map 现在会抛出更易于诊断的 InvalidValueError。
  • Chrome 浏览器将地址自动填充到 google.maps.places.Autocomplete 中时,不应再触发向服务器发送的自动补全请求(这样可以避免产生费用)。
  • 提高了 maxWidth 属性的准确性。在此变更生效之前,如果您将 InfoWindowmaxWidth 指定为 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_nowutc_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 Codes 是一种短代码,可为世界上的每个地点提供地址,即使在没有传统街道地址的地区也是如此。
  • Internet Explorer 9 已不再受支持。

弃用:

  • AutocompleteplaceIdOnly 参数已被弃用。
  • Maps JavaScript API 中的 Fusion Tables 图层自 2018 年 12 月 3 日起弃用。Fusion Tables 图层将于 2019 年 12 月 3 日完全停用,此后将无法再使用。 了解详情

2018 年 11 月 13 日

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

变更:

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

3.34

2018 年 8 月 14 日

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

变更:

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

3.33

2018 年 6 月 11 日

变更:

2018 年 5 月 16 日

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

变更:

3.32

2018 年 2 月 13 日

变更:

  • 现在,我们推出了一款新的实验性渲染器
  • 我们现已推出新的实验性基础地图

3.31

2018 年 2 月 13 日

变更:

  • 默认情况下,将前 256 个标记设为 DOM 标记,然后将后续标记设为 Tile 标记。当前默认值为所有功能块标记。
  • 在高缩放级别(放大)下拖动街景小人时,首选 NEAREST,而不是 Google 选择的 BEST 全景图片。
  • 现在,当在 mousedown 处理程序中更改 gestureHandling: none 时,它的工作方式与 draggable: false 相同(现在会在 mousedown 上生效)。

2017 年 11 月 21 日

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

变更:

  • 现在,系统会通过“地点详情”请求返回 region 字段。

3.30

2017 年 8 月 16 日

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

变更:

3.29

2017 年 5 月 16 日

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

变更:

  • 由于底层基础架构更新,用户生成的(自定义)街景全景图片的 ID 格式已发生变化。这会略微增加可用的全景照片数量。
    • 在 Maps JavaScript API 中使用旧全景 ID 请求用户生成(自定义)的全景图仍然有效。如果您尝试使用 StreetViewPanoramaOptions 对象的 position 属性查找全景,结果将包含新的全景 ID。无需映射旧全景 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 日

现在,您可以限制自动补全预测仅在多个国家/地区显示。为此,您可以在 AutocompleteOptionscomponentRestrictions 字段中指定最多 5 个国家/地区。

2016 年 11 月 15 日

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

变更:

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

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

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

已弃用登录状态下的地图

2016 年 10 月 6 日

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

路线服务响应中途经航点的变化

2016 年 8 月 29 日

Directions 服务响应中的 via_waypoints 字段包含一个未在原始请求中指定的途经点数组。via_waypoints 字段将继续显示在可拖动的路线响应中,但在替代路线响应中已被弃用。版本 3.27 将是最后一版支持备选路线中 via_waypoints 的 API。

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

3.26

2016 年 8 月 18 日

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

变更:

  • 新的街景渲染器带来了渲染方面的改进,包括更流畅的过渡和动画、改进的对象建模、对移动设备的更好支持以及更清晰的控件。如需了解详情,请参阅 Google 地理位置开发者博客
  • 该 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 日

已修复:

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

2016 年 2 月 15 日

变更:

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

3.23

2016 年 1 月 18 日

变更:

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

2016 年 1 月 4 日

已修复:

  • 问题 9009:在从触摸合成鼠标事件时,使用左键而非中键,以实现与 jQuery 的兼容性。
  • 问题 4201:该 API 不再使用 eval()。 因此,现在可以在不使用 unsafe-eval 内容安全政策指令的情况下使用该 API。

2015 年 12 月 21 日

变更:

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

2015 年 12 月 2 日

变更:

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

2015 年 11 月 25 日

变更:

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

2015 年 11 月 19 日

变更:

  • 白色 Google 徽标(适用于样式化地图)

已修复:

  • 问题 8674:Bug:针对 img { max-width: 100%; } 进行保护

3.22

2016 年 1 月 7 日

已修复:

  • 问题 9009:在从触摸合成鼠标事件时,使用左键而非中键,以实现与 jQuery 的兼容性。

2015 年 11 月 10 日

变更:

  • 如果出行方式为驾车,Directions 服务和 Distance Matrix 服务现在会返回预测的交通时间(在响应字段 duration_in_traffic 中)。如需接收预测的出行时间,请在请求中包含 drivingOptions 对象字面量,并指定当前或未来的 departureTime。您还可以指定乐观、悲观或最佳猜测(默认)的 trafficModel,以影响计算出行时间时使用的假设。如需了解详情,请参阅 Directions 服务Distance Matrix 服务的开发者指南。注意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.originDirectionsRequest.destinationDirectionsWaypoint.location 现在接受 Place 对象,而 DistanceMatrixRequest.originsDistanceMatrixRequest.destinations 现在接受 Place 对象数组。

2015 年 9 月 15 日

变更:

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

已弃用:

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

2015 年 9 月 1 日

变更:

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

Internet Explorer 8 支持结束

2015 年 8 月 31 日

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

3.21

2015 年 8 月 5 日

变更:

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

2015 年 7 月 21 日

变更:

  • 推出了带有标签的标记
  • 修复了以下问题:在超高清屏幕上,iOS7 出现多边形内存不足错误
  • IE10 及更高版本上的触摸事件修复
  • 现在,对开发者提供的输入内容进行错误验证时,系统会将错误输出到控制台,而不是抛出错误。

2015 年 7 月 6 日

已修复:

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

2015 年 6 月 17 日

变更:

  • 已修复: 问题 6321: bug:“Uncaught TypeError: Cannot read property 'x' of undefined”仅在 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 chrome 的改进

2015 年 2 月 17 日

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

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

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

改版后的可用版本:

实验性:3.20

版本:3.19

冻结:3.18

3.19

2015 年 4 月 24 日

已修复:

  • 已登录模式下的光标。

2015 年 3 月 19 日

已修复:

2015 年 1 月 20 日

已修复:

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

2015 年 1 月 13 日

已修复:

  • 现在,屏幕阅读器会忽略功能块

2014 年 12 月 17 日

已修复:

  • 问题 6917:bug:形状不遵循地图的“draggable”属性
  • 问题 7445: Bug:使用 v3 Maps 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 库中。
  • overview_path 添加到 DirectionsRoute,提供表示整个路线的编码多段线。

2014 年 5 月 26 日

添加时间:

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

2014 年 5 月 20 日

3.17 已发布到实验版。

3.16

2014 年 4 月 15 日

已修复:

2014 年 4 月 8 日

添加时间:

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

已修复:

  • 在更多位置接受 LatLngLiteral。
  • 当 Roboto 加载完成时,InfoWindow 会自行调整大小(问题 5713

2014 年 3 月 31 日

已修复:

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

2014 年 3 月 26 日

已修复:

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

2014 年 3 月 18 日

添加时间:

2014 年 3 月 12 日

添加时间:

2014 年 2 月 24 日

添加时间:

  • 支持在距离矩阵服务和 Directions 服务中使用渡轮。

2014 年 2 月 17 日

3.16 已发布到实验版。

3.15

2014 年 3 月 3 日

已修复:

2014 年 2 月 10 日

已修复:

  • 在 Chrome/Linux 上停用所有 tile 硬件加速,以解决更大的 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
  • Bug:iOS 上的视觉刷新信息窗口(问题 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 以便以编程方式添加覆盖层
  • 针对街景全景图公开了 StreetViewPov

已修复:

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

2013 年 1 月 22 日

添加时间:

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

2013 年 1 月 15 日

已修复:

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

2013 年 1 月 7 日

已修复:

2012 年 12 月 17 日

添加时间:

  • 新增语言:乌尔都语和冰岛语

已修复:

  • 导航后 IE9 中的地图模糊不清/朦胧不清(问题 3875

2012 年 12 月 17 日

添加时间:

  • 新增语言:乌尔都语和冰岛语

已修复:

  • 导航后 IE9 中的地图模糊不清/朦胧不清(问题 3875

2012 年 12 月 10 日

添加时间:

  • 能够加载设置了 crossorigin 属性的图片

已修复:

  • 在特写镜头中显示带有远程图片的标记的问题(问题 4616
  • 在 IE 7/8 上重新显示折线上的符号时出现 JS 错误

2012 年 12 月 3 日

已修复:

  • Markermanager 库无法与 Maps API JS v3 搭配使用(问题 4543

2012 年 11 月 27 日

添加时间:

  • 在高 DPI 设备上使用高 DPI 画布来优化标记

已修复:

3.10

2013 年 2 月 4 日

已修复:

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

2012 年 9 月 25 日

添加时间:

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

2012 年 9 月 11 日

新变化:

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

2012 年 8 月 28 日

添加时间:

  • 类型到 Places API textSearch

已修复:

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

2012 年 8 月 14 日

显著变更:

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

3.9

2012 年 9 月 10 日

已修复:

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

2012 年 8 月 9 日

已修复:

  • Android 3.x 上的语法错误

2012 年 7 月 31 日

显著变更:

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

已修复:

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

2012 年 7 月 25 日

已修复:

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

2012 年 7 月 17 日

已修复:

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

显著变更:

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

2012 年 7 月 10 日

显著变更:

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

2012 年 6 月 27 日

添加时间:

显著变更:

  • 将“transparent”识别为颜色。

2012 年 6 月 23 日

添加时间:

  • 符号
  • HeatmapLayer
http://mapsplatform.googleblog.com/2012/06/powerful-data-visualization-with.html
  • 新的样式设置选项“粗细”和“颜色”:

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

2012 年 5 月 15 日

添加时间:

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

3.8

2012 年 5 月 1 日

已修复:

2012 年 4 月 23 日

已修复:

  • 关闭街景后,街景小人仍停留在具有自定义地图类型的地图上(问题 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) 问题 3971
  • 缩放后的标记在 IE < 9 上呈现不正确(问题 3912问题 3908

添加时间:

  • 不透明度添加到 GroundOverlay(问题 2767
  • 将 utc_offset 和 opening_hours 添加到 PlaceResult 中(问题 2431
  • 将 clickToGo 选项添加到 StreetViewPanoramaOptions(问题 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
  • stop() 到 MouseEvent,从而停止事件传播(问题 2172)

2012 年 1 月 31 日

已修复:

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

2012 年 1 月 24 日

已修复:

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

2012 年 1 月 16 日

已修复:

  • 在绘制模式下,Pegman 不应可拖动
  • 正确触发事件,同时考虑多边形和其他图层的 zIndex
  • 添加 KmlLayer“状态”属性(问题 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 字段:分辨率

已修复:

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

3.6

2011 年 10 月 31 日

已修复:

  • 在 IE7 上将 Maps 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日

已修复:

  • 使用 Canvas 渲染标记时,Chrome/Windows 中出现内存泄漏
  • 航向为 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 的正确语言版本
  • 如果没有信息窗口 HTML、名称或说明,则不要在 KML 地图项上打开信息窗口。
  • 修复了回归问题:高 DPI 图块损坏

2011 年 8 月 24 日

已解决的问题:

  • 针对 Chrome/Mac 停用了硬件加速: 修复了标记渲染问题和叠加层点击问题(问题 3544问题 3551
  • 修复了 Android 上在页面滚动后出现的双指张合缩放问题(问题 3373

显著变更:

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

2011 年 8 月 17 日

显著变更:

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

3.5

2011 年 8 月 10 日

已修复:

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

2011 年 8 月 2 日

已解决的问题:

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

显著变更:

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

2011 年 7 月 18 日

已解决的问题:

  • 在 iOS >= 4.1 上滚动网页时,事件 LatLng 不正确(问题 3373

2011 年 7 月 11 日

已解决的问题:

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

显著变更:

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

2011 年 7 月 5 日

已解决的问题:

  • 已修复:地图不可拖动时,标记光标不显示的问题(问题 3120

显著变更:

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

2011 年 6 月 30 日

已解决的问题:

  • 修复:初始地图图块会被双重提取
  • 修复了以下问题: 在 3.4 之后创建地图时,maptypeid_changed 事件会多次触发(问题 3051

显著变更:

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

2011 年 6 月 8 日

已解决的问题:

  • 已修复:如果缩放级别变化大于 2,则不再以动画形式显示缩放效果(问题 3033

显著变更:

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

2011 年 5 月 17 日

已解决的问题:

  • 已修复:IE7 中的 Streetview 渲染问题(问题 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)
  • 已修复:在 IE8 中,当广告单元可见时平移会出错(问题 3159
  • 允许在地图类型控件中显示地形地图和混合地图,而不显示标准地图和卫星地图(问题 3089
  • 为高 DPI 屏幕加载高 DPI 图块(问题 2614)

显著变更:

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

2011 年 4 月 14 日

已解决的问题:

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

显著变更:

  • 现在,多段线和多边形可在 Canvas 中呈现(如果可能)。
  • 多段线和多边形边界上事件的 LatLng 现在会吸附到线条上最近的点。

2011 年 4 月 5 日

已解决的问题:

  • panTo 在触控设备上不进行动画处理(问题 3066)
  • Marker.MAX_ZINDEX 未定义(问题 3184)

2011 年 3 月 28 日

已解决的问题:

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

显著变更:

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

2011 年 3 月 22 日

已解决的问题:

  • 街景小人显示在自定义地图类型中(问题 3154

显著变更:

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

2011 年 3 月 17 日

已解决的问题:

显著变更:

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

2011 年 3 月 11 日

已解决的问题:

  • 双击标记不再会缩放地图(问题 3090
  • 现在,带有自定义标记阴影的定位点可以正常运行了(问题 3112)

显著变更:

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

2011 年 3 月 2 日

显著变更:

  • 现在,标记可在 Canvas/VML 中呈现(如果可用)
  • 在支持触控的设备上,为多段线、多边形、KML 提供更大的点击目标

2011 年 2 月 22 日

已解决的问题:

  • 通过“anchorPoint”MVC 属性公开了信息窗口锚点(问题 2860
  • 修复了缩放级别为 0 和 1 时的 Hybrid 问题(问题 3062
  • 修复了快速添加/移除地图中的圆形/矩形时出现的问题(问题 3052
  • 修复了触摸设备上 draggable: false 的问题(问题 3044

2011 年 2 月 18 日

已解决的问题:

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

显著变更:

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

2011 年 2 月 8 日

显著变更:

  • 全新的分层地图类型控件 - 方便触控!
  • 新徽标(问题 2574
  • 将 MarkerShape.coord 重命名为 MarkerShape.coords,以与 HTML <area> coords 属性保持一致

3.3

2011 年 3 月 17 日

已解决的问题:

  • 多边形未呈现

2011 年 2 月 8 日

已解决的问题:

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

2011 年 1 月 21 日

显著变更:

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

2011 年 1 月 17 日

已解决的问题:

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

2011 年 1 月 6 日

已解决的问题:

显著变更:

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

2010 年 12 月 23 日

已解决的问题:

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

2010 年 12 月 21 日

已解决的问题:

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

显著变更:

  • 在触控设备上,无论请求的是 ZOOM_PAN 还是 SMALL 导航控件,我们现在都会显示适合触控的缩放控件。如果设备支持在浏览器中使用多点触控,则不会显示任何缩放控件,因为缩放是通过捏合手势完成的。

2010 年 12 月 9 日

已解决的问题:

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

显著变更:

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

2010 年 12 月 5 日

已解决的问题:

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

显著变更:

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

2010 年 11 月 28 日

已解决的问题:

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

2010 年 11 月 16 日

更改的问题:

显著变更:

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

3.2

2010 年 11 月 11 日

显著变更:

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

2010 年 10 月 11 日

更改的问题:

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

显著变更:

  • 街景默认处于启用状态
  • 修复了“this”未传递给 .getTileUrl 的 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)

显著变更:

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

2010 年 8 月 9 日

显著变更:

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

3.1

2010 年 9 月 28 日

显著变更:

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

2010 年 8 月 9 日

显著变更:

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

2010 年 8 月 5 日

更改的问题:

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

显著变更:

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

2010 年 7 月 29 日

更改的问题:

显著变更:

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

2010 年 7 月 22 日

更改的问题:

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

显著变更:

  • 拖动多边形时不再触发点击事件
  • 点击扩展到 InfoWindow 之外的表单选择元素不再触发地图点击事件
  • 点击 KML 叠加层不再触发地图点击事件
  • 现在,系统会自动平移街景视图,以使信息窗口显示在屏幕上
  • 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
  • 为多边形和多段线添加了测地属性
  • 为多边形和多段线添加了可点击选项
  • 为 GroundOverlay 添加了可点击选项

2010 年 5 月 13 日

变更的问题

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

显著变更:

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

2010年5月7日

变更的问题

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

显著变更:

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

2010 年 4 月 30 日

变更的问题

  • 问题 2230:地图在初始化时没有使用预期的自定义投影

显著变更:

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

2010 年 4 月 26 日

变更的问题

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

变更的问题

  • 问题 1976: 自定义图标和可拖动标记问题
  • 问题 2107: 可拖动标记在拖动到地图外时消失
  • 问题 2181:基本地图的投影属性不存在

显著变更:

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

2010 年 3 月 23 日

显著变更:

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

2010 年 3 月 15 日

显著变更:

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

2010 年 3 月 10 日

变更的问题

  • 问题 1801:折线/多边形 zIndex
  • 问题 2144: DirectionsRequest 应提供 avoidHighways 选项
  • 问题 2207: Bug:折线在 IE 中被填充
  • 问题 2113: 在 1 月版本发布后,FF 中在高缩放级别下折线出现中断

显著变更:

2010 年 3 月 3 日

变更的问题

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

显著变更:

  • 修复了地图跳动问题。
  • 改进了连续两次缩放功能。
  • 标记拖动事件 .latLng 不再被混淆。

2010 年 2 月 26 日

变更的问题

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

显著变更:

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

2010 年 2 月 8 日

变更的问题

  • 问题 2135: bug:如果您在折线中使用多边形的 MVCArray,则折线会闭合。

显著变更:

  • 添加了新的 Rectangle 类
  • 添加了新的圆形类
  • 修复了在创建然后移除标记时发生的内存泄漏问题。
  • 停止注释 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
  • event 命名空间添加了新的静态方法:
    • 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: Bug:自定义图标和可拖动标记问题
  • 问题 2063:缩小 OverlayView 子类时出现变量名称冲突

显著变更:

2009 年 12 月 17 日

显著变更:

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

2009 年 12 月 10 日

变更的问题

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

其他显著变化:

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

2009 年 11 月 25 日

变更的问题

其他显著变化:

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

2009 年 11 月 11 日

变更的问题

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

其他显著变化:

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

2009 年 10 月 29 日

变更的问题

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

其他显著变化:

2009 年 10 月 26 日

变更的问题

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

其他显著变化:

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

2009 年 10 月 15 日

变更的问题

其他显著变化:

  • 文档更新:
    • 公开了新方法: LatLngBounds.isEmpty()
    • 按名称对所有方法、事件、属性和常量进行了排序
    • 修复了多段线和多边形选项属性中的错误类型

2009 年 9 月 28 日

  • 改进了多边形渲染性能。
  • 修复了 SVGView 的 JS 警告问题。

2009 年 9 月 22 日

变更的问题

  • 问题 1420: 功能:向 API 添加了 Polyline 类
  • 问题 1371:当地图移动时,map.bounds_changed 事件会重复触发
  • 问题 1700: 在 Firefox 3.5 中缩小后,点击位置不正确
  • 问题 1702:当父元素中存在滚动偏移时,点击和双击事件中报告的 latLng 不正确
  • 问题 1723:在 iPhone 上拖动时,地图会跳动

其他显著变化:

  • 发布了多段线和多边形!这些功能可让您在地图上绘制线条或填充区域,指定描边和填充样式,并支持大多数鼠标事件(即尚不支持鼠标悬停)。它们可在所有受支持的浏览器(IE6.0+、Firefox 2.0+、Safari 3.1+、Chrome)中使用,包括受支持的移动设备。
  • 添加了新的地图事件“idle”,当地图在一段时间内未移动时触发。解决了问题 1371
  • 修复了点击事件返回的 LatLng 值不正确的问题。
  • 修复了 iPhone 上的双指张合缩放 bug。请参阅问题 1723

2009 年 9 月 10 日

变更的问题

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

其他显著变化:

  • 针对 get/set 方法和事件名称修改了语法,如下所述。为了保持向后兼容性,系统仍支持旧语法。例如:
    • set_funBoat() => setFunBoat()
    • get_funBoat() => getFunBoat()
    • funBoat_changed => funboat_changed
  • 向 OverlayView 接口添加了新方法“onAdd”,该方法会在首次初始化窗格和投影时调用。这解决了问题 1377
  • OverlayView 接口的“remove”方法已重命名为“onRemove”。旧名称仍受支持,以保持向后兼容性。

2009 年 9 月 2 日

变更的问题

  • 问题 1525: 低缩放级别下的 get_bounds 错误
  • 问题 1596: 平移超出世界地图的北部或南部边缘时,系统会返回错误
  • 问题 1643: bug:地图滚动轮不必要地
  • 问题 1379:我无法在 V3 中看到韩国地图数据

其他显著变化:

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

2009 年 8 月 24 日

变更的问题

  • 问题 1567:将 map.set_center 设置为附近的位置不起作用。
  • 问题 1605: 滚动地图时,页面也会滚动
  • 问题 1467:平移地图功能 + 动画

其他显著变化:

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

2009 年 8 月 14 日

变更的问题

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

其他显著变化:

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

2009 年 8 月 4 日

变更的问题

  • 问题 1393:允许可拖动的标记
  • 问题 1448: Bug:API v3 需要 checkResize() 函数(或等效函数)
  • 问题 1404: Opera 中的光标存在错误
  • 问题 1514: 使用 HTML 4.01 strict 时,MapType 选择箭头显示不正确
  • 问题 1426: 信息窗口 z-index 控制

其他显著变化:

  • 在 iPhone 上进行捏合和拖动操作时,应更加顺畅。
  • 为 InfoWindow 对象添加了 zIndex 设置器和获取器。

文档变更:

  • 添加了标记 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“已更改”方法。这不应影响开发者的代码,因为这些方法之前并未实际使用过。
  • 已从 Geocoder Request 对象中移除 partialmatch 选项。如果开发者继续传递该参数,则不会对查询产生任何影响。

2009 年 6 月 12 日

更改的问题:

  • 问题 1363: bug:地图点击事件未在 iPhone 上调度

其他显著变化:

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