安卓:百度地图开发

一、百度地图介绍

        百度地图SDK是一套供开发者使用的软件开发工具包(SDK),用于在Android应用程序中集成和使用百度地图功能。通过使用百度地图SDK,开发者可以实现在自己的应用中显示地图、获取定位信息、进行搜索、导航等功能。

        百度地图SDK提供了许多常用的类和方法,用于实现各种地图相关功能。以下是一些常用的类及其方法:

1. MapView类:

   MapView 类是百度地图SDK提供的一个控件类,用于在应用程序的界面上显示地图。它是一个自定义的 View,可以与 BaiduMap 类关联,实现地图的显示和交互功能。

  常用方法: 

   getMap():获取百度地图对象(BaiduMap)的实例。

 onResume():在Activity的生命周期方法中调用,用于恢复地图控件的绘制和定位功能。

 onPause():在Activity的生命周期方法中调用,用于暂停地图控件的绘制和定位功能。

   onDestroy():在Activity的生命周期方法中调用,用于销毁地图控件。

2. BaiduMap类:

 BaiduMap 类是百度地图SDK中的核心类,用于管理和操作地图。它提供了一系列方法和接口,用于显示地图、控制地图状态、添加覆盖物、定位等功能。

常用方法: 

 setMapType():设置地图显示类型,如普通地图、卫星地图等。

 setMapStatus():设置地图的状态,包括中心点坐标、缩放级别、倾斜角度和旋转角度等。

   addOverlay():添加覆盖物(Overlay),如标记点(Marker)、折线(Polyline)和多边形(Polygon)等。

 clear():清除地图上的所有覆盖物。

setOnMapClickListener():设置地图点击事件监听器。

   setOnMarkerClickListener():设置标记点点击事件监听器。

3. GeoCoder类:

GeoCoder 类是百度地图SDK提供的一个地理编码和反地理编码工具类,用于将地址信息与地理坐标之间进行转换。通过 GeoCoder 类,开发者可以实现将地址解析为经纬度坐标(地理编码),或者将经纬度坐标解析为地址信息(反地理编码)。

常用方法: 

 newInstance():创建 GeoCoder 实例。

 setOnGetGeoCodeResultListener():设置地理编码查询结果监听器。

 setOnGetReverseGeoCodeResultListener():设置反地理编码查询结果监听器。

 geocode():发起地理编码查询,将地址信息转换为经纬度坐标。

 reverseGeoCode():发起反地理编码查询,将经纬度坐标转换为地址信息。

4.GeoCodeOption类:

 GeoCodeOption类是百度地图API中的一个选项类,用于设置地理编码的参数和选项。地理编码是将地理位置转换为对应的经纬度坐标的过程。

常用方法

address(String address):设置待编码的地址信息。

city(String city):设置地址所在的城市名。

retCoordType(String coordType):设置返回结果的坐标类型。可选参数包括:"bd09ll"(百度坐标,默认值)、"gcj02"(国测局坐标)和"wgs84"(WGS-84坐标)。

getAddress():获取待编码的地址信息。

getCity():获取地址所在的城市名。

getRetCoordType():获取返回结果的坐标类型。

5.GeoCodeResult类:

        GeoCodeResult类是百度地图API中用于表示地理编码结果的类。通过该类,可以获取地理编码的查询结果信息,包括位置坐标、地址描述等。

getLocation():获取地理编码的位置坐标(LatLng对象)。

getAddress():获取地理编码结果的地址描述。

getBusinessCircle():获取地理编码结果所属的商圈名称。

getSematicDescription():获取地理编码结果的语义化描述信息,即更详细的文字描述。

6. LocationClient类:

         LocationClient 类是百度定位SDK提供的核心类,用于实现设备的定位功能。通过 LocationClient 类,开发者可以获取设备的当前位置信息,包括经纬度坐标、速度、方向等。

常用方法: 

 registerLocationListener():注册定位监听器。

 start():开始定位。

 stop():停止定位。

7.LocationClientOption类:

 LocationClientOption是百度地图定位 SDK 中的一个配置类,用于设置定位相关的参数和选项。通过创建LocationClientOption对象并对其进行适当的配置,可以实现更精确和个性化的定位功能。

