你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将图块层添加到地图

项目
08/28/2024

本文介绍如何在地图上覆盖图块层。通过图块层可以在 Azure Maps 基本地图图块顶部附加图像。有关 Azure Maps 图块系统的详细信息，请参阅缩放级别和图块网格。

图块层将从服务器加载图块。这些图像可以预呈现，也可以是动态呈现。使用图块层能理解的命名约定（像服务器上的任何其他图像一样）对预呈现图像进行存储。动态呈现的图像使用一项服务接近实时地加载图像。 Azure Maps TileLayer 类支持以下三个不同的图块服务命名约定：

X、Y、缩放表示法 - X 是列，Y 是图块网格中图块的行位置，缩放表示法是一个基于缩放级别的值。
Quadkey 表示法 - 将 x、y、缩放信息合并到单个字符串值中。此字符串值将成为单个图块的唯一标识符。
边界框 - 以边界框坐标格式指定图像：{west},{south},{east},{north}。 Web 映射服务 (WMS) 通常使用此格式。

提示

TileLayer 是直观显示地图上的大型数据集的好办法。不仅可以从图像中生成图块层，而且还可以将矢量数据呈现为图块层。通过将矢量数据呈现为图块层，地图控件只需加载文件大小小于它们所代表的矢量数据的图块。此方法通常用于呈现地图上的数百万行数据。

传递到图块层中的图块 URL 必须是 TileJSON 资源的 http 或 https URL 或使用以下参数的图块 URL 模板：

{x} - 图块的 X 位置。还需要 {y} 和 {z}。
{y} - 图块的 Y 位置。还需要 {x} 和 {z}。
{z} - 图块的缩放级别。还需要 {x} 和 {y}。
{quadkey} - 基于必应地图图块系统命名约定的图块 quadkey 标识符。
{bbox-epsg-3857} - EPSG 3857 空间引用系统中格式为 {west},{south},{east},{north} 的边界框字符串。
{subdomain} - 子域值的占位符，如果已指定，则添加 subdomain。
{azMapsDomain} - 用于将图块请求的域和身份验证与地图所使用的相同值对齐的占位符。

添加图块层

此示例演示如何创建指向一组图块的图块层。此示例使用 x、y、缩放图块系统。此图块层的源是 OpenSeaMap 项目，其中包含众包航海图。查看雷达图数据时，用户最好能在导航地图时清楚地查看城市的标签。通过在 labels 层下插入图块层，可以实现此行为。

//Create a tile layer and add it to the map below the label layer.
map.layers.add(new atlas.layer.TileLayer({
    tileUrl: 'https://tiles.openseamap.org/seamark/{z}/{x}/{y}.png',
    opacity: 0.8,
    tileSize: 256,
    minSourceZoom: 7,
    maxSourceZoom: 17
}), 'labels');

有关如何创建指向一组图块（使用 x、y、缩放图块系统）的图块层的完整功能示例，请参阅 Azure Maps 示例中的使用 X、Y 和 Z 的图块层示例。此示例中图块层的来源是来自 OpenSeaMap 项目的航海图，它是在 ODbL 下许可的 OpenStreetMaps 项目。有关此示例的源代码，请参见使用 X、Y 和 Z 源代码的图块层。

添加 OGC Web 地图定位服务 (WMS)

Web 地图定位服务 (WMS) 是一项开放地理空间信息联盟 (OGC) 标准，用于提供地图数据的图像。此格式提供了许多可用于 Azure Maps 的开放数据集。如果此类型的服务支持 EPSG:3857 坐标参考系 (CRS)，该服务就可用于图块层。使用 WMS 服务时，将宽度和高度参数设置为该服务支持的值，请确保在 tileSize 选项中设置此值。在带格式的 URL 中，将服务的 BBOX 参数设置为 {bbox-epsg-3857} 占位符。

有关如何创建指向 Web 地图定位服务 (WMS) 的图块层的完整功能示例，请参阅 Azure Maps 示例中的 WMS 图块层示例。如需此示例的源代码，请参阅 WMS 图块层源代码。

以下屏幕截图显示了 WMS 图块层示例，该示例将来自美国地质调查局 (USGS) 的地理数据的 Web 地图定位服务叠加在地图上方和标签下方。

添加 OGC Web 地图定位图块服务 (WMTS)

Web 地图定位图块服务 (WMTS) 是一项开放地理空间信息联盟 (OGC) 标准，用于为地图提供基于图库的重叠。此格式提供了许多可用于 Azure Maps 的开放数据集。如果此类型的服务支持 EPSG:3857 或 GoogleMapsCompatible 坐标参考系 (CRS)，该服务就可用于图块层。使用 WMTS 服务时，将宽度和高度参数设置该服务支持的相同值，请确保也在 tileSize 选项中设置此值。在带格式的 URL 中，相应地替换以下占位符：