Flexible 最后更新时间: 2026年07月02日

AMap.TileLayer.Flexible

Flexible tile layer, inherited from AMap.TileLayer, developers can specify the content of each tile by passing the createTile field during construction. Construct a Flexible layer object and set the layer properties through FlexibleLayerOptions

new AMap.TileLayer.Flexible(opts: FlexibleLayerOptions)

Tutorial

Parameter

opts（FlexibleLayerOptions）: Flexible tile layer parameters

Attribute	Type	Description
cacheSize	Number	Number of cached tiles (tiles are a way of organizing map data, dividing the map into small pieces, each called a tile)
createTile	function (x, y, z, success, fail)	Implemented by the developer and automatically called by the API, xyz represent the horizontal, vertical tile numbers and level respectively, with a tile size of 256. Assuming each created tile is A (supports img or canvas), please call back success(A) when the creation or retrieval is successful, and fail() when it does not need to be displayed or fails
dataZooms	[Number, Number]	Supported zoom level range, default range [2-30]
opacity	Number	Layer transparency, range [0 ~ 1], 1 indicates fully opaque, 0 indicates fully transparent. Default value: 1
visible	Boolean	Whether to display, default: true
zIndex	Number	The order value of layer overlay, the larger the number, the higher the layer level, 1 indicates the bottom layer. Default zIndex: 4
tileSize	Number	Tile size, values: 256, indicating a tile size of 256256, 128, indicating a tile size of 128128, 64, indicating a tile size of 64*64. Default value: 256

Method

getOptions()

Get layer parameter information

return value: (Object) Layer Parameter Information

Demo:

flexible.getOptions();

getzIndex()

Get Layer Level

return value: (Number) zIndex Layer Level

Demo:

flexible.getzIndex();

setzIndex(zIndex)

Set the layer level, the higher the number the higher the layer level

Parameter: zIndex (Number) Layer Level Value

Demo:

flexible.setzIndex(10);

getOpacity()

Get layer opacity

return value: (Number) opacity layer opacity

Demo:

flexible.getOpacity();

setOpacity(opacity)

Set layer opacity, range [0 ~ 1], 1 means completely opaque, 0 means completely transparent

Parameter: opacity (Number) Layer opacity

Demo:

flexible.setOpacity(0.5);

getZooms()

Get the display level range of the layer, the default range is [2-30]

return value: ([Number, Number]) Display Level Range for this Layer

Demo:

flexible.getZooms();

setZooms(zooms)

Set the Display Level Range for this Layer

Parameter: zooms([Number, Number]) Zoom Range for this Layer

Demo:

flexible.setZooms([8,12]);

show()

Show Layer

Demo:

flexible.show();

hide()

Hide Layer

Demo:

flexible.hide();

destroy()

Destroy Layer

Demo:

flexible.destroy();

Event

Event Name	Description
complete	Tile Load Finished Event

For event object property descriptions, go to:MapsEvent