智能客服
你问我答，随时在线为你解决问题
- 路线导入对应的Scope权限为：https://www.huawei.com/healthkit/location.write
- 通过DeepLink方式完成路线自动导入至运动健康App，暂仅支持Android生态应用。
- 运动健康App版本不低于13.0.1.310。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
路线导入
本文导读
本章节提供通过华为Health Service Kit服务端REST API写入用户路线方法示例。用户的路线是以GPX文件格式导入，可以导入轨迹（Track）或路程（Route）类型的数据。整个流程分为两步：
- 通过REST API导入路线数据；
- 判断运动健康App版本，以及通过DeepLink方式将路线自动导入至运动健康App。
三方生态应用路线导入路线后，Health Service Kit服务端会生成并返回路线的唯一ID，生态应用可基于路线ID通过DeepLink方式跳转运动健康App我的路线详情页面，自动导入路线至运动健康App中。
说明
路线写入
Route路线写入并获取RouteId
HTTP请求，请参见路线导入接口。
- PUT
- https://health-api.cloud.huawei.com/healthkit/v2/routeInfos?format=GPX
请求示例
- PUT
- https://health-api.cloud.huawei.com/healthkit/v2/routeInfos?format=GPX
请求体
- Content-Type: application/xml
- Authorization: Bearer ***
- x-client-id: ***
- x-version: ***
- x-caller-trace-id: ***
- <?xml version='1.0' encoding='UTF-8' standalone='yes' ?>
- <gpx version="1.1" creator="***" xmlns:xsi="***" xmlns="***" xsi:schemaLocation="***">
- <metadata>
- <time>1970-01-01T00:00:00Z</time>
- </metadata>
- <extensions>
- <totalTime>10000</totalTime>
- <totalDistance>10000</totalDistance>
- <routeName>testRouteName</routeName>
- </extensions>
- <rte>
- <rtept lat="24.27207756704355" lon="98.6666815648492">
- <ele>2186.0</ele>
- </rtept>
- <rtept lat="24.27218810046418" lon="98.66668171910422">
- <ele>2188.0</ele>
- </rtept>
- <rtept lat="24.27229019048912" lon="98.6667668786458">
- <ele>2188.0</ele>
- </rtept>
- <rtept lat="24.27242784195029" lon="98.6668908573738">
- <ele>2188.0</ele>
- </rtept>
- </rte>
- <wpt lat="22.66125"lon="114.063013">
- <desc>12</desc>
- <name>12</name>
- <sym>1</sym>
- <extensions>
- <mode>1</mode>
- <color>1</color>
- </extensions>
- </wpt>
- <wpt lat="22.661431"lon="114.064915">
- <desc>13</desc>
- <name>13</name>
- <sym>2</sym>
- <extensions>
- <mode>1</mode>
- <color>3</color>
- </extensions>
- </wpt>
- </gpx>
说明
- wpt是CP点信息，包括GPS需要记录的CP点名称，标记颜色等信息。在特定场景才需要导入轨迹标记点，不是必需字段。
- <totalTime>字段为实际运动的总时间、不包括休息时间，暂停时间等其他时间。
响应体
- HTTP/1.1 200 OK
- Content-type: application/json;charset=utf-8
- {
- "routeId": 167001079583340846
- }
Track路线导入
HTTP请求，请参见路线导入接口。
- PUT
- https://health-api.cloud.huawei.com/healthkit/v2/routeInfos?format=GPX
请求示例
- PUT
- https://health-api.cloud.huawei.com/healthkit/v2/routeInfos?format=GPX
请求体
- Content-Type: application/xml
- Authorization: Bearer ***
- x-client-id: ***
- x-version: ***
- x-caller-trace-id: ***
- <?xml version="1.0" encoding="UTF-8"?>
- <gpx creator="***" version="1.1" xsi:schemaLocation="***" xmlns:ns3="***" xmlns="***" xmlns:xsi="***" xmlns:ns2="***">
- <metadata>
- <time>2021-06-30T10:34:55.000Z</time>
- </metadata>
- <extensions>
- <totalTime>10000</totalTime>
- <totalDistance>10000</totalDistance>
- <routeName>testRouteName2</routeName>
- </extensions>
- <trk>
- <name>跑步</name>
- <type>running</type>
- <trkseg>
- <trkpt lat="22.6551113091409206390380859375" lon="114.05494303442537784576416015625">
- <ele>-33.200000762939453125</ele>
- <time>2021-06-30T10:35:09.000Z</time>
- <extensions>
- <ns3:TrackPointExtension>
- <ns3:atemp>31.0</ns3:atemp>
- <ns3:hr>110</ns3:hr>
- <ns3:cad>79</ns3:cad>
- </ns3:TrackPointExtension>
- </extensions>
- </trkpt>
- <trkpt lat="22.655114494264125823974609375" lon="114.05494051985442638397216796875">
- <ele>-33.40000152587890625</ele>
- <time>2021-06-30T10:35:10.000Z</time>
- <extensions>
- <ns3:TrackPointExtension>
- <ns3:atemp>31.0</ns3:atemp>
- <ns3:hr>111</ns3:hr>
- <ns3:cad>79</ns3:cad>
- </ns3:TrackPointExtension>
- </extensions>
- </trkpt>
- <trkpt lat="22.65512078069150447845458984375" lon="114.05494404025375843048095703125">
- <ele>-33.59999847412109375</ele>
- <time>2021-06-30T10:35:11.000Z</time>
- <extensions>
- <ns3:TrackPointExtension>
- <ns3:atemp>31.0</ns3:atemp>
- <ns3:hr>112</ns3:hr>
- <ns3:cad>79</ns3:cad>
- </ns3:TrackPointExtension>
- </extensions>
- </trkpt>
- <trkpt lat="22.654982395470142364501953125" lon="114.05491151846945285797119140625">
- <ele>-33.59999847412109375</ele>
- <time>2021-06-30T10:35:13.000Z</time>
- <extensions>
- <ns3:TrackPointExtension>
- <ns3:atemp>31.0</ns3:atemp>
- <ns3:hr>114</ns3:hr>
- <ns3:cad>77</ns3:cad>
- </ns3:TrackPointExtension>
- </extensions>
- </trkpt>
- </trkseg>
- </trk>
- <wpt lat="22.66125"lon="114.063013">
- <desc>12</desc>
- <name>12</name>
- <sym>1</sym>
- <extensions>
- <mode>1</mode>
- <color>1</color>
- </extensions>
- </wpt>
- <wpt lat="22.661431"lon="114.064915">
- <desc>13</desc>
- <name>13</name>
- <sym>2</sym>
- <extensions>
- <mode>1</mode>
- <color>3</color>
- </extensions>
- </wpt>
- </gpx>
说明
wpt是CP点信息，包括GPS需要记录的CP点名称，标记颜色等信息。在特定场景才需要导入轨迹标记点，不是必需字段。
响应体
- HTTP/1.1 200 OK
- Content-type: application/json;charset=utf-8
- {
- "routeId": 167001079583340846
- }
DeepLink跳转运动健康App完成路线自动导入
Android
获取华为运动健康App版本号
- long versionCode;
- try {
- PackageInfo packageInfo =
- this.getPackageManager().getPackageInfo("com.huawei.health", PackageManager.GET_META_DATA);
- if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
- versionCode= packageInfo.getLongVersionCode();
- } else {
- versionCode= packageInfo.versionCode;
- }
- } catch (PackageManager.NameNotFoundException e) {
- versionCode = 0L;
- }
DeepLink跳转
当获取华为运动健康App版本号返回的versionCode不低于1300001310 时，可使用DeepLink跳转功能。
| 跳转类型 | 跳转地目的地 | 目标类型 | 跳转地址 | 跳转参数 | 是否必填 | 参数类型 | 跳转参数说明 |
|---|---|---|---|---|---|---|---|
| DeepLink | 运动健康App-我的路线详情页面 | Activity | huaweischeme://healthapp/router/routeDetail | fromFlag | 是 | String | 填写固定值："cloud_flag" |
| routeId | 是 | long | 路线写入成功后返回的路线ID |
示例代码：
- String deeplink = "huaweischeme://healthapp/router/routeDetail?fromFlag=cloud_flag&routeId=" + routeId;
- Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(deeplink));
- intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
- startActivity(intent);
IOS
iOS版本15.0.12.305及以上。
DeepLink跳转
| 跳转类型 | 跳转地目的地 | 目标类型 | 跳转地址 | 跳转参数 | 是否必填 | 参数类型 | 跳转参数说明 |
|---|---|---|---|---|---|---|---|
| DeepLink | 运动健康App-我的路线详情页面 | Activity | huaweischeme://healthapp/router/routeDetail?fromFlag=cloud_flag&routeId=" + routeId | routeId | 是 | long | 路线写入成功后返回的路线ID |
示例代码：
- let routeId: String = "1234"
- let deeplink: String = "huaweischeme://healthapp/router/routeDetail?fromFlag=cloud_flag&routeId=\(routeId)"
- guard let openUrl = URL(string: deeplink) else {
- return false
- }
- if UIApplication.shared.canOpenURL(openUrl) {
- UIApplication.shared.open(openUrl, options: [:], completionHandler: nil)
- }
在 指南 中进行搜索
请输入您想要搜索的关键词