xbr_gaode_navi_amap
介绍,高德系列:
欢迎使用高德集成库,本插件包含 高德地图显示、高德地图查询、高德GPS服务、高德导航。使用前您需了解
1.本插件是因为高德导航官方包无法分包,必须使用合包,所以才将所有模块集成。若没有导航需求,不建议使用 2.您可以单独使用地图插件:xbr_gaode_amap 3.您可以单独使用地图查询插件:xbr_gaode_search 4.您可以单独使用定位插件:xbr_gaode_location
5.下面的截图属于:xbr_gaode_amap,可以下载xbr_gaode_amap的demo查看
主要功能
1.查询插件,查询功能如下
(1)关键子检索+周边检索 POI
(2)POI详情
(3)线路规划
(4)货车线路规划(先去高德客服申请)
(5)查询输入提示 InputTips
(6)地理编码(地址转坐标)
(7)逆地理编码(坐标转地址)
2.高德定位
(1)原生部分完全使用官方提供的SDK:amap_flutter_location;未额外增加任何功能,可以使用官方SDK所有方法
(2)处理了定位返回数据:IOS和Android兼容(官方sdk只返回Map,而且IOS和Android返回的字段不一致)
(3)简化了定位回调,使用:XbrLocation.instance().execOnceLocation(callback:... ) 和 XbrLocation.instance().startTimeLocation(callback:... )
(4)增加后后台保活定位,使用:XbrLocation.instance().startTimeLocation(callback:...,backgroundService:true ),一个程序仅允许一个保活定位进程
3.地图功能做了以下调整
(1)原生部分完全使用官方提供的SDK:amap_flutter_map;未额外增加任何功能,但修复了一些BUG
(2)简化地图绘制流程,增加地图UI绘制器:AMapUIController()
(3)增加了利用多边形绘制圆的方法
(4)修复Marker不能平铺在地图上,使用 FMarker 增加了flat字段,为true时可以平铺在地图上
(5)协调了地图查询功能和地图的整合,可以一键绘制路线
4.高德导航
(1)导航不能自定义,调用了高德的快速导航API:XbrNavi.startNavi(title,subtext,points,strategy = 0, emulator})
(2)ANDROID端可以传递一个title和subtext,显示在地图下方,ios端不支持
(3)emulator:虚拟导航
安装教程
xbr_gaode_navi_amap: ^1.0.0
使用说明
-
定位
(1).定位权限配置,使用第三方 permission_handler 动态权限工具, 使用方法请移步 permission_handler (2).定位调用
//TODO:开始单次定位 定位成功自动销毁 XbrLocation.instance().execOnceLocation(callback: (LocationInfo? location){ //location 对IOS和Android数据 已兼容处理 }); //TODO:开启连续定位 XbrLocation.instance().startTimeLocation( clientKey:"clientKey",//必传,整个APP只有一个定位线程时可以不传 callback:(LocationInfo? location){ //location 对IOS和Android数据 已兼容处理 }, ); @override void dispose() { //销毁 连续定位 XbrLocation.instance().destroyLocation(clientKey); super.dispose(); }
(3).注意:单次定位不用销毁也可以不用传递clientKey,但是如果在多个地方同时使用连续定位,每个地方需传递不同的clientKey, 销毁定位时徐传递需要销毁的定位clientKey。 (4).后台保活定位:注意,一个程序仅允许一个保活定位进程,因为在安卓原生端只生成一个保活服务。一般程序也只需要在采集轨迹时才需要保活服务。
//TODO:开启后台连续定位 XbrLocation.instance().startBackgroundLocation( callback:(LocationInfo? location){ //location 对IOS和Android数据 已兼容处理 }, ); //业务结束时销毁定位 XbrLocation.instance().destroyBackgroundLocation();
-
地图使用:
AMapUIController uiController = AMapUIController();
(1).地图控件
//简单使用,默认了地图部分功能,快速使用 AmapWidget( initCameraPosition: CameraPosition(target: LatLng(26.653841, 106.642904), bearing: 45, zoom: 12, tilt: 15), uiController: uiController, onMapCreated: (AMapController controller) { //地图加载完成 }, onCameraMove: (CameraPosition position) { //地图移动 }, onCameraMoveEnd: (CameraPosition position) { //地图移动结束 } ) //或者使用 需要满足地图所有功能时使用 绘制需要自己控制和刷新 uiController无法使用 AMapWidget( privacyStatement: XbrAmap.instace().statement, apiKey: XbrAmap.instace().apikey, mapType: widget.mapType??MapType.normal, markers: Set<Marker>.of(markers.values), polylines: Set<Polyline>.of(polylines.values), polygons: Set<Polygon>.of(polygons.values), initialCameraPosition: widget.initCameraPosition, gestureScaleByMapCenter: widget.gestureScaleByMapCenter, onCameraMove: widget.onCameraMove, onCameraMoveEnd: widget.onCameraMoveEnd, onMapCreated: widget.onMapCreated, scaleEnabled:false, )
(2).地图绘制
//1.绘制线 uiController.savePolyline("pathlineId", Polyline(..)); //2.绘制marker (flat:可将图片贴在地图上,随3d地图旋转) uiController.saveMarker("markerId", FlatMarker(flat:...)); //3.绘制圆 -利用绘制多边形绘制圆 //获取圆数据:latLng中心点,radius圆的半径(真实半径:单位-米(m),可以制作电子围栏)) var points = AmapUtil.getCirclePoints(center:latLng,radiusMi: radius); uiController.savePolygon("polygonId",Polygon(points:points); ///绘制完要刷新地图 uiController.refreshUI();
(3).uiController.getMarker(id)、uiController.getPolyline(id)、uiController.getPolygon(id)可以获取地图中已经存在的元素,进行动态编辑。同样的还有删除和清空操作。
-
地图查询:
(1).线路规划
AmapSearchUtil.routePlanning( wayPoints: list, //第一个为起点,最后一个为终点,中间为途径点,支持无限个点 callBack: (code, linePoints, bounds) { //code 1000为成功 //linePoints 返回的线点集合,如果需要导航数据,使用方法: //bounds 最大可视面积矩形坐标盒(),移动相机时可以直接使用,如下所示 //绘制规划线 pathlineId 是唯一值 需自定义 //customTexture:线路Texture图片,可以不设置,使用颜色 uiController.savePolyline("pathlineId", Polyline( customTexture: BitmapDescriptor.fromIconPath(lineImgPath), joinType: JoinType.round, capType: CapType.round, points: linePoints, color: Colors.blueAccent, width: 14, )); //利用MAP控制器移动相机到线路最大可视面积,边距50,时间1000毫秒,可自行更改 mapController.moveCamera(CameraUpdate.newLatLngBounds(bounds, 50), duration: 1000); ... ///绘制完要刷新地图 uiController.refreshUI(); } ) //注意上面方法只返回:第一条线路的坐标点串 //若需要返回其他信息,请使用 XbrSearch.routeSearchPage(wayPoints,strategy,showFields); //或 XbrSearch.routeSearch(wayPoints,strategy,showFields,onlyOne); //前者支持无限个点(自动分页),后者最大支持8个点(起终点+6途经点) //strategy:策略,在DrivingStrategy中已定义 //showFields:需要返回的字段,在ShowFields中已定义 //onlyOne:前者已默认true,后者可自定义,只返回一条最优路线。 //货车线路规划 XbrSearch.truckRouteSearchPage(); XbrSearch.truckRouteSearch(); //drivingMode不等于strategy:在DrivingMode中已定义
(2).算路
routeCalculate(wayPoints, strategy, calculateBack}); //只返回:时间和距离,wayPoints支持无限个点
(3).关键字检索
XbrSearch.keywordsSearch(keyWord); //keyWord:关键字
(4)周边检索
XbrSearch.boundSearch(point,score); //point:中心点 //score:搜索半径(米)
(5)搜索提示
XbrSearch.inputTips(newTextnewText); //newTextnewText:需要提示的文本
(6)POI详情
XbrSearch.getPOIById(id);
(7)地理编码和逆地理编码
XbrSearch.geocoding(address); XbrSearch.reGeocoding(point);
4.导航
导航比较简单
XbrNavi.startNavi(points,strategy,emulator);
//points:导航点 第一个为起点,最后一个终点,中间为途经点,长度不能小于2
//strategy:规划策略
//emulator:虚拟导航
//title:标题,仅android有效
//subtext:标题,仅android有效
参与贡献
- 版本内置 高德官方插件 amap_flutter_map,amap_flutter_location,使用前需参考高德API
- example中有动态权限功能,使用:permission_handler
- 本控件由易林物流,XBR-小镖人团队开发并维护。
- XBR开发团队:从事物流软件开发、物流AI技术、智慧物流、网络货运
- 网络货源开发者福利:xbr_network_freight封装了网络货运SDK,并提供了可直接测试的example
Libraries
- _core/driving_mode
- _core/driving_strategy
- _core/location_info
- _core/location_option
- _core/show_fields
- amap/amap_widget
- amap/base/amap_flutter_base
- amap/core/point_util
- amap/core/xbr_ui_controller
- amap/map/amap_flutter_map
- 高德地图Flutter插件入口文件
- amap/map/src/core/amap_flutter_platform
- amap/map/src/core/map_event
- amap/map/src/core/method_channel_amap_flutter_map
- amap/map/src/types/base_overlay
- amap/map/src/types/bitmap
- amap/map/src/types/camera
- amap/map/src/types/marker
- amap/map/src/types/marker_updates
- amap/map/src/types/polygon
- amap/map/src/types/polygon_updates
- amap/map/src/types/polyline
- amap/map/src/types/polyline_updates
- amap/map/src/types/types
- amap/map/src/types/ui
- amap/utils/amap_util
- amap/xbr_amap
- location/gaode_location
- location/xbr_location_service
- search/entity/geocoding_result
- search/entity/input_tip_result
- search/entity/poi_result
- search/entity/re_geocoding_result
- search/entity/route_result
- search/entity/truck
- search/utils/amap_search_util
- search/xbr_search