个性化地图样式

个性化地图样式允许你自定义地图的配色、道路样式、POI 显示等,打造与 App 风格统一的地图外观。

本文档介绍如何创建和应用个性化地图样式。



创建自定义样式

  1. 前往腾讯位置服务控制台 → 个性化地图样式
  2. 创建样式,编辑配色和元素显示
  3. 发布样式,获取 styleId

应用样式

TencentMap(
  customStyleOptions: CustomStyleOptions(
    enabled: true,
    styleId: 123, // 控制台获取的 styleId
  ),
  ...
)

CustomStyleOptions 参数

参数 类型 默认值 说明
enabled bool false 是否启用自定义样式
styleId int? null 样式 ID(控制台获取)

重置为默认样式

// 禁用自定义样式
TencentMap(
  customStyleOptions: CustomStyleOptions(enabled: false),
  ...
)


注意:建议使用 enabled: false 的方式统一重置。


注意事项

  • 自定义样式仅在 mapType: MapType.normal 时生效,卫星地图下不生效。
  • styleId 在控制台发布样式后获取,未发布的草稿样式无法使用。
  • 首次加载自定义样式需要联网下载,可能有短暂延迟。
本页内容