出行品类HarmonyOS高德地图集成过程分享

系统 OpenHarmony
电子地图采用高德地图,接下来我们看HarmonyOS高德地图集成程序具体实现过程。

​想了解更多关于开源的内容,请访问:​

​51CTO 开源基础软件社区​

​https://ost.51cto.com​

项目背景

电动车因骑行方便、节省时间等优势,成为我们日常出行的交通工具之一,国内电动车的需求数据庞大且逐年攀升。然而电动车频繁被盗也不是新闻了,不仅给用户带来烦恼,也给警务工作增加负担。如何制定一套提升用户体验又能兼顾高安全性的出行品类解决方案,是我们主要思考研究的方向。

为了提升及改善日常出行品类的用户体验,让手机成为电动车钥匙无感解锁,我们想到可利用蓝牙靠近发现的特性,采用无钥匙解锁控车作为主要功能,实现设备快速连接。但是常见的电动车、童车等出行类产品均在户外使用,其安全性要求极高,虽然可利用蓝牙技术进行极简连接控制,但由于蓝牙本身具有开放广播的特性,在设备附近的人都可以通过手机发现设备,则会带来严重的安全隐患。

针对此问题,经过反复推敲,最终决定利用安全秘钥结合云服务,在设备发现、连接操控进行严格的操作认证管控,实现极简连接体验和严格安全控车需求;结合GPS、电子地图,实现设备的出行轨迹展示功能,动态计算设备的停留点、停留时间;采用出行产品电子围栏技术,用户通过手机直接在电子地图上圈定范围区域,如果设备被移到范围外,手机就会收到报警通知,防止车辆丢失。

逻辑实现

手机靠近电动车设备,手机蓝牙打开在未连接的情况下,手机将弹出连接提示,连接后将跳转至App,可绑定设备以及查看相关状态,绑定后通过手机一键控制开关。设定自动锁车的时间,超过设定的时间限制,设备将会自动下电并设防。设置电子围栏,下电设防之后,防盗报警装置启动,超出区域报警提示。

以下为App部分效果图:

#夏日挑战赛#出行品类HarmonyOS高德地图集成过程分享-开源基础软件社区

#夏日挑战赛#出行品类HarmonyOS高德地图集成过程分享-开源基础软件社区

#夏日挑战赛#出行品类HarmonyOS高德地图集成过程分享-开源基础软件社区

电子地图采用高德地图,接下来我们看HarmonyOS高德地图集成程序具体实现过程:

1、为项目增加高德地图依赖包

  • 依赖包放入模块src同级目录libs。
  • 基础依赖:mapslibrary-release.har。
  • 搜索功能:searchlibrary-release.har。
  • 模块build.gradle文件中配置。
implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
...
}

声明权限:模块config.json文件中配置网络权限。

"reqPermissions": [
{
"name": "ohos.permission.INTERNET"
}
]
...

在项目初始化-MyApplication.onInitialize() 方法中加入如下代码启用。

// 搜索
ServiceSettings.getInstance().setApiKey(key);
// 地图
MapsInitializer.setApiKey(key);

key需在高德开放平台-控制台-应用管理-我的应用 中为应用添加key,详见:https://lbs.amap.com/api/harmonyos-sdk/guide/get-key。

2、创建地图

xml中使用标签。

使用时建议将高度和宽度设为match_parent,如需更灵活使用则需要在代码中创建。

ohos:id="$+id:mapview"
ohos:height="match_parent"
ohos:width="match_parent"
/>
MapView mapView = (MapView) findComponentById(ResourceTable.Id_mapview);
mapView.onCreate(null);
mapView.onResume();
AMap aMap = mapView.getMap();//地图操作对象

代码中创建。

final CameraPosition LUJIAZUI = new CameraPosition.Builder()
.target(new LatLng(31.238068, 121.501654)).zoom(18).build();
AMapOptions aOptions = new AMapOptions();
aOptions.rotateGesturesEnabled(false);//设置地图是否可以通过手势进行旋转。
aOptions.zoomGesturesEnabled(true);//设置地图是否可以通过手势进行缩放。
aOptions.scrollGesturesEnabled(true);//设置地图是否可以通过手势滑动
aOptions.tiltGesturesEnabled(false);//设置地图是否可以通过手势倾斜(3D效果),默认为true。
aOptions.compassEnabled(false);//设置指南针是否可用。
aOptions.scaleControlsEnabled(false);//设置地图是否显示比例尺,默认为false。
aOptions.zoomControlsEnabled(true);//设置地图是否允许缩放。
aOptions.camera(LUJIAZUI);//设置地图初始化时的地图窗口状态
aOptions.logoPosition(AMapOptions.LOGO_POSITION_BOTTOM_LEFT);//logo位置
aOptions.mapType(AMap.MAP_TYPE_NORMAL);//MAP_TYPE_NIGHT 黑夜地图,夜间模式,值为3
MapView mapView = new MapView(this, aOptions);
ComponentContainer.LayoutConfig layoutConfig = new ComponentContainer.LayoutConfig(
ComponentContainer.LayoutConfig.MATCH_PARENT,
AttrHelper.vp2px(700, this));
layoutConfig.setMarginTop(AttrHelper.vp2px(56, this));
directionalLayout.addComponent(mapView, layoutConfig);
mapView.onCreate(null);
mapView.onResume();
AMap aMap = mapView.getMap();
//缩放按钮右侧居中
aMap.getUiSettings().setZoomPosition(AMapOptions.ZOOM_POSITION_RIGHT_CENTER);

创建后不用时记得销毁。

建议包含mapView的页面单独用一个PageAbility承载。

@Override
protected void onStop() {
super.onStop();
if (mapView != null) {
mapView.onDestroy();
}
}

3、常用配置

CameraPosition:

aMap.moveCamera(CameraUpdateFactory.newCameraPosition(
new CameraPosition.Builder()
.target(new LatLng(31.238068,121.501654)).zoom(18).build()));//地图移动窗口

常用使用属性:

(LatLng) target:当前区域屏幕中心经纬度坐标。

(float) zoom:目标可视区域的缩放级别(放大级别),3.0f时地图可视区域最大、20.0f时地图可视区域最小。

常用 Listener。

调用 aMap.setXXXListener() 设置。

OnMapLoadedListener 地图加载完成监听接口。

AMapGestureListener 地图手势识别的回调接口(如禁用手势,识别到相关手势也会回调,但OnCameraChangeListener不会触发)。

OnCameraChangeListener 地图Camera状态发生变化的监听接口.当调用AMap.animateCamera(CameraUpdate)、AMap.moveCamera(CameraUpdate)及手势操作地图时会触发该回调(即当前可视窗口变化监听)。

UiSettings:

UiSettings uiSettings = aMap.getUiSettings()。

可设置地图logo、比例尺、缩放按钮、定位按钮、指南针显示,还可设置旋转手势、拖拽手势、倾斜手势、缩放手势、双指缩放手势是否可用(屏蔽地图底层操作)。

Projection:

用于屏幕像素点坐标系统和地球表面经纬度点坐标系统之间的变换。

public LatLng fromScreenLocation(Point var1) //将屏幕坐标转换成地理坐标。
public Point toScreenLocation(LatLng var1) //将地理坐标转换成屏幕坐标
public VisibleRegion getVisibleRegion() //返回当前可视区域(包含MapView四个角点的经纬度坐标)坐标信息。

4、常见问题解答

在开发过程中,我们经常会遇到以下问题:

1.在xml使用标签再从代码中获取MapView对象,地图已默认初始化,默认地图中心为北京市,缩放级别为10.0f,需要调用aMap.moveCamera()方法将窗口移至我们想要的位置,aMap.moveCamera()方法会触发OnCameraChangeListener监听。

2.Projection.toScreenLocation()方法是基于当前窗口中心点及缩放级别计算的屏幕坐标,该坐标可能会超出屏幕显示区域,尤其是地图初始化还未移动窗口时调用。

3.不太建议在监听回调接口中触发其他监听,可能造成逻辑或优先级冲突(如在AMapGestureListener监听回调中调用aMap.moveCamera()方法从而又触发了OnCameraChangeListener监听)。

4.使用地图后退出页面,地图出现在其他页面底层,原因为地图使用后未销毁,建议包含mapView的页面单独用一个PageAbility承载,在Ability.onStop()方法中调用mapView的onDestroy()方法销毁地图。

​想了解更多关于开源的内容,请访问:​

​51CTO 开源基础软件社区​

​https://ost.51cto.com​​。

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2014-12-02 18:23:40

高德地图

2020-03-26 15:57:47

高德地图

2014-12-19 11:17:23

高德地图郭德纲公交导航

2014-11-13 10:46:30

高德地图APEC出行

2014-09-29 18:02:39

高德地图十一出行避堵

2016-06-14 15:46:33

高德

2014-12-19 11:21:04

高德地图

2017-06-23 09:47:42

软件

2016-06-13 15:45:14

高德大数据

2016-04-28 17:03:59

高德地图

2014-10-29 17:53:00

高德地图

2018-05-17 11:31:32

高德黑科技出行

2016-06-14 15:47:25

高德

2016-06-15 15:15:32

高德

2014-06-26 14:41:29

高德开放平台App

2018-08-22 11:44:34

高德地图

2018-09-29 12:06:24

高德十一出行

2017-07-21 10:14:41

高德极客地图高德地图

2018-07-26 15:44:32

高德地图全域
点赞
收藏

51CTO技术栈公众号