TileLayer
用于在地图上加载和显示瓦片图层。 请注意,大多数tile服务器都需要属性,可以自定义配置
使用示例
hnsdk.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png?{foo}', {foo: 'bar', attribution: '© <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,b或c, 可以省略),{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 选项
| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
minZoom | Number | 0 | 此图层将显示的最小缩放级别(包括最小) |
maxZoom | Number | 18 | 此图层将显示的最大缩放级别(包括最大) |
subdomains | String|String[] | 'abc' | 瓦片服务的子域。 可以以一个字符串(其中每个字母是一个子域名)或字符串数组的形式传递。 |
errorTileUrl | String | '' | 显示瓦片图像的 URL,以代替加载失败的瓦片。 |
zoomOffset | Number | 0 | 平铺 URL 中使用的缩放数字将与此值发生偏移。 |
tms | Boolean | false | 如果为 true,则反转瓦片的 Y 轴编号 (为 TMS 服务启用此选项)。 |
zoomReverse | Boolean | false | 如果设置为 true,则图块 URL 中使用的缩放数字将被反转 (maxZoom - zoom 而不是 zoom) |
detectRetina | Boolean | false | 如果 true 并且用户在视网膜显示器上,它将请求四个指定大小一半的瓦片和更大的缩放级别,以使用高分辨率。 |
crossOrigin | Boolean|String | false | 是否将 crossOrigin 属性添加到瓦片中。 如果提供了字符串,则所有瓦片的 crossOrigin 属性都将设置为提供的字符串。 如果您想访问平铺像素数据,则需要这样做。 有关有效的字符串值,请参阅 CORS 设置。 |
referrerPolicy | Boolean|String | false | 是否将referrerPolicy 属性添加到图块中。如果提供了字符串,则所有图块都将其 referrerPolicy 属性设置为提供的字符串。如果您的地图的渲染上下文具有严格的默认值,但您的图块提供者需要有效的引用者,则可能需要这样做(例如,验证 API 令牌)。 请参考 HTMLImageElement.referrerPolicy 了解有效的字符串值。 |
