public final class

TileOverlayOptions

extends Object
java.lang.Object
   ↳ com.tencent.tencentmap.mapsdk.maps.model.TileOverlayOptions

Class Overview

TileProvider builder

Summary

Constants
int MAX_DATA_LEVEL
int MAX_VISIBLE_LEVEL
int MIN_DATA_LEVEL
Public Constructors
TileOverlayOptions()
Public Methods
TileOverlayOptions betterQuality(boolean betterQuality)
This method is deprecated. 弃用，建议使用displayHD(boolean)
TileOverlayOptions dataLevelRange(int minLevel, int maxLevel)
设置Tile请求展示的数据级别范围，若范围超出真实数据级别范围，则显示不显示Tile
TileOverlayOptions diskCacheDir(String diskCacheDir)
设置磁盘缓存路径
如果有 WRITE_EXTERNAL_STORAGE 权限，diskCacheDir 的父目录为 /sdcard/tencentmapsdk/app_package_name/data/tile
如果没有 WRITE_EXTERNAL_STORAGE 权限，diskCacheDir 的父目录为 getFilesDir().getAbsolutePath()/tile
TileOverlayOptions displayHD(boolean displayHD)
当前 TileOverlay 是否以高清模式加载
String getDiskCacheDir()
获取磁盘缓存目录
int getLevelOffset()
获取数据级别的偏移值
int getMaxDataLevel()
获取最大数据级别
int getMaxMemoryCacheSize(TencentMapContext context)
获得最大内存缓存大小
int getMaxVisibleLevel()
获取最小显示级别
int getMinDataLevel()
获取最小数据级别
int getMinVisibleLevel()
获取最大显示级别
TileProvider getTileProvider()
获取瓦片源
String getVersionInfo()
设置瓦片数据的版本信息
int getZIndex()
获取 TileOverlay 的绘制层级
boolean isBetterQuality()
This method is deprecated. 弃用，建议使用isDisplayHD()
boolean isDisplayHD()
是否高清
boolean isReuseTile()
是否复用瓦片
TileOverlayOptions levelOffset(int offset)
设置Tile数据级别偏移，范围[-2,2]
TileOverlayOptions maxMemoryCacheSize(int maxMemoryCacheSize)
设置最大内存缓存值
TileOverlayOptions reuseTile(boolean reuseTile)
当前 TileOverlay 是否采用复用瓦片策略加载
TileOverlayOptions tileProvider(TileProvider tileProvider)
设置瓦片源
String toString()
TileOverlayOptions versionInfo(String versionInfo)
瓦片图层数据的版本信息，不同版本的数据会存放到 getDiskCacheDir()/getVersionInfo() 目录下
TileOverlayOptions visibleLevelRange(int minLevel, int maxLevel)
设置Tile可显示的级别范围
TileOverlayOptions zIndex(int zindex)
设置瓦片的绘制层级，该参数只对添加多层 TileOverlay 的情况下有意义。
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int MAX_DATA_LEVEL

Constant Value: 20 (0x00000014)

public static final int MAX_VISIBLE_LEVEL

Constant Value: 22 (0x00000016)

public static final int MIN_DATA_LEVEL

Constant Value: 3 (0x00000003)

Public Constructors

public TileOverlayOptions ()

Public Methods

public TileOverlayOptions betterQuality (boolean betterQuality)

This method is deprecated.
弃用，建议使用displayHD(boolean)

当前 TileOverlay 是否以高清模式加载

Parameters
betterQuality 如果是 true，将以高清模式加载瓦片，每个瓦片会以 256*256 dp 展示；
如果是 false，每个瓦片会以 512 * 512 dp 展示；
地图 sdk 默认为 true
Returns
  • 更新之后的Options对象

public TileOverlayOptions dataLevelRange (int minLevel, int maxLevel)

设置Tile请求展示的数据级别范围，若范围超出真实数据级别范围，则显示不显示Tile

