跳到主要内容

TileLayer

地图的主要图层，显示一个连续的方形栅格图像网格。

示例​

请参见 Map Control。

TileLayer 属性​

additional_options​

一个字典，包含静态信息，用于替换 url_template 中的占位符。例如，应用 API 密钥。

enable_retina_mode​

一个布尔值，指示是否启用视网膜模式。

enable_tms​

是否启用 TMS(Tile Map Service)。

error_image_src​

错误图像的源地址，可以是 URL 或图像资产文件的路径。

evict_error_tile_strategy​

错误图块的驱逐策略。如果图块加载错误且策略不是 None，则根据指定策略驱逐图块。

fallback_url​

如果从 url_template 获取图块时出错，则使用的回退 URL。

keep_alive​

一个布尔值，指示是否保持地图活跃。

keep_buffer​

保持（当平移地图时）卸载之前的图块行数和列数。

max_native_zoom​

最大本机缩放级别。

max_zoom​

最大缩放级别。

min_native_zoom​

最小本机缩放级别。

min_zoom​

最小缩放级别。

pan_buffer​

当加载图块时，默认情况下仅加载可见图块。这个选项通过增加给定数量的图块来增加加载的图块，这可以帮助防止用户在平移地图时看到加载中的图块。

将平移缓冲设置得太高可能会影响性能，通常将其设置为 0 或 1。

subdomains​

图块服务器的子域名列表。

tile_bounds​

图块的地理边界。只有边界内的图块才会被加载。

值的类型为 MapLatitudeLongitudeBounds。

tile_size​

每个图块的大小。

默认值为 256。

url_template​

用于检索图块图像的模板 URL。这是一个包含占位符的字符串，当填充这些占位符时，将创建一个指向特定图块的 URL/URI。

zoom_offset​

用于图块 URL 中的缩放号将被此值偏移。

zoom_reverse​

是否反转用于图块 URL 中的缩放号。

事件​

on_image_error​

图像错误事件的事件处理程序。