8

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

 2 years ago
source link: https://os.51cto.com/article/711786.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

出行品类HarmonyOS高德地图集成过程分享-51CTO.COM

5916fb164111dc1cf87edbfbe1efaf36.png
出行品类HarmonyOS高德地图集成过程分享
作者：软通动力HOS 2022-06-16 14:36:18
电子地图采用高德地图，接下来我们看HarmonyOS高德地图集成程序具体实现过程。
09e1ca046f8c9cfe01f5742987f1081208d0ae.png

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

​​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​​。


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK