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

向地图添加图块层 (Android SDK)

项目
04/08/2024

注意

Azure Maps Android SDK 停用

适用于 Android 的 Azure Maps 本机 SDK 现已弃用，将于 2025 年 3 月 31 日停用。为了避免服务中断，请在 2025 年 3 月 31 日之前迁移到 Azure Maps Web SDK。有关详细信息，请参阅 Azure Maps Android SDK 迁移指南。

本文介绍如何使用 Azure Maps Android SDK 在地图上呈现图块层。通过图块层可以在 Azure Maps 基本地图图块顶部附加图像。可在缩放级别和图块网格文档中找到有关 Azure Maps 图块系统的详细信息。

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

X、Y、缩放表示法 - 基于缩放级别，x 是列，y 是图块网格中图块的行位置。
Quadkey 表示法 - 将 x、y、缩放信息合并到单个字符串值（即图块的唯一标识符）中。
边界框 - 边界框坐标可用于指定格式为 {west},{south},{east},{north} 的图像，这通常由 {west},{south},{east},{north} 使用。

提示

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} - 子域值占位符（如果指定了子域值）。
azmapsdomain.invalid - 用于将图块请求的域和身份验证与地图所使用的相同值对齐的占位符。在调用由 Azure Maps 托管的图块服务时使用此参数。

先决条件

若要完成本文中的过程，需要安装 Azure Maps Android SDK 来加载地图。

将图块层添加到地图

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

TileLayer layer = new TileLayer(
    tileUrl("https://tiles.openseamap.org/seamark/{z}/{x}/{y}.png"),
    opacity(0.8f),
    tileSize(256),
    minSourceZoom(7),
    maxSourceZoom(17)
);

map.layers.add(layer, "labels");

val layer = TileLayer(
    tileUrl("https://tiles.openseamap.org/seamark/{z}/{x}/{y}.png"),
    opacity(0.8f),
    tileSize(256),
    minSourceZoom(7),
    maxSourceZoom(17)
)

map.layers.add(layer, "labels")

以下屏幕截图显示上述代码在地图上显示了一个深色灰度类型的航海信息图块层。

显示图块层的 Android 地图

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

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

TileLayer layer = new TileLayer(
    tileUrl("https://mrdata.usgs.gov/services/gscworld?FORMAT=image/png&HEIGHT=1024&LAYERS=geology&REQUEST=GetMap&STYLES=default&TILED=true&TRANSPARENT=true&WIDTH=1024&VERSION=1.3.0&SERVICE=WMS&CRS=EPSG:3857&BBOX={bbox-epsg-3857}"),
    tileSize(1024)
);

map.layers.add(layer, "labels");

val layer = TileLayer(
    tileUrl("https://mrdata.usgs.gov/services/gscworld?FORMAT=image/png&HEIGHT=1024&LAYERS=geology&REQUEST=GetMap&STYLES=default&TILED=true&TRANSPARENT=true&WIDTH=1024&VERSION=1.3.0&SERVICE=WMS&CRS=EPSG:3857&BBOX={bbox-epsg-3857}"),
    tileSize(1024)
)

map.layers.add(layer, "labels")

下面的屏幕截图显示的是上面的代码在地图上的标签下覆盖了来自美国地质调查局 (USGS) 的地质数据的 Web 地图定位服务后的情况。

显示 WMS 图块层的 Android 地图

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

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

{TileMatrix} =>{z}
{TileRow} =>{y}
{TileCol} =>{x}

TileLayer layer = new TileLayer(
    tileUrl("https://basemap.nationalmap.gov/arcgis/rest/services/USGSImageryOnly/MapServer/WMTS/tile/1.0.0/USGSImageryOnly/default/GoogleMapsCompatible/{z}/{y}/{x}"),
    tileSize(256),
    bounds(-173.25000107492872, 0.0005794121990209753, 146.12527718104752, 71.506811402077),
    maxSourceZoom(18)
);

map.layers.add(layer, "transit");

val layer = TileLayer(
    tileUrl("https://basemap.nationalmap.gov/arcgis/rest/services/USGSImageryOnly/MapServer/WMTS/tile/1.0.0/USGSImageryOnly/default/GoogleMapsCompatible/{z}/{y}/{x}"),
    tileSize(256),
    bounds(-173.25000107492872, 0.0005794121990209753, 146.12527718104752, 71.506811402077),
    maxSourceZoom(18)
)

map.layers.add(layer, "transit")

下面的屏幕截图显示的是上面的代码在地图上的道路和标签下覆盖了来自美国地质调查局 (USGS) 国家地图的图像的 Web 地图定位图块服务后的情况。

显示 WMTS 图块层的 Android 地图

后续步骤

请参阅以下文章，详细了解在地图上覆盖图像的方法。

图像层

通过