# 样式概述

# 样式的作用

为了实现对地图样式的最大程度的定制化配置,地图样式中的数据源,图层式样,字体文件,图标文件等都通过一个统一的 style 来配置,这个样式服务是地图初始化的关键,这也是为什么引擎中的各个图层需要在 style 加载好之后才能创建。

本小节介绍了地图样式的获取方式,使用方式。之后的小节将会分别介绍:

  • 通用样式服务及规格
  • 样式与可视化效果搭配
  • 自定义地图样式

# 如何获取地图样式

开发者可以通过以下三种方式为地图提供样式:

# 1. 使用通用的样式

目前提供预置的2种样式,供开发者直接使用:

样式名称 样式链接
普通日间 aimap://styles/aimap/normal-v4
宝石蓝 aimap://styles/aimap/darkblue-v5

这个链接可以直接填写到style参数中,地图引擎会根据运行环境转换成对应的服务链接。

# 2. 在 Ustyle 中定制

如果预置的样式不符合项目中的实际需求,开发者也可以通过 Ustyle 平台 进行定制。

# 3. 使用空样式

在某些情况下,项目中可能只需要用到地图引擎的可视化功能,而不需要显示底图。所以,开发者可以提供一个空的样式,创建出一个不显示任何图层的地图。空样式的加载方式:

new aimap.Map({
    ...,
    style: {
        version: 8,
        glyphs: "path_to_your_fonts/{fontstack}/{range}.pbf",
        sources: {},
        layers: []
    },
    ...
});
1
2
3
4
5
6
7
8
9
10

# 如何使用地图样式

在初始化地图时,开发者需要指定当前地图的样式。使用方式如下:

new aimap.Map({
    ...,
    style: '一个地图样式或者样式对象',
    ...
})
1
2
3
4
5

更详细的说明文档请参考创建地图初始化参数

开发者也可以在地图运行过程中随时修改地图样式,使用方式如下:

map.setStyle('一个地图样式或者样式对象')
1

更详细的说明文档请参考地图样式操作

最后更新于: 6/15/2022, 4:17:49 PM