常用方法

setLocationMode(LocationClientOption.LocationMode mode):设置定位模式,包括三种模式:

Hight_Accuracy:高精度模式,同时使用 GPS 和网络定位。

Battery_Saving:低功耗模式,只使用网络定位。

Device_Sensors:仅使用 GPS 定位。

setCoorType(String coorType):设置返回的定位结果坐标系类型,包括:

bd09ll:百度经纬度坐标(默认)。

gcj02:国测局加密经纬度坐标。

bd09:百度墨卡托坐标。

setScanSpan(int scanSpan):设置定位间隔时间,单位为毫秒。设定的值大于等于 1000ms 才有效。

setIsNeedAddress(boolean isNeedAddress):设置是否需要获取地址信息,默认为 false。

setOpenGps(boolean isOpenGps):设置是否打开 GPS,默认为 false。

setIsNeedLocationDescribe(boolean isNeedLocationDesc):设置是否需要位置描述信息,默认为 false。

setIsNeedLocationPoiList(boolean isNeedLocationPoiList):设置是否需要周边 POI 信息,默认为 false。

setIsIgnoreCacheException(boolean isIgnoreCacheException):设置是否忽略 GPS 定位失败时的异常,默认为 false。

setEnableSimulateGps(boolean enableSimulateGps):设置是否允许模拟 GPS 位置,默认为 false。

8. RoutePlanSearch类:

 RoutePlanSearch 类是百度地图SDK提供的路线规划搜索类,用于实现不同交通方式的路线规划功能。通过 RoutePlanSearch 类,开发者可以根据起点和终点的坐标,进行驾车、步行、公交等多种交通方式的路线规划,并获取详细的路线信息。

常用方法: 

 setOnGetRoutePlanResultListener():设置路径规划结果监听器。

 drivingSearch():发起驾车路线规划。

walkingSearch():发起步行路线规划。

 transitSearch():发起公交路线规划。

9.LatLng 类:

 LatLng 类是百度地图SDK提供的一个表示经纬度坐标的类。它用于存储地理位置的经度和纬度信息,并提供了一些方法来获取和设置经纬度值。

常用方法: 

latitude():获取纬度值。

longitude():获取经度值。

equals(LatLng other):判断当前 LatLng 对象是否与另一个 LatLng 对象相等。

toString():返回 LatLng 对象的字符串表示。

10. PoiSearch 类: 

PoiSearch 类是百度地图SDK提供的一个兴趣点搜索类,用于实现地图上的兴趣点检索功能。通过 PoiSearch 类,开发者可以根据关键词、地理位置等条件进行兴趣点的搜索,并获取相关的搜索结果。

常用方法: 

newInstance():创建 PoiSearch 实例。

searchInCity(PoiCitySearchOption option):在指定城市内搜索兴趣点。需要创建一个 PoiCitySearchOption 对象,并设置要搜索的城市名称、关键词等参数,然后调用该方法进行搜索。

searchNearby(PoiNearbySearchOption option):在指定位置附近搜索兴趣点。需要创建一个 PoiNearbySearchOption 对象,并设置中心点坐标、搜索半径、关键词等参数,然后调用该方法进行搜索。

searchInBound(PoiBoundSearchOption option):在指定矩形区域内搜索兴趣点。需要创建一个 PoiBoundSearchOption 对象,并设置矩形区域的左下角和右上角坐标、关键词等参数,然后调用该方法进行搜索。

setOnGetPoiSearchResultListener(OnGetPoiSearchResultListener listener):设置兴趣点搜索结果的监听器。需要实现 OnGetPoiSearchResultListener 接口,并将其注册给 PoiSearch 对象,以接收搜索结果的回调。

searchPoiDetail(PoiDetailSearchOption option):根据兴趣点的 UID 获取详细信息。需要创建一个 PoiDetailSearchOption 对象,并设置兴趣点的 UID,然后调用该方法进行详情查询。

