前言

在地圖應(yīng)用中加缘，Overlay（覆蓋層）是指在地圖圖層之上疊加顯示的額外信息層。這些覆蓋層可以用來展示各種數(shù)據(jù)闯第，如交通狀況、用戶位置缀拭、興趣點(diǎn)（POI）等咳短。在高德地圖SDK中，可以使用多種類型的覆蓋層來增強(qiáng)地圖的功能和視覺效果蛛淋。文本介紹簡單的點(diǎn)線面和文本覆蓋物使用方法和屬性咙好。

地圖類中覆蓋物的接口

• AMap類中添加Overlay的接口：

• AMap類中刪除Overlay的接口：

覆蓋物類

Marker示例

// 定義Maker坐標(biāo)點(diǎn)
LatLng point = new LatLng(39.963175, 116.400244);
// 構(gòu)建Marker圖標(biāo)
BitmapDescriptor bitmap = BitmapDescriptorFactory
        .fromResource(R.drawable.icon_mark_a);
// 構(gòu)建MarkerOption茬缩，用于在地圖上添加Marker
MarkerOptions option = new MarkerOptions()
        .position(point)
        .icon(bitmap);
// 在地圖上添加Marker赤惊，并顯示
Marker marker = map.addMarker(option);

Polyline示例

// 構(gòu)建折線點(diǎn)坐標(biāo)
LatLng p1 = new LatLng(39.97923, 116.357428);
LatLng p2 = new LatLng(39.94923, 116.397428);
LatLng p3 = new LatLng(39.97923, 116.437428);
List<LatLng> points = new ArrayList<>();
points.add(p1);
points.add(p2);
points.add(p3);

// 設(shè)置折線的屬性
PolylineOptions polylineOptions = new PolylineOptions()
        .width(10)
        .color(0xAA00FF00)
        .addAll(points);
// 在地圖上繪制折線
Polyline polyline = map.addPolyline(polylineOptions);

Polygon示例

// 多邊形頂點(diǎn)位置
List<LatLng> points = new ArrayList<>();
points.add(new LatLng(39.93923, 116.357428));
points.add(new LatLng(39.91923, 116.327428));
points.add(new LatLng(39.89923, 116.347428));
points.add(new LatLng(39.89923, 116.367428));
points.add(new LatLng(39.91923, 116.387428));

// 構(gòu)造PolygonOptions
PolygonOptions polygonOptions = new PolygonOptions()
        .addAll(points)
        .fillColor(0xAAFFFF00) // 填充顏色
        .strokeColor(0xAA00FF00) // 邊框顏色
        .strokeWidth(5); // 邊框?qū)挾?
// 在地圖上顯示多邊形
Polygon polygon = map.addPolygon(polygonOptions);

Arc示例

// 添加弧線坐標(biāo)數(shù)據(jù)
LatLng p1 = new LatLng(39.97923, 116.357428); // 起點(diǎn)
LatLng p2 = new LatLng(40.00923, 116.397428); // 中間點(diǎn)
LatLng p3 = new LatLng(39.97923, 116.437428); // 終點(diǎn)

// 構(gòu)造ArcOptions對象
ArcOptions arcOptions = new ArcOptions()
        .strokeColor(Color.RED)
        .strokeWidth(10)
        .point(p1, p2, p3);

// 在地圖上顯示弧線
Arc arc = map.addArc(arcOptions);

Circle示例

// 圓心位置
LatLng center = new LatLng(39.90923, 116.447428);

// 構(gòu)造CircleOptions對象
CircleOptions circleOptions = new CircleOptions()
        .center(center)
        .radius(1400)
        .fillColor(0xAAFFFF00) // 填充顏色
        .strokeColor(0xAA00ff00) // 邊框顏色
        .strokeWidth(5);  // 邊框?qū)?
// 在地圖上顯示圓
Circle circle = map.addCircle(circleOptions);

移除示例

// 從地圖上刪除所有的覆蓋物（marker，circle凰锡，polyline 等對象）未舟，
// 但myLocationOverlay（內(nèi)置定位覆蓋物）除外。
boolean isKeepMyLocationOverlay = true;
map.clear(isKeepMyLocationOverlay);

效果圖

覆蓋物.png

Marker的更多屬性

Marker有如下屬性：

• 錨點(diǎn)：圖標(biāo)擺放在地圖上的基準(zhǔn)點(diǎn)掂为。默認(rèn)情況下裕膀，錨點(diǎn)是從圖片下沿的中間處。
• 位置：Marker是通過經(jīng)緯度的值來標(biāo)注在地圖上的勇哗。
• 標(biāo)題：當(dāng)點(diǎn)擊Marker顯示在信息窗口的文字昼扛，隨時可以更改。
• 片段：除了標(biāo)題外其他的文字，隨時可以更改抄谐。
• 圖標(biāo)：Marker顯示的圖標(biāo)渺鹦。如果未設(shè)置圖標(biāo)，API 將使用默認(rèn)的圖標(biāo)蛹含，高德為默認(rèn)圖標(biāo)提供了10 種顏色備選毅厚。默認(rèn)情況下垮刹，Marker 是可見的匾嘱』莶颍可隨時更改Marker 的可見性痰娱。

常用屬性

交互

啟用允許拖拽時馋评，在拖拽Marker時放接，會回調(diào)AMap.OnMarkerDragListener。

動畫

