前言

在地圖應(yīng)用中空骚，Overlay（覆蓋層）是指在地圖圖層之上疊加顯示的額外信息層。這些覆蓋層可以用來展示各種數(shù)據(jù)未檩，如交通狀況、用戶位置粟焊、興趣點(diǎn)（POI）等冤狡。在騰訊地圖SDK中，可以使用多種類型的覆蓋層來增強(qiáng)地圖的功能和視覺效果项棠。文本介紹簡單的點(diǎn)線面覆蓋物使用方法和屬性悲雳。

地圖類中覆蓋物的接口

• TencentMap類中添加Overlay的接口：

• TencentMap類中刪除Overlay的接口：

• 覆蓋物類移除接口Removable：

覆蓋物類

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(point)
        .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對(duì)象
ArcOptions arcOptions = new ArcOptions()
        .color(Color.RED)
        .width(10)
        .points(p1, p3)
        .pass(p2);

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

Circle示例

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

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

移除示例

// 清除地圖上所有的標(biāo)注類（Marker晴楔、Polyline、Polygon峭咒，TileOverlay除外）
map.clearAllOverlays();

marker.remove();
polyline.remove();
polygon.remove();
arc.remove();
circle.remove();

效果圖

覆蓋物.png

Marker的更多屬性

點(diǎn)標(biāo)記滥崩，是在地圖上用來標(biāo)記一個(gè)經(jīng)緯度坐標(biāo)的覆蓋物，包括點(diǎn)圖標(biāo)和浮在點(diǎn)之上的信息窗（常稱之為InfoWindow）讹语。騰訊地圖SDK為點(diǎn)標(biāo)記提供了豐富的樣式和場景使用钙皮。

騰訊地圖SDK提供很多默認(rèn)的Marker樣式，通過TencentMap添加Marker接口顽决，即可添一個(gè)默認(rèn)樣式的Marker短条。

Marker marker = mTencentMap.addMarker(new MarkerOptions(position));

開發(fā)者如果想自定義Marker的樣式屬性，可以通過兩個(gè)階段進(jìn)行修改：

1. 創(chuàng)建Marker對(duì)象之前才菠，可以通過修改MarkerOptions選項(xiàng)來初始化Marker
2. 創(chuàng)建Marker對(duì)象之后茸时，可以通過Marker對(duì)象，來修改屬性

常用屬性

交互

• 啟用可點(diǎn)擊時(shí)可都，在點(diǎn)擊Marker時(shí)缓待，會(huì)回調(diào)TencentMap.OnMarkerClickListener。
• 啟用允許拖拽時(shí)渠牲，在拖拽Marker時(shí)旋炒，會(huì)回調(diào)TencentMap.OnMarkerDragListener。

碰撞

騰訊地圖SDK4.4.1版本起签杈，支持點(diǎn)標(biāo)記與地圖POI元素的碰撞功能瘫镇，當(dāng)開啟碰撞功能時(shí)，與點(diǎn)標(biāo)記重合的POI元素將會(huì)被隱藏答姥。

動(dòng)畫

• Marke支持輪播的功能尚粘，通過Marker類setIconLooper方法來傳入輪播圖數(shù)組，并通過MarkerOptions類iconLooper設(shè)定輪播模式敲长。
• Marker還支持Animation動(dòng)畫郎嫁，目前支持平移、縮放潘明、旋轉(zhuǎn)行剂、漸變四種秕噪。通過Marker類setAnimation方法設(shè)置钳降。

其它屬性

折線的更多屬性

線是由一組經(jīng)緯度點(diǎn)按照一定的順序連接而成擦秽，在地圖上繪制線由 Polyline 類定義實(shí)現(xiàn)码荔。通常用來表示一段路漩勤、軌跡等線型場景。

常用屬性

交互

其它屬性

多邊形的更多屬性

多邊形是由 Polygon 類定義的一組在地圖上的封閉線段組成的圖形拇颅，它由一組 LatLng 點(diǎn)按順序連接而成奏司。可以設(shè)置多邊形頂點(diǎn)樟插、描邊的寬度和顏色韵洋、多邊形的填充色、層級(jí)關(guān)系黄锤、可見性搪缨、可點(diǎn)擊性等屬性。

常用屬性

交互

其它屬性

Arc的更多屬性

弧線是由一組經(jīng)緯度點(diǎn)和夾角角度繪制而成，在地圖上繪制弧線由 Arc類定義實(shí)現(xiàn)悠就。

• 基礎(chǔ)圓弧途徑點(diǎn)必須在起終點(diǎn)有效坐標(biāo)范圍內(nèi)千绪，否則不能生成正確的弧線，同時(shí)設(shè)置夾角角度時(shí)梗脾，以夾角角度為準(zhǔn)荸型。
• 如果使用的是起終點(diǎn)繪制弧線，一定要添加夾角角度炸茧。

Circle的更多屬性

圓形是由 Circle 類定義的封閉曲線，在騰訊地圖構(gòu)造一個(gè)圓形需要確定它的圓心和半徑媳搪∶危可以設(shè)置圓心坐標(biāo)、半徑秦爆、描邊的寬度和顏色序愚、圓的填充顏色、層級(jí)等限、可見性爸吮、可點(diǎn)擊性等屬性芬膝。