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

AMap.VectorLayer

Vector layer class, which can uniformly manage geometric shapes such as lines and polygons. Construct a VectorLayer object and set layer properties through opts.

new AMap.VectorLayer(opts: Object)

Parameter

Attribute	Type	Description
visible	Boolean	Visibility
zIndex	Number	The stacking order of heatmap layers on the map, default: 110

Demo

var layer = new AMap.VectorLayer();
map.add(layer);
var circle = new AMap.Circle({
  center: new AMap.LngLat(77.193045, 28.59086), 
  radius: 1000, 
});
layer.add(circle);

Method

add(vectors)

Add vector overlay to the collection, duplicate overlays are not supported

Parameter: vectors (VectorOverlay | Array<VectorOverlay>) Vector Overlay or Vector Overlay Array

Demo:

var circle = new AMap.Circle({
  center: new AMap.LngLat(77.193045, 28.59086),
  radius: 1000, 
});
layer.add(circle);

remove(vectors)

Remove Vector Overlay

Parameter: vectors (VectorOverlay | Array<VectorOverlay>) Vector Overlay or Vector Overlay Array

Demo:

layer.remove(circle);

show()

Display Layer

Demo:

layer.show();

hide()

Hide layer

Demo:

layer.hide();

has(vectors)

Determine if the passed vector overlay instance is in the VectorLayer

Parameter: vectors (VectorOverlay) Vector overlay or vector overlay array

return value: (Boolean) Boolean value

Demo:

layer.has(circle);

clear()

Clear VectorLayer

Demo:

layer.clear();

setOptions(opt)

Batch modify vector overlay attributes (including line style, color, etc.)

Parameter: opt (Object)

Demo:

layer.setOptions({
  strokeColor: "#FF33FF", 
});

query(geometry)

Query vector overlay information based on latitude and longitude

Parameter: geometry (LngLatLike) Valid latitude and longitude information

return value: (VectorOverlay| undefined) vector overlay

Demo:

layer.query(new AMap.LngLat(116.433322, 39.900255));

getBounds()

Get the display range of all overlays in VectorOverlay

return value: (Bounds | undefined) Latitude and longitude range values

Demo:

layer.getBounds();