TileLayer

用于在地图上加载和显示瓦片图层。 请注意,大多数tile服务器都需要属性,可以自定义配置

使用示例

hnsdk.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png?{foo}', {foo: 'bar', attribution: '&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors'}).addTo(map);

URL 模板

表现为以下方式:

'https://{s}.somedomain.com/blabla/{z}/{x}/{y}{r}.png'

{s} 是指可用的子域之一(按顺序使用,以帮助解决每个域的浏览器并行请求限制;子域值在选项中指定;默认为 a, bc , 可以省略), {z} — 缩放级别, {x}{y} — 瓦片坐标。 {r} 可以用来在URL中添加 "@2x" 以加载视网膜瓦片。

您可以在模板中使用自定义键,这些键将通过 TileLayer 选项进行 evaluated ,如下所示:

hnsdk.tileLayer('https://{s}.somedomain.com/{foo}/{z}/{x}/{y}.png', {foo: 'bar'});

Creation

构造函数说明
hnsdk.tilelayer(urlTemplate, options?) 指定 URL 模板和可选的 options 对象,实例化一个瓦片图层对象。

Options 选项

选项类型默认值说明
minZoomNumber0此图层将显示的最小缩放级别(包括最小)
maxZoomNumber18此图层将显示的最大缩放级别(包括最大)
subdomainsString|String[]'abc' 瓦片服务的子域。 可以以一个字符串(其中每个字母是一个子域名)或字符串数组的形式传递。
errorTileUrlString''显示瓦片图像的 URL,以代替加载失败的瓦片。
zoomOffsetNumber0平铺 URL 中使用的缩放数字将与此值发生偏移。
tmsBooleanfalse 如果为 true,则反转瓦片的 Y 轴编号 (为 TMS 服务启用此选项)。
zoomReverseBooleanfalse 如果设置为 true,则图块 URL 中使用的缩放数字将被反转 (maxZoom - zoom 而不是 zoom)
detectRetinaBooleanfalse 如果 true 并且用户在视网膜显示器上,它将请求四个指定大小一半的瓦片和更大的缩放级别,以使用高分辨率。
crossOriginBoolean|Stringfalse 是否将 crossOrigin 属性添加到瓦片中。 如果提供了字符串,则所有瓦片的 crossOrigin 属性都将设置为提供的字符串。 如果您想访问平铺像素数据,则需要这样做。 有关有效的字符串值,请参阅 CORS 设置
referrerPolicyBoolean|Stringfalse 是否将referrerPolicy 属性添加到图块中。如果提供了字符串,则所有图块都将其 referrerPolicy 属性设置为提供的字符串。如果您的地图的渲染上下文具有严格的默认值,但您的图块提供者需要有效的引用者,则可能需要这样做(例如,验证 API 令牌)。 请参考 HTMLImageElement.referrerPolicy 了解有效的字符串值。
Last Updated:
Contributors: 小小志