google_maps_flutter_web 版本演进全解从基础地图到 Advanced Markers 的 Web 端能力图谱【免费下载链接】packagesA collection of useful packages maintained by the Flutter team项目地址: https://gitcode.com/GitHub_Trending/pac/packagesgoogle_maps_flutter_web是 Flutter 官方为google_maps_flutter提供的 Web 平台实现endorsed federated plugin底层基于 Google Maps JavaScript API 渲染地图。本文以该仓库的 CHANGELOG.md 为主线系统梳理从 0.1.0 首版开源到 0.6.31 的功能演进脉络并结合 README.md 与lib/src/下的真实源码讲清楚每项能力Advanced Markers、标记聚类、热力图、云样式、地图控件等的启用方式、底层实现与平台边界。读完本文你将掌握该 Web 插件各版本引入的关键特性、如何正确配置web/index.html以及哪些地图能力在 Web 端不可用及原因。包的定位被自动引入的 endorsed Web 实现在动手看功能之前先明确这个包在项目中的角色。从 pubspec.yaml 可以看到它通过flutter.plugin.implements: google_maps_flutter声明自己是主包google_maps_flutter的 Web 端实现flutter: plugin: implements: google_maps_flutter platforms: web: pluginClass: GoogleMapsPlugin fileName: google_maps_flutter_web.dart这意味着它是被背书endorsed的联邦插件实现你在pubspec.yaml中直接依赖google_maps_flutterWeb 平台构建时本包会被自动包含无需手动添加依赖。只有在你想直接import本包调用其自有 API如测试注入时才需要显式声明依赖。插件入口类GoogleMapsPlugin继承自GoogleMapsFlutterPlatform通过registerWith将自己注册为平台默认实例见 google_maps_flutter_web.dart。0.6.x 系列Advanced Markers 时代与新控件开关0.6.x 是 CHANGELOG 中最新的功能密集区间核心主题是 Google Maps 新一代标记体系与地图控件的开放。0.6.0Advanced Markers 全面支持含 Breaking Changes0.6.0 是一次里程碑式的大版本包含破坏性变更与大量新 API泛型约束收紧BREAKINGClusterManagersControllerT与MarkersControllerT, O的泛型参数现在要求T extends Object。从源码看MarkersControllerT extends Object, O的T代表标记对象类型如gmaps.Marker或gmaps.AdvancedMarkerElementO代表对应配置类型MarkerOptions或AdvancedMarkerElementOptions见 markers.dart。Advanced Marker 支持新增AdvancedMarker、AdvancedMarkerController、AdvancedMarkersController等类。源码中AdvancedMarkersController extends MarkersControllergmaps.AdvancedMarkerElement, gmaps.AdvancedMarkerElementOptions通过gmaps.AdvancedMarkerElement(options)创建 JS 侧对象并写入id属性便于追踪markers.dart。PinConfig 定制支持PinConfig自定义背景色background、边框色border与字形glyph打造可缩放的高质量 Pin 标记。自定义标记内容BitmapDescriptor支持AssetMapBitmap资源图片、BytesMapBitmap字节数据与PinConfig三类来源。底层在 convert.dart 中维护了图片尺寸与 blob URL 两级缓存避免重复的网络请求与 URL 创建。能力探测 API新增isAdvancedMarkersAvailable()方法google_maps_flutter_web.dart运行时判断当前 SDK 是否支持高级标记。启用前提Advanced Markers 依赖 Google Maps JavaScript API 的marker库必须在web/index.html的脚本 URL 中追加librariesmarkerscript srchttps://maps.googleapis.com/maps/api/js?keyYOUR_API_KEYlibrariesmarker /script0.6.0 还重构了标记架构传统Marker与新一代AdvancedMarker通过统一的控制器接口并存。在 google_maps_controller.dart 中可以看到控制器会依据mapConfiguration.markerTypeMarkerType.marker/MarkerType.advancedMarker在构造时分别装配LegacyMarkersController或AdvancedMarkersController并断言同一地图内不允许混用两类标记。0.6.1聚类标记的批量增删0.6.1 将聚类标记的 add/remove 操作改为批量执行避免冗余的重复渲染。对应源码中MarkersController.addMarkers会先按clusterManagerId对标记分组groupListsBy再整批交给ClusterManagersController.addItemsmarkers.dartClusterManagersController.addItems最终调用markerClusterer.addMarkers(markers, true)后统一render()marker_clustering.dart。0.6.2colorScheme 云样式亮度控制0.6.2 为云样式cloud-based map styling新增colorScheme参数用于控制地图整体亮度。需要注意0.6.21 修复了一个导致非云样式non-cloud styles无法生效的 bug0.6.22 在 README 中补充了cloudMapId与style参数并存时的注意事项详见下文 0.5.142。0.6.3三大地图控件开关0.6.3 新增对以下三个配置项的支持mapTypeControlEnabled地图类型切换控件fullscreenControlEnabled全屏按钮streetViewControlEnabled街景小人控件。这些开关在MapConfiguration中配置后由 convert.dart 的_configurationAndStyleToGmapsOptions转换为 JS SDK 的MapOptions。0.6.31byte-backed 高级标记的位置更新闪烁修复当前最新版本0.6.31修复了字节支撑byte-backed即BytesMapBitmap类图标的 Advanced Markers 在更新位置时发生闪烁的问题。此类点维护细节表明高级标记的 DOM 内容更新路径AdvancedMarkerController._update中的marker.content options.content等赋值见 marker.dart仍在持续打磨。0.5.x 系列功能爆发期的拼图0.5.x 是插件功能快速扩张的阶段几乎每个小版本都带来一项新能力。0.5.7标记聚类Marker Clustering标记聚类通过ClusterManagerClusterManagersController实现JS 侧映射为MarkerClusterer对象。该功能依赖第三方库 js-markerclustererREADME 要求使用当前受支持的2.5.3版本在web/index.html的head中加入script srchttps://cdn.jsdelivr.net/npm/googlemaps/markerclusterer2.5.3/dist/index.umd.min.js/script仓库自带的浏览器测试页 example/latest/web/index.html 即同时加载了markerclusterer2.5.3与librariesmarker,geometry,visualization。聚类点击事件通过ClusterTapEvent流对外广播google_maps_flutter_web.dart。0.5.10热力图Heatmap现已废弃0.5.10 加入热力图图层底层包装visualization.HeatmapLayer与HeatmapLayerOptions见 heatmap.dart。重要警示Google Maps JavaScript API 自3.65起移除了热力图支持上游已废弃因此使用热力图必须把 SDK 锁定到3.64代价是无法获得后续 bug 修复与新特性。加载方式是在脚本 URL 末尾追加librariesvisualizationv3.64仓库为热力图场景专门维护了固定 SDK 版本的示例页 example/3-64/web/index.html其脚本 URL 带v3.64。此外 README 给出 3.64 下的热力图选项支持矩阵FieldSupportedHeatmap.dissipating✓Heatmap.maxIntensity✓Heatmap.minimumZoomIntensityxHeatmap.maximumZoomIntensityxHeatmapGradient.colorMapSizex0.5.12地面覆盖物与标记锚点0.5.12 新增**地面覆盖物ground overlay**支持源码中由GroundOverlaysController管理对应updateGroundOverlays与GroundOverlayTapEvent事件流google_maps_flutter_web.dart。0.5.11 新增**标记锚点marker anchor**支持使标记图标可以精确对齐到地理坐标点。0.5.122 修复了 Web 端cameraTargetBounds失效的问题。0.5.6 / 0.5.4地图样式体系样式能力是 0.5.x 的另一主线0.5.6支持MapConfiguration.styleJSON 样式字符串与getStyleError()。getStyleError从控制器读取lastStyleErrorgoogle_maps_flutter_web.dart便于开发者排查样式 JSON 解析失败的原因。样式 JSON 中的 styler 字段hue、lightness、saturation、gamma、invert_lightness、visibility、color、weight由 map_styler.dart 中的MapStyler.fromJson逐一解析映射到 JS SDK。0.5.4实现cloudMapId参数开启基于云的地图样式cloud-based maps styling。0.5.142修复同时设置cloudMapId与style时云样式失效的问题明确了二者的互斥/优先级关系。0.5.14 / 0.5.13相机控件与点击事件0.5.14 支持禁用或移动相机控制按钮缩放/旋转控件。0.5.13 修复了 Circles、Polygons、Polyline 的consumeTapEvents在 Web 端不生效的问题并同步将最低 SDK 提升到 Flutter 3.29/Dart 3.7。0.5.141 修复了控制器dispose后仍处理事件、订阅未取消的问题——对应MarkerController.remove中逐个cancel()事件订阅的实现marker.dart。工程底座演进从 dart:html 到 dart:js_interopCHANGELOG 同样忠实记录了底层 Web 技术栈的迁移史这是理解该插件为什么这么写的关键。0.5.5迁移到 dart:js_interop 与 package:web0.5.5 将全部 JS 互操作从旧式dart:html/dart:js迁移到dart:js_interoppackage:web这是 Dart 3.3 时代 Web 互操作的官方方向。随后的两个补丁验证了迁移的代价与收益0.5.61修复dart:js_interop对象字面量工厂在 dart2js 下无法编译的问题0.5.9跟进web: ^1.0.0并升级package:google_maps依赖到^8.0.00.5.62改用TrustedTypes来自web: ^0.5.1配合内容安全策略CSP加固 InfoWindow 等动态 HTML 内容。0.3.3HTML 消毒防线早在 0.3.3 版本convert.dart就开始使用package:sanitize_html的sanitizeHtml对用户创建的 HTML如 InfoWindow 的 title/snippet进行消毒再交给 Maps JS SDK防止注入风险。0.1.04 曾因 InfoWindow 内容包含链接导致崩溃而升级过sanitize_html。当前 pubspec.yaml 中该依赖为sanitize_html: ^2.0.0。0.5.0更严格的错误类型与测试基建BREAKINGsetMapStyle传入非法 JSON 时由原来的FormatException改为抛出MapStyleException错误语义更精确实现GoogleMapsInspectorPlatform允许集成测试检视地图内部状态控制器、聚类管理器、地面覆盖物控制器见 google_maps_flutter_web.dart并配套enableDebugInspection入口。0.3.0Null Safety 迁移含多项破坏性变更0.3.0 完成空安全迁移同时收紧 API 契约Marker.icon不能为null默认回退到BitmapDescriptor.defaultMarkerGoogleMapController.initialCameraPosition变为必填非空buildView的creationId不可为null控制器在remove/dispose之后调用大部分方法会直接抛 AssertionError此前是静默 no-op 或空指针异常。更早的 0.2.0 则以no-op 方式实现 tile overlay 方法避免 Web 端崩溃0.1.1 起支持多边形孔洞Polygon Holes自动反转方向0.1.05/6 修复了getLatLng、InfoWindow 内容可点击、同一时刻只显示一个 InfoWindow 等细节问题。Web 平台特性边界哪些能力不可用及原因CHANGELOG 与 convert.dart 的注释共同勾勒出 Web 端的特性边界这是做 Web 地图时最容易踩坑的地方旋转类能力不可用Web 地图不支持旋转因此compassEnabled、rotateGesturesEnabled、tiltGesturesEnabled被忽略无地图工具栏mapToolbarEnabled无效无我的位置控件myLocationButtonEnabled、myLocationEnabled暂被忽略README 注明需要基于navigator.geolocation自建无defaultMarkerWithHueWeb 端没有按色相着色的默认标记需要彩色 Pin 时请使用自己的资源图片或 0.6.0 的PinConfig室内图层与建筑图层不可用交通图层 Traffic 可用Lite Mode 仅 Android 支持liteModeEnabled在 Web 上不能设为true渲染机制差异Web 通过HtmlElementView渲染地图当GoogleMap位于其他 Flutter 控件之下时需要用package:pointer_interceptor拦截鼠标事件否则覆盖层的点击会被地图吞掉。版本与 SDK 约束演进一览CHANGELOG 中几乎每个版本都标注了最低 SDK 约束可汇总为如下演进线以 CHANGELOG 记录为准版本区间最低 SDK 约束0.6.22 起Flutter 3.38 / Dart 3.100.6.0Flutter 3.35 / Dart 3.90.5.13Flutter 3.29 / Dart 3.70.5.121Flutter 3.27 / Dart 3.60.5.11Flutter 3.22 / Dart 3.40.5.9Dart ^3.4.0 / Flutter ^3.22.00.5.92 一度回退支持 Dart ^3.3.0 / Flutter ^3.19.00.5.5Flutter 3.19 / Dart 3.30.5.42Flutter 3.13 / Dart 3.10.5.4Flutter 3.7 / Dart 2.190.4.08 及更早Flutter 3.3 → 3.0 → 2.10 → 1.20.0当前仓库的 pubspec.yaml 声明sdk: ^3.10.0、flutter: 3.38.0与最新版 CHANGELOG 一致。结语透过这份 CHANGELOG可以看到google_maps_flutter_web的三条演进主线一是能力补齐聚类、热力图、地面覆盖物、样式、控件逐步开放二是技术底座升级dart:js_interop/package:web迁移、TrustedTypes、sanitize_html 安全加固、null safety三是新旧体系切换Legacy Marker → Advanced Marker 的平滑过渡与泛型约束收紧。对开发者而言最直接的实践要点是按功能在web/index.html中正确拼接librariesmarker,drawing,visualization,places与v3.64热力图场景、引入markerclusterer2.5.3并时刻对照 Web 平台特性边界规避不可用选项。若需深入阅读实现可继续翻阅 markers.dart、marker_clustering.dart、convert.dart 以及 example 下的两个浏览器测试页。【免费下载链接】packagesA collection of useful packages maintained by the Flutter team项目地址: https://gitcode.com/GitHub_Trending/pac/packages创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 google_maps_flutter_web 版本演进全解：从基础地图到 Advanced Markers 的 Web 端能力图谱
google_maps_flutter_web 版本演进全解从基础地图到 Advanced Markers 的 Web 端能力图谱【免费下载链接】packagesA collection of useful packages maintained by the Flutter team项目地址: https://gitcode.com/GitHub_Trending/pac/packagesgoogle_maps_flutter_web是 Flutter 官方为google_maps_flutter提供的 Web 平台实现endorsed federated plugin底层基于 Google Maps JavaScript API 渲染地图。本文以该仓库的 CHANGELOG.md 为主线系统梳理从 0.1.0 首版开源到 0.6.31 的功能演进脉络并结合 README.md 与lib/src/下的真实源码讲清楚每项能力Advanced Markers、标记聚类、热力图、云样式、地图控件等的启用方式、底层实现与平台边界。读完本文你将掌握该 Web 插件各版本引入的关键特性、如何正确配置web/index.html以及哪些地图能力在 Web 端不可用及原因。包的定位被自动引入的 endorsed Web 实现在动手看功能之前先明确这个包在项目中的角色。从 pubspec.yaml 可以看到它通过flutter.plugin.implements: google_maps_flutter声明自己是主包google_maps_flutter的 Web 端实现flutter: plugin: implements: google_maps_flutter platforms: web: pluginClass: GoogleMapsPlugin fileName: google_maps_flutter_web.dart这意味着它是被背书endorsed的联邦插件实现你在pubspec.yaml中直接依赖google_maps_flutterWeb 平台构建时本包会被自动包含无需手动添加依赖。只有在你想直接import本包调用其自有 API如测试注入时才需要显式声明依赖。插件入口类GoogleMapsPlugin继承自GoogleMapsFlutterPlatform通过registerWith将自己注册为平台默认实例见 google_maps_flutter_web.dart。0.6.x 系列Advanced Markers 时代与新控件开关0.6.x 是 CHANGELOG 中最新的功能密集区间核心主题是 Google Maps 新一代标记体系与地图控件的开放。0.6.0Advanced Markers 全面支持含 Breaking Changes0.6.0 是一次里程碑式的大版本包含破坏性变更与大量新 API泛型约束收紧BREAKINGClusterManagersControllerT与MarkersControllerT, O的泛型参数现在要求T extends Object。从源码看MarkersControllerT extends Object, O的T代表标记对象类型如gmaps.Marker或gmaps.AdvancedMarkerElementO代表对应配置类型MarkerOptions或AdvancedMarkerElementOptions见 markers.dart。Advanced Marker 支持新增AdvancedMarker、AdvancedMarkerController、AdvancedMarkersController等类。源码中AdvancedMarkersController extends MarkersControllergmaps.AdvancedMarkerElement, gmaps.AdvancedMarkerElementOptions通过gmaps.AdvancedMarkerElement(options)创建 JS 侧对象并写入id属性便于追踪markers.dart。PinConfig 定制支持PinConfig自定义背景色background、边框色border与字形glyph打造可缩放的高质量 Pin 标记。自定义标记内容BitmapDescriptor支持AssetMapBitmap资源图片、BytesMapBitmap字节数据与PinConfig三类来源。底层在 convert.dart 中维护了图片尺寸与 blob URL 两级缓存避免重复的网络请求与 URL 创建。能力探测 API新增isAdvancedMarkersAvailable()方法google_maps_flutter_web.dart运行时判断当前 SDK 是否支持高级标记。启用前提Advanced Markers 依赖 Google Maps JavaScript API 的marker库必须在web/index.html的脚本 URL 中追加librariesmarkerscript srchttps://maps.googleapis.com/maps/api/js?keyYOUR_API_KEYlibrariesmarker /script0.6.0 还重构了标记架构传统Marker与新一代AdvancedMarker通过统一的控制器接口并存。在 google_maps_controller.dart 中可以看到控制器会依据mapConfiguration.markerTypeMarkerType.marker/MarkerType.advancedMarker在构造时分别装配LegacyMarkersController或AdvancedMarkersController并断言同一地图内不允许混用两类标记。0.6.1聚类标记的批量增删0.6.1 将聚类标记的 add/remove 操作改为批量执行避免冗余的重复渲染。对应源码中MarkersController.addMarkers会先按clusterManagerId对标记分组groupListsBy再整批交给ClusterManagersController.addItemsmarkers.dartClusterManagersController.addItems最终调用markerClusterer.addMarkers(markers, true)后统一render()marker_clustering.dart。0.6.2colorScheme 云样式亮度控制0.6.2 为云样式cloud-based map styling新增colorScheme参数用于控制地图整体亮度。需要注意0.6.21 修复了一个导致非云样式non-cloud styles无法生效的 bug0.6.22 在 README 中补充了cloudMapId与style参数并存时的注意事项详见下文 0.5.142。0.6.3三大地图控件开关0.6.3 新增对以下三个配置项的支持mapTypeControlEnabled地图类型切换控件fullscreenControlEnabled全屏按钮streetViewControlEnabled街景小人控件。这些开关在MapConfiguration中配置后由 convert.dart 的_configurationAndStyleToGmapsOptions转换为 JS SDK 的MapOptions。0.6.31byte-backed 高级标记的位置更新闪烁修复当前最新版本0.6.31修复了字节支撑byte-backed即BytesMapBitmap类图标的 Advanced Markers 在更新位置时发生闪烁的问题。此类点维护细节表明高级标记的 DOM 内容更新路径AdvancedMarkerController._update中的marker.content options.content等赋值见 marker.dart仍在持续打磨。0.5.x 系列功能爆发期的拼图0.5.x 是插件功能快速扩张的阶段几乎每个小版本都带来一项新能力。0.5.7标记聚类Marker Clustering标记聚类通过ClusterManagerClusterManagersController实现JS 侧映射为MarkerClusterer对象。该功能依赖第三方库 js-markerclustererREADME 要求使用当前受支持的2.5.3版本在web/index.html的head中加入script srchttps://cdn.jsdelivr.net/npm/googlemaps/markerclusterer2.5.3/dist/index.umd.min.js/script仓库自带的浏览器测试页 example/latest/web/index.html 即同时加载了markerclusterer2.5.3与librariesmarker,geometry,visualization。聚类点击事件通过ClusterTapEvent流对外广播google_maps_flutter_web.dart。0.5.10热力图Heatmap现已废弃0.5.10 加入热力图图层底层包装visualization.HeatmapLayer与HeatmapLayerOptions见 heatmap.dart。重要警示Google Maps JavaScript API 自3.65起移除了热力图支持上游已废弃因此使用热力图必须把 SDK 锁定到3.64代价是无法获得后续 bug 修复与新特性。加载方式是在脚本 URL 末尾追加librariesvisualizationv3.64仓库为热力图场景专门维护了固定 SDK 版本的示例页 example/3-64/web/index.html其脚本 URL 带v3.64。此外 README 给出 3.64 下的热力图选项支持矩阵FieldSupportedHeatmap.dissipating✓Heatmap.maxIntensity✓Heatmap.minimumZoomIntensityxHeatmap.maximumZoomIntensityxHeatmapGradient.colorMapSizex0.5.12地面覆盖物与标记锚点0.5.12 新增**地面覆盖物ground overlay**支持源码中由GroundOverlaysController管理对应updateGroundOverlays与GroundOverlayTapEvent事件流google_maps_flutter_web.dart。0.5.11 新增**标记锚点marker anchor**支持使标记图标可以精确对齐到地理坐标点。0.5.122 修复了 Web 端cameraTargetBounds失效的问题。0.5.6 / 0.5.4地图样式体系样式能力是 0.5.x 的另一主线0.5.6支持MapConfiguration.styleJSON 样式字符串与getStyleError()。getStyleError从控制器读取lastStyleErrorgoogle_maps_flutter_web.dart便于开发者排查样式 JSON 解析失败的原因。样式 JSON 中的 styler 字段hue、lightness、saturation、gamma、invert_lightness、visibility、color、weight由 map_styler.dart 中的MapStyler.fromJson逐一解析映射到 JS SDK。0.5.4实现cloudMapId参数开启基于云的地图样式cloud-based maps styling。0.5.142修复同时设置cloudMapId与style时云样式失效的问题明确了二者的互斥/优先级关系。0.5.14 / 0.5.13相机控件与点击事件0.5.14 支持禁用或移动相机控制按钮缩放/旋转控件。0.5.13 修复了 Circles、Polygons、Polyline 的consumeTapEvents在 Web 端不生效的问题并同步将最低 SDK 提升到 Flutter 3.29/Dart 3.7。0.5.141 修复了控制器dispose后仍处理事件、订阅未取消的问题——对应MarkerController.remove中逐个cancel()事件订阅的实现marker.dart。工程底座演进从 dart:html 到 dart:js_interopCHANGELOG 同样忠实记录了底层 Web 技术栈的迁移史这是理解该插件为什么这么写的关键。0.5.5迁移到 dart:js_interop 与 package:web0.5.5 将全部 JS 互操作从旧式dart:html/dart:js迁移到dart:js_interoppackage:web这是 Dart 3.3 时代 Web 互操作的官方方向。随后的两个补丁验证了迁移的代价与收益0.5.61修复dart:js_interop对象字面量工厂在 dart2js 下无法编译的问题0.5.9跟进web: ^1.0.0并升级package:google_maps依赖到^8.0.00.5.62改用TrustedTypes来自web: ^0.5.1配合内容安全策略CSP加固 InfoWindow 等动态 HTML 内容。0.3.3HTML 消毒防线早在 0.3.3 版本convert.dart就开始使用package:sanitize_html的sanitizeHtml对用户创建的 HTML如 InfoWindow 的 title/snippet进行消毒再交给 Maps JS SDK防止注入风险。0.1.04 曾因 InfoWindow 内容包含链接导致崩溃而升级过sanitize_html。当前 pubspec.yaml 中该依赖为sanitize_html: ^2.0.0。0.5.0更严格的错误类型与测试基建BREAKINGsetMapStyle传入非法 JSON 时由原来的FormatException改为抛出MapStyleException错误语义更精确实现GoogleMapsInspectorPlatform允许集成测试检视地图内部状态控制器、聚类管理器、地面覆盖物控制器见 google_maps_flutter_web.dart并配套enableDebugInspection入口。0.3.0Null Safety 迁移含多项破坏性变更0.3.0 完成空安全迁移同时收紧 API 契约Marker.icon不能为null默认回退到BitmapDescriptor.defaultMarkerGoogleMapController.initialCameraPosition变为必填非空buildView的creationId不可为null控制器在remove/dispose之后调用大部分方法会直接抛 AssertionError此前是静默 no-op 或空指针异常。更早的 0.2.0 则以no-op 方式实现 tile overlay 方法避免 Web 端崩溃0.1.1 起支持多边形孔洞Polygon Holes自动反转方向0.1.05/6 修复了getLatLng、InfoWindow 内容可点击、同一时刻只显示一个 InfoWindow 等细节问题。Web 平台特性边界哪些能力不可用及原因CHANGELOG 与 convert.dart 的注释共同勾勒出 Web 端的特性边界这是做 Web 地图时最容易踩坑的地方旋转类能力不可用Web 地图不支持旋转因此compassEnabled、rotateGesturesEnabled、tiltGesturesEnabled被忽略无地图工具栏mapToolbarEnabled无效无我的位置控件myLocationButtonEnabled、myLocationEnabled暂被忽略README 注明需要基于navigator.geolocation自建无defaultMarkerWithHueWeb 端没有按色相着色的默认标记需要彩色 Pin 时请使用自己的资源图片或 0.6.0 的PinConfig室内图层与建筑图层不可用交通图层 Traffic 可用Lite Mode 仅 Android 支持liteModeEnabled在 Web 上不能设为true渲染机制差异Web 通过HtmlElementView渲染地图当GoogleMap位于其他 Flutter 控件之下时需要用package:pointer_interceptor拦截鼠标事件否则覆盖层的点击会被地图吞掉。版本与 SDK 约束演进一览CHANGELOG 中几乎每个版本都标注了最低 SDK 约束可汇总为如下演进线以 CHANGELOG 记录为准版本区间最低 SDK 约束0.6.22 起Flutter 3.38 / Dart 3.100.6.0Flutter 3.35 / Dart 3.90.5.13Flutter 3.29 / Dart 3.70.5.121Flutter 3.27 / Dart 3.60.5.11Flutter 3.22 / Dart 3.40.5.9Dart ^3.4.0 / Flutter ^3.22.00.5.92 一度回退支持 Dart ^3.3.0 / Flutter ^3.19.00.5.5Flutter 3.19 / Dart 3.30.5.42Flutter 3.13 / Dart 3.10.5.4Flutter 3.7 / Dart 2.190.4.08 及更早Flutter 3.3 → 3.0 → 2.10 → 1.20.0当前仓库的 pubspec.yaml 声明sdk: ^3.10.0、flutter: 3.38.0与最新版 CHANGELOG 一致。结语透过这份 CHANGELOG可以看到google_maps_flutter_web的三条演进主线一是能力补齐聚类、热力图、地面覆盖物、样式、控件逐步开放二是技术底座升级dart:js_interop/package:web迁移、TrustedTypes、sanitize_html 安全加固、null safety三是新旧体系切换Legacy Marker → Advanced Marker 的平滑过渡与泛型约束收紧。对开发者而言最直接的实践要点是按功能在web/index.html中正确拼接librariesmarker,drawing,visualization,places与v3.64热力图场景、引入markerclusterer2.5.3并时刻对照 Web 平台特性边界规避不可用选项。若需深入阅读实现可继续翻阅 markers.dart、marker_clustering.dart、convert.dart 以及 example 下的两个浏览器测试页。【免费下载链接】packagesA collection of useful packages maintained by the Flutter team项目地址: https://gitcode.com/GitHub_Trending/pac/packages创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考