百度API的基本介紹和使用場景

百度API的基本介紹和使用場景

1. 瞭解

百度API的官方地址，點擊前往

2. 頁面介紹

這個介紹主要給萌新看的，我記得第一次進來了解API的時候存在嚴重的茫然狀態，不知道我要的需求，哪裏能找到對應的API，所以有了這個介紹，懂得朋友略過

3. 主要介紹之基礎地圖

3.1. BaiduMap
這是一個地圖顯示的類，一般會用到的方法如下：

 Overlay    addOverlay(OverlayOptions options)
向地圖添加一個 Overlay
java.util.List<Overlay> addOverlays(java.util.List<OverlayOptions> options)
向地圖添加多個 Overlay
TileOverlay addTileLayer(TileOverlayOptions overlayOptions)
向地圖添加一個TileOverlay覆蓋物
void    animateMapStatus(MapStatusUpdate update)
以動畫方式更新地圖狀態，動畫耗時 300 ms
void    animateMapStatus(MapStatusUpdate update, int durationMs)
以動畫方式更新地圖狀態
void    clear()
清空地圖所有的 Overlay 覆蓋物以及 InfoWindow
MapStatus   getMapStatus()
獲取地圖的當前狀態
java.util.List<Marker>  getMarkersInBounds(LatLngBounds bounds)
獲取指定區域內所有的Marker點
float   getMaxZoomLevel()
獲取地圖最大縮放級別
float   getMinZoomLevel()
獲取地圖最小縮放級別
void    snapshot(BaiduMap.SnapshotReadyCallback callback)
發起截圖請求

設置監聽的方法就不列舉了，基本都有用
3.2. Polyline
這是一個繪製折線的類

int getColor()
獲取折線顏色
java.util.List<LatLng>  getPoints()
獲取折線座標點列表
int getWidth()
獲取折線線寬， 單位：像素
boolean isDottedLine()
獲取折線是否虛線
boolean isFocus() 
void    setColor(int color)
設置折線顏色
void    setDottedLine(boolean dotLine)
設置折線是否虛線
void    setFocus(boolean focus) 
void    setPoints(java.util.List<LatLng> points)
設置折線座標點列表
void    setWidth(int width)
設置折線線寬，默認爲5

3.2. Projection
這是一個座標轉換的類

 LatLng fromScreenLocation(Point point)
將屏幕座標轉換成地理座標
float   metersToEquatorPixels(float meters)
該方法把以米爲計量單位的距離（沿赤道）在當前縮放水平下轉換到一個以像素（水平）爲計量單位的距離。
PointF  toOpenGLLocation(LatLng location, MapStatus mapStatus)
將地理座標轉換成openGL座標，在 OnMapDrawFrameCallback 的 onMapDrawFrame 函數中使用。
PointF  toOpenGLNormalization(LatLng location, MapStatus mapStatus)
將地理座標轉換成歸一化的openGL座標，在 OnMapDrawFrameCallback 的 onMapDrawFrame 函數中使用。
Point   toScreenLocation(LatLng location)
將地理座標轉換成屏幕座標

4. 主要介紹之工具

4.1. AreaUtil 面積工具

static double   calculateArea(LatLng northeast, LatLng southwest)
計算地圖上矩形區域的面積，單位平方米

4.2. CoordinateConverter 座標轉換工具類

LatLng  convert()
執行座標轉換操作
CoordinateConverter coord(LatLng srcCoord)
設置源座標數據
CoordinateConverter from(CoordinateConverter.CoordType coordType)
設置源座標類型

4.3. DistanceUtil 測距工具

static double   getDistance(LatLng p1LL, LatLng p2LL)
返回兩個點之間的距離

5. 使用場景

適用於地圖相關內容巡視，勘察等工作內容。大多數App都只需簡單使用基礎地圖，路線規劃，添加Mark點，添加點擊事件，繪製折線，添加覆蓋物等功能。大家只需關注這些即可。

6. 綜述

寫着寫着發現，本身還是要靠自己去嘗試，一些類和類的相關代碼，比較難表述，在這裏就當是總結吧。感謝大家的瀏覽。