Parameters
minLevel 最小级别，取值范围[MIN_DATA_LEVEL,MAX_DATA_LEVEL]，有效性校验必须小于等于最大级别
maxLevel 最大级别，取值范围[MIN_DATA_LEVEL,MAX_DATA_LEVEL]，有效性校验必须大于等于最大级别
Returns
  • 更新之后的Options对象

public TileOverlayOptions diskCacheDir (String diskCacheDir)

设置磁盘缓存路径
如果有 WRITE_EXTERNAL_STORAGE 权限，diskCacheDir 的父目录为 /sdcard/tencentmapsdk/app_package_name/data/tile
如果没有 WRITE_EXTERNAL_STORAGE 权限，diskCacheDir 的父目录为 getFilesDir().getAbsolutePath()/tile

Parameters
diskCacheDir 磁盘缓存目录
Returns
  • 更新之后的Options对象

public TileOverlayOptions displayHD (boolean displayHD)

当前 TileOverlay 是否以高清模式加载

Parameters
displayHD 如果是 true，将以高清模式加载瓦片，每个瓦片会以 256*256 dp 展示；
如果是 false，每个瓦片会以 512 * 512 dp 展示；
地图 sdk 默认为 true
Returns
  • 更新之后的Options对象

public String getDiskCacheDir ()

获取磁盘缓存目录

public int getLevelOffset ()

获取数据级别的偏移值

Returns
  • 偏移值

public int getMaxDataLevel ()

获取最大数据级别

public int getMaxMemoryCacheSize (TencentMapContext context)

获得最大内存缓存大小

public int getMaxVisibleLevel ()

获取最小显示级别

public int getMinDataLevel ()

获取最小数据级别

public int getMinVisibleLevel ()

获取最大显示级别

public TileProvider getTileProvider ()

获取瓦片源

Returns
  • 更新之后的Options对象

public String getVersionInfo ()

设置瓦片数据的版本信息

public int getZIndex ()

获取 TileOverlay 的绘制层级

public boolean isBetterQuality ()

This method is deprecated.
弃用，建议使用isDisplayHD()

是否高清@return

public boolean isDisplayHD ()

是否高清

public boolean isReuseTile ()

是否复用瓦片

public TileOverlayOptions levelOffset (int offset)

设置Tile数据级别偏移，范围[-2,2]

Parameters
offset 偏移量，默认为1
Returns
  • 更新之后的Options对象

public TileOverlayOptions maxMemoryCacheSize (int maxMemoryCacheSize)

设置最大内存缓存值

Parameters
maxMemoryCacheSize 内存缓存值 单位：字节
Returns
  • 更新之后的Options对象

public TileOverlayOptions reuseTile (boolean reuseTile)

当前 TileOverlay 是否采用复用瓦片策略加载

Parameters
reuseTile 如果跨级别的瓦片之间图片差异较小，则建议采用true，下载中的瓦片将以复用前序瓦片的形式加载, 可以极大提升加载展示体验
如果跨级别的瓦片之间图片差异较大，则建议采用 false，否则可能会因为复用瓦片策略导致视觉残影的效果
地图 sdk 默认为 false
Returns
  • 更新之后的Options对象

public TileOverlayOptions tileProvider (TileProvider tileProvider)

设置瓦片源

Returns
  • 更新之后的Options对象

public String toString ()

public TileOverlayOptions versionInfo (String versionInfo)

瓦片图层数据的版本信息，不同版本的数据会存放到 getDiskCacheDir()/getVersionInfo() 目录下

Returns
  • 更新之后的Options对象

public TileOverlayOptions visibleLevelRange (int minLevel, int maxLevel)

设置Tile可显示的级别范围

Parameters
minLevel 最小级别，取值范围[MIN_DATA_LEVEL,MAX_VISIBLE_LEVEL]，有效性校验必须小于等于最大级别
maxLevel 最大级别，取值范围[MIN_DATA_LEVEL,MAX_VISIBLE_LEVEL]，有效性校验必须大于等于最大级别
Returns
  • 更新之后的Options对象

public TileOverlayOptions zIndex (int zindex)

设置瓦片的绘制层级，该参数只对添加多层 TileOverlay 的情况下有意义。

Returns
  • 更新之后的Options对象