Document Maps JavaScript API Reference Manual Amap Official Layer TileLayer

TileLayer

AMap.TileLayer

Tile layer class, which is a base class. Construct a tile layer object and set the layer properties via TileLayerOptions.

new AMap.TileLayer(opts: TileLayerOptions)

Parameter

options(TileLayerOptions): Tile Layer Parameters

Attribute

Type

Description

tileUrl

String

Tile image URL such as ' https://abc{0,1,2,3}.amap.com/tile?x=[x]&y=[y]&z=[z] ' [x] , [y] , [z] represent the xyz of the tile respectively

zooms

[Number, Number]

The range of supported zoom levels, default range [2-30]

dataZooms

[Number, Number]

The range of zoom levels supported by the data, default range [2-30]

opacity

Number

The transparency of the layer, ranging from [0 ~ 1], where 1 means completely opaque and 0 means completely transparent. Default value: 1

visible

Boolean

Whether to display, default: true

zIndex

Number

The overlay order value of the layers, the larger the number, the higher the layer level; 1 means the bottom layer. Default zIndex: 4

tileSize

Number

Tile size, value: 256, means the tile size is 256*256; 128, means the tile size is 128*128; 64, means the tile size is 64*64. Default value: 256

Demo

//Create a custom tile layer and specify the getTileUrl property
var tileLayer = new AMap.TileLayer({
   tileUrl: 'https://wprd0{1,2,3,4}.is.autonavi.com/appmaptile?x=[x]&y=[y]&z=[z]&size=1&scl=1&style=8&ltype=11',
   zIndex:2
});

//Add custom layers to the map
map.add(tileLayer);

Method

setTileUrl(url)

Set the tile URL of the layer

Parameterurl(String) Tile Map URL

Demo:

tileLayer.setTileUrl('https://wprd0{1,2,3,4}.is.autonavi.com/appmaptile?x=[x]&y=[y]&z=[z]&size=1&scl=1&style=8&ltype=11');

reload()

Reload Layer Resources and Re-render

Demo:

tileLayer.reload();

getOptions()

Get Layer Parameter Information

return value: (Object) Layer Parameter Information

Demo:

tileLayer.getOptions();

getzIndex()

Get Layer Hierarchy

return value: (Number) zIndex layer level

Demo:

tileLayer.getzIndex();

setzIndex(zIndex)

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

Parameter:  zIndex (NumberLayer level value

Demo:

tileLayer.setzIndex(10);

getOpacity()

Get layer transparency

return value: (Number) opacity layer transparency

Demo:

tileLayer.getOpacity();

setOpacity(opacity)

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

Parameter:  opacity (Number)  Layer transparency

Demo:

tileLayer.setOpacity(0.5);

getZooms()

Get the level range for displaying this layer, default range is [2-30]

return value: ([Number, Number]The level range for displaying this layer

Demo:

tileLayer.getZooms();

setZooms(zooms)

Set the level range for displaying this layer

Parameter:  zooms([Number, Number]Zoom Range Displayable for This Layer

Demo:

tileLayer.setZooms([8,12]);

show()

Set Layer Visible

Demo:

tileLayer.show();

hide()

Set Layer Hidden

Demo:

tileLayer.hide();

Event

Event Name

Description

complete

Tile Load Complete Event

For event object property descriptions, go to:MapsEvent