searchPoiIndoor(PoiIndoorOption option):在室内地图中搜索兴趣点。需要创建一个 PoiIndoorOption 对象,并设置室内ID、关键词等参数,然后调用该方法进行搜索。

searchPoiPage(int pageNum):加载下一页的搜索结果。需要指定要加载的页码,通过设置之前的搜索选项对象的pageNum属性来实现分页加载。

destroy():销毁 PoiSearch 对象,释放相关资源。

11.PoiResult 类:

  PoiResult 类是百度地图SDK中的一个类,用于表示兴趣点搜索的结果集。它包含了符合搜索条件的一组兴趣点数据,并提供了相关的方法来获取和操作这些数据。

getAllPoi():获取搜索到的所有结果。

error:表示搜索结果的错误码。

12.PoiInfo 类:

PoiInfo 类是百度地图SDK中的一个类,用于表示兴趣点的信息。它包含了兴趣点的名称、地址、经纬度坐标等详细信息,并提供了相关的方法来获取和操作这些数据。

name:POI 名称。

address:POI 地址。

13.PoiOverlay 类:

PoiOverlay 类是百度地图SDK中的一个类,用于在地图上绘制兴趣点标注覆盖物。它可以将 PoiResult 中的兴趣点数据在地图上展示,并提供了一些方法用于自定义标注样式和点击事件处理。

setData():设置搜索到的 POI 数据。

addToMap():将兴趣点标注添加到地图上。

zoomToSpan():缩放地图以适应所有兴趣点。

14.MarkerOptions类:

 MarkerOptions类是百度地图API中的一个选项类,用于设置标记点(Marker)的参数和选项。标记点是地图上用于标识某个位置的图标,常用于显示兴趣点、位置标注等。

position(LatLng position):设置标记点的经纬度坐标。

icon(BitmapDescriptor icon):设置标记点的图标资源,可以是本地图片、远程图片或内置的图标样式。使用BitmapDescriptorFactory类创建BitmapDescriptor对象,并将其作为参数传入。

zIndex(int zIndex):设置标记点的堆叠顺序,值越大表示越靠前。

perspective(boolean perspective):设置标记点的透视效果,即倾斜角度。true表示启用透视效果,false表示不启用。

draggable(boolean draggable):设置标记点是否可拖拽。true表示可拖拽,false表示不可拖拽。

animateType(MarkerAnimateType animateType):设置标记点的动画效果类型。可以使用MarkerAnimateType枚举类中的常量值,如MarkerAnimateType.none、MarkerAnimateType.grow、MarkerAnimateType.jump、MarkerAnimateType.drop。

getIcon():获取标记点的图标资源。

getPosition():获取标记点的经纬度坐标。

getZIndex():获取标记点的堆叠顺序。

isPerspective():判断标记点是否启用透视效果。

isDraggable():判断标记点是否可拖拽。

getAnimateType():获取标记点的动画效果类型。

15.MapStatusUpdate类:

    MapStatusUpdate类是百度地图API中用于设置地图状态更新的类。通过该类,可以对地图进行平移、缩放、旋转等操作。

newLatLng(LatLng latLng):创建一个以指定经纬度为中心点的地图状态更新对象。

newLatLngBounds(LatLngBounds bounds):创建一个以指定经纬度边界为显示范围的地图状态更新对象。

newMapStatus(MapStatus mapStatus):创建一个以指定地图状态为基础的地图状态更新对象。

newLatLngZoom(LatLng latLng, float zoom):创建一个以指定经纬度为中心点、指定缩放级别的地图状态更新对象。

zoomTo(float zoom):创建一个将地图缩放到指定级别的地图状态更新对象。

zoomBy(float amount):创建一个按照指定比例增加(正值)或减小(负值)地图缩放级别的地图状态更新对象。

rotate(float rotate):创建一个以指定角度顺时针旋转地图的地图状态更新对象。

overlook(float overlook):创建一个以指定角度俯视地图的地图状态更新对象。

scrollBy(int offsetX, int offsetY):创建一个沿屏幕像素坐标偏移地图中心点的地图状态更新对象。

二、例子

安卓:百度地图开发(超详细)_敬往事一杯酒哈的博客-CSDN博客

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容