• SDK提供了給Marker增加幀動畫的功能纠脾，通過MarkerOptions類來設(shè)置，一次傳入一個Icon列表蜕青，通過period設(shè)定刷新的幀間隔苟蹈。
• 自地圖 SDK V4.0.0 版本起，SDK 提供了給 Marker 設(shè)置動畫的方法右核。通過Marker類setAnimation方法設(shè)置慧脱。

其它屬性

折線的更多屬性

地圖線段覆蓋物。一個線段是多個連貫點(diǎn)的集合線段。它擁有以下屬性：

• 頂點(diǎn)：線段是由兩個頂點(diǎn)之間連貫的點(diǎn)構(gòu)成的躯概。如果兩個頂點(diǎn)相同登钥，則一個線段將閉合。
• 寬度：寬度是單位是像素楞陷。寬度是可視區(qū)域的縮放級別無關(guān)。默認(rèn)為10茉唉。
• 顏色：線段的顏色是ARGB格式固蛾，顏色格式可以參考 Color。默認(rèn)是黑色(0xff000000)度陆。
• Z軸：Z軸是控制地圖覆蓋物之間的繪制層次的參數(shù)艾凯。這個參數(shù)能夠控制Circles、Polygons懂傀、Polyline的繪制層次趾诗，但不會影響Marker。 Z軸數(shù)值越大的覆蓋物將會繪制在更上層蹬蚁。如果兩個及兩個以上覆蓋物的Z軸數(shù)值相同恃泪，則最后的繪制結(jié)果是隨機(jī)的。 覆蓋物的Z軸默認(rèn)為0犀斋。
• 可見：這個屬性表示了線段是否可以顯示在地圖上贝乎。如果設(shè)置為不可見，則繪制地圖時不會繪制此線段叽粹，但其他屬性不受影響览效。默認(rèn)為可見。

常用屬性

其它屬性

多邊形的更多屬性

多邊形覆蓋物设江。一個多邊形可以凸面體，也可是凹面體攘轩。它有以下屬性:

• 邊框：一個多邊開的邊框由一系列的順時針或逆時針頂點(diǎn)組成叉存。邊框不需要聲明起點(diǎn)和終點(diǎn)一致。如果邊框的起點(diǎn)與終點(diǎn)不一致度帮，API會自動將它封閉歼捏。
• 邊框?qū)挾龋哼吙虻膶挾纫韵袼貫閱挝唬粫芸梢晠^(qū)域縮放級別的影響笨篷。默認(rèn)為10瞳秽。
• 邊框顏色：邊框顏色是一個ARGB格式，ARGB請參考android.graphics.Color率翅。默認(rèn)為黑色寂诱。
• 填充顏色：填充顏色是一個ARGB格式，ARGB格式可參考android.graphics.Color安聘。默認(rèn)是透明的痰洒。如果多邊形的幾何圖形不正確，則填充顏色不會被繪制浴韭。
• Z軸：Z軸是控制覆蓋物重復(fù)區(qū)域的繪制順序的值丘喻。Z軸較大的覆蓋物會在繪制在Z軸較小的覆蓋物上面。如果兩個覆蓋物的Z軸數(shù)值相同念颈，則覆蓋情況將隨機(jī)泉粉。默認(rèn)為0。
• 可見性：標(biāo)示多邊形是否可見榴芳。如果可見性為否嗡靡，則不會被繪制。

多邊形方法必須在主線程中調(diào)用窟感，否則會拋出IllegalStateException讨彼。

常用屬性

其它屬性

Arc的更多屬性

弧形的類。它有以下屬性:

• 邊框?qū)挾龋夯⌒芜吙虻膶挾戎剀＿@個值設(shè)置后不會受到可視區(qū)域縮放級別的影響箭阶。默認(rèn)為10。
• 邊框顏色：邊框顏色是一個ARGB格式戈鲁，ARGB請參考android.graphics.Color仇参。默認(rèn)為黑色。
• Z軸：Z軸是控制覆蓋物重復(fù)區(qū)域的繪制順序的值荞彼。Z軸較大的覆蓋物會繪制在Z軸較小的覆蓋物上面冈敛。如果兩個覆蓋物的Z軸數(shù)值相同待笑，則覆蓋情況將隨機(jī)鸣皂。默認(rèn)值為0。
• 可見性：標(biāo)示弧形是否可見暮蹂。如果可見性為否寞缝，則不會被繪制。

弧形方法必須在主線程中調(diào)用仰泻，否則會拋出IllegalStateException荆陆。

Circle的更多屬性

圓對象有以下屬性：

• 圓心 ：圓心的經(jīng)緯度命浴。
• 半徑： 圓的半徑，單位：米贱除。這個值應(yīng)該大于等于0生闲。
• 邊框?qū)挾龋?圓的邊框?qū)挾取＿@個值設(shè)置后不會受到可視區(qū)域縮放級別的影響月幌。默認(rèn)為10碍讯。
• 邊框顏色：圓的邊框顏色，ARGB格式扯躺。默認(rèn)為黑色冲茸。
• 填充顏色：圓的填充顏色屯阀，ARGB格式。默認(rèn)為透明轴术。
• Z軸：Z軸是控制覆蓋物重復(fù)區(qū)域的繪制順序的值难衰。Z軸較大的覆蓋物會繪制在Z軸較小的覆蓋物上面。如果兩個覆蓋物的Z軸數(shù)值相同逗栽，則覆蓋情況將隨機(jī)盖袭。默認(rèn)值為0。
• 可見屬性：標(biāo)識多邊形是否可見彼宠。如果可見性為否鳄虱，則不會被繪制。

圓形方法必須在主線程中調(diào)用凭峡，否則會拋出IllegalStateException拙已。

Text的更多屬性