AI
产品服务
解决方案
文档与支持
定价
为什么选择百度地图
更新时间: 2026/03/23 14:27
适用环境

移动应用、浏览器端应用均可调起鸿蒙版百度地图。

接口通用说明
实现原理

百度地图App工程中的module.json5配置文件中已经配置skills标签

 "uris": [
  {
    "scheme": "baidumap",
    "host": "map"
  }
]
移动应用调用百度地图

该调用方式是指第三方基于Harmony SDK进行应用开发时要调用Harmony版百度地图客户端需遵守的协议。该协议要正确执行除了要参数填写正确外，还必须要安装Harmony百度地图。
使用openLink实现应用跳转。在openLink接口的link字段中传入目标应用的URL信息，并将options字段中的appLinkingOnly配置为false。
示例代码

import { common, OpenLinkOptions } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';


const TAG: string = '[UIAbilityComponentsOpenLink]';
const DOMAIN_NUMBER: number = 0xFF00;


@Entry
@Component
struct Index {
  build() {
    Button('start link', { type: ButtonType.Capsule, stateEffect: true })
      .width('87%')
      .height('5%')
      .margin({ bottom: '12vp' })
      .onClick(() => {
        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;
        let link: string = "baidumap://map";
        let openLinkOptions: OpenLinkOptions = {
          appLinkingOnly: false
        };


        try {
          context.openLink(link, openLinkOptions)
            .then(() => {
              hilog.info(DOMAIN_NUMBER, TAG, 'open link success.');
            }).catch((err: BusinessError) => {
              hilog.error(DOMAIN_NUMBER, TAG, `open link failed. Code is ${err.code}, message is ${err.message}`);
            });
        } catch (paramError) {
          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start link. Code is ${paramError.code}, message is ${paramError.message}`);
        }
      })
  }
}
浏览器调用百度地图

index.html示例代码

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
</head>
<body>
<h1>Hello World</h1>
<!--方式一、通过绑定事件window.open方法实现跳转-->
<button class="doOpenLink" onclick="doOpenLink()">跳转其他应用一</button>
<!--方式二、通过超链接实现跳转-->
<a href="baidumap://map">跳转其他应用二</a>
</body>
</html>
<script>
    function doOpenLink() {
        window.open("baidumap://map")
    }
</script>
Web组件调用百度地图

Web组件需要跳转DeepLink链接应用时，可通过拦截回调onLoadIntercept中对定义的事件进行处理，实现应用跳转。

import { webview } from '@kit.ArkWeb';
import { BusinessError } from '@kit.BasicServicesKit';
import { common } from '@kit.AbilityKit';


@Entry
@Component
struct WebComponent {
  controller: webview.WebviewController = new webview.WebviewController();


  build() {
    Column() {
      Web({ src: $rawfile('index.html'), controller: this.controller })
        .onLoadIntercept((event) => {
          const url: string = event.data.getRequestUrl();
          if (url === 'baidumap://map') {
            (getContext() as common.UIAbilityContext).openLink(url)
              .then(() => {
                console.log('openLink success');
              }).catch((err: BusinessError) => {
                console.error('openLink failed, err:' + JSON.stringify(err));
              });
            return true;
          }
          // 返回true表示阻止此次加载，否则允许此次加载
          return false;
        })
    }
  }
}
接口说明

百度地图Open API每个接口对应一个专门的Uri串，每个串中相应参数会在下面详细说明。

通用参数

每个协议都可以填写的通用参数，其中coord_type指坐标类型参数，默认为bd09经纬度坐标，如用户使用的坐标类型为gcj02、wgs84，则必须传递此参数值（示例：coord_type=gcj02、coord_type=wgs84）,否则会导致地点坐标位置偏移。

参数名称类型是否必选参数说明

coord_type

string

可选

坐标类型，可选参数，默认为bd09ll百度经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标，wgs84表示gps获取的坐标

needLocation

string

可选

调用时指定该key为yes或no来决定是否强制需要定位

isReducedAccuracyEnough

string

可选

定位调用时指定该key为yes或no来决定，需要定位时低精度是否满足，默认no不满足，这个必须配合needLocation=yes使用

popRoot

string

可选

默认OpenAPI跳转要清空UI栈，指定该key为no可以不清空UI栈

显示主图区（首页）

协议1：baidumap://map/show
协议2：baidumap://map

参数名称类型是否必选参数说明版本

bounds

string

可选

图区范围  优先级最高

1.0.0

zoom

string

可选

图区的level

1.0.0

center

string

可选

图区中心点，lat,lng (先纬度，后经度)=yes使用

1.0.0

userlocation

string

可选

用定位点做图区重点点

1.0.0

例1：baidumap://map/show?zoom=18&center=39.989956,116.323066&coord_type=gcj02&src=push
例2：baidumap://map/show?bounds=4050547,12128734,4051635,12127547&coord_type=bd09mc

标注

调起百度地图时，在主图区的指定坐标点上显示点的名称和内容信息，弹泡泡方式
协议1：baidumap://map/marker

参数名称类型是否必选参数说明版本

title

string

必选

标注点显示标题

1.0.0

content

string

必选

标注点显示内容

1.0.0

location

string

必选

图区中心点，lat,lng (先纬度，后经度)

1.0.0

coord_type

string

可选

坐标类型，可选参数，默认为bd09ll百度经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标，wgs84表示gps获取的坐标

1.0.0

zoom

string

可选

比例尺

1.0.0

src

string

必选

统计参数

1.0.0

例：baidumap://map/marker?title=我的位置&location=40.047669,116.313082&content=百度奎科大厦&src=push

反GEO

协议：baidumap://map/geocoder

参数名称类型是否必选参数说明版本

address

string

必选

地址名称，和location互斥，优先级 address > location

1.0.0

location

string

必选

图区中心点，lat,lng (先纬度，后经度) ，和address互斥，优先级 address > location

1.0.0

name

string

可选

反geo名称

coord_type

string

可选

坐标类型，可选参数，默认为bd09ll百度经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托坐标，gcj02表示经过国测局加密的坐标，wgs84表示gps获取的坐标

1.0.0

zoom

string

可选

比例尺

1.0.0

src

string

必选

统计参数

1.0.0

例1：baidumap://map/marker?name=北京市信息路甲9号&location=40.047669,116.313082&src=push
例2：baidumap://map/geocoder?address=北京市海淀区信息路甲9号&src=push

poi详情

协议：baidumap://map/place/detail

参数名称类型是否必选参数说明版本

uid

string

必选

poi的uid

1.0.0

x

string

可选

坐标

1.0.0

y

string

可选

坐标

1.0.0

show_type

string

可选

展现方式

1.detail_bar是POI图区详情页（底图带底部bar的页面），2.detail_page是poi详情页。默认值是detail_bar，如果不带show_type参数，用默认值。

1.0.0

例：baidumap://map/place/detail?uid=8d96925c6ccf855cc1f1cf38&src=push

poi列表页

协议：baidumap://map/place/search

参数名称类型是否必选参数说明版本

query

string

必选

搜索关键词

1.0.0

例：baidumap://map/place/search?query=KTV&src=push&location=39.989813,116.314094&radius=1000

两框页

协议：baidumap://map/routepage

参数名称类型是否必选参数说明版本

type

string

必选

路线类型，string型 walk步行、ride行、car驾车、neweng新能源、truck货车、motor摩托车、bus公交、train火车、flight飞机、coach大巴、aitravel、rentcar_entrance 打车

1.0.0

param

string

额外参数

1.0.0

例1：baidumap://map/routepage?type=walk&param={"mode":"walking","fr":"test"}
例2：baidumap://map/routepage?popRoot=no&needCloud=yes&type=walk&src=walk.activity.widget

路线页

协议：baidumap://map/direction

参数名称类型是否必选参数说明版本

origin

string

必选

起点名称或经纬度，或者可同时提供名称和经纬度，此时经纬度优先级高，将作为导航依据，名称只负责展示。建筑ID、楼层ID用于室内openAPI，为可选字段

支持参数格式

1、名称：天安门

2、经纬度（先纬度，后经度）：39.98871,116.43234

3、名称和经纬度（中间有一条竖线分割）：name:天安门｜latlng:39.98871,116.43234

注意：仅有名称的情况下，请不要带“name:”，只需要origin=“起点名称”(参数值需要进行encode)

1.0.0

destination

string

必选

同上

1.0.0

originName

string

可选

起点名称(参数值需要进行encode)

1.0.0

originAddr

string

可选

起点地址(参数值需要进行encode)

1.0.0

destName

string

可选

终点名称(参数值需要进行encode)

1.0.0

destAddr

string

可选

终点地址(参数值需要进行encode)

1.0.0

mode

string

可选

出行方式，固定为transit、driving、walking、riding、moto,分别表示公交、驾车、步行、骑行和摩托车，暂不支持train火车、flight飞机、coach大巴

1.0.0

force_mode

string

可选

优先级高于mode,   固定为recommend，driving，transit

1.0.0

例：baidumap://map/direction?popRoot=no&src=duhelper&pageflag=4&origin=%E6%88%91%E7%9A%84%E4%BD%8D%E7%BD%AE&destination=name%3A%E8%B1%86%E5%90%84%E5%BA%84%E6%96%B0%E6%9D%91%7Clatlng%3A40.122275%2C116.312750&mode=transit&destination_uid=d6df91c1b2e8f26af7b91665

导航页

协议：baidumap://map/navi

参数名称类型是否必选参数说明版本

location

string

必选

终点坐标（经纬度），纬度在前，经度在后，使用“,”分割，例如：22.615108,114.035529

1.0.0

uid

string

非必选，但不传不保证进导航的算路一定成功

终点uid

1.0.0

目的地：百度大厦
baidumap://map/navi?location=12947474.59,4846476.50998&uid=435d7aea036e54355abbbcc8&coord_type=bd09mc
目的地：深圳北站
baidumap://map/navi?location=22.615108,114.035529&uid=6f6241e3c05ab1a093114c5e&coord_type=bd09ll

发现周边sug页

协议：baidumap://map/nearby/sug

参数名称类型是否必选参数说明

address

string

可选

地址名称，显示在大框上的

from

string

可选

来源

poiX

number

必选

poi的x坐标

poiY

number

必选

poi的y坐标

poiPoint

string

可选

poi的经纬度

source

string

可选

统计来源

uid

string

可选

poi的经纬度

例：baidumap://map/nearby/sug?poiX=39.989813&poiY=116.314094

公交附近页

协议：baidumap://map/busnearby

参数名称类型是否必选参数说明

busfrom

string

可选

调用方来源，用于打点

注：Harmony目前没使用到此参数

param

string

可选

json格式，传递额外参数

1.和手百联合运营的活动key，设置公交附近页活动开关

2.定位信息，用于覆盖当前定位点，本次打开的页面使用传入的定位点进行展示，需要包含'posX'，'posY'，'cityId'，类型为double，double，string

注：Harmony目前没使用到1相关功能

例：baidumap://map/busnearby?param={"posX":12942656, "posY":4869801, "cityId":131}

步行导航页

协议：baidumap://map/walknavi

参数名称类型是否必选参数说明

origin

string

必选

起点坐标点

经纬度：39.98871,116.43234

destination

string

必选

终点坐标点

经纬度：39.98871,116.43234

mode

string

可选

鸿蒙暂不支持mode参数

例：baidumap://map/walknavi?origin=39.915291,116.403857&destination=40.056858,116.308194

骑行导航页

协议：baidumap://map/bikenavi

参数名称类型是否必选参数说明

origin

string

必选

起点坐标点

经纬度：39.98871,116.43234

destination

string

必选

终点坐标点

经纬度：39.98871,116.43234

viaPoints

string

可选

途经点坐标，数组json字符串，最多支持15个点

例：{

"viaPoints": [{

"name": "北京西站",

"lat": 39.902463,

"lng": 116.327737,

"isUserPokingPoint": true,

"typeInUdc": "commonaddr"

},

{

"name": "清华大学",

"lat": 40.011006,

"lng": 116.338897,

"uid": "d8cf2f3ebd4968cfd618b7a7"

}

]

}

coord_type

string

可选

传入的起点、终点、途经点坐标类型

允许的值为：

bd09ll（百度经纬度坐标）

bd09mc（百度墨卡托坐标）

gcj02（经国测局加密的坐标）

wgs84（gps获取的原始坐标）

例：baidumap://map/bikenavi?origin=39.915291,116.403857&destination=40.056858,116.308194&coord_type=bd09ll

货车导航页

协议：baidumap://map/truck/navigation

参数名称类型是否必选参数说明

scene

number

可选

0代表行中，1代表行前，默认行中

location

string

可选

终点坐标，格式“纬度,经度”，如 40.057023,116.307852；

location 和 query 至少传入一项

type

string

可选

算路偏好，默认使用地图app所选偏好。

BLK:躲避拥堵

TIME:最短时间

ECONOMICS:省钱路线

FEE:不走高速;

HIGHWAY:高速优先;

DEFAULT:智能推荐;

viaPoints

string

可选

途经点参数，内容为json格式，需要 把内容encodeURIComponent后拼 接到url中。

未编码的参数内容示例如下，其中 name为名称，lat为纬度，lng为经度

{"viaPoints":[{"name":"深圳北站"," lat":22.615108,"lng":114.035529}, {"name": "宝安国际机场","lat": 22.638172,"lng":113.821705}]}

coord_type

string

可选

坐标类型。不传默认为bd09ll

示例:

coord_type= bd09ll

允许的值为:

bd09ll(百度经纬度坐标)

bd09mc(百度墨卡托坐标)

gcj02(经国测局加密的坐标)

wgs84(gps获取的原始坐标)

src

string

可选

表示来源，用于统计

格式为:ios.companyName. appName 不传此参数，不保证服务

plate_number

string

必选

车牌号码，如粤B69999

plate_color

number

可选

车牌颜色 1:黄色，2:蓝色(默认)，3:绿色，4: 黑色

truck_type

number

必选

货车类型 1:微型，2:轻型，3:中型，4:重型

height

number

必选

车辆高度 ，double ，单位米，范围 (0,10]

width

number

必选

车辆宽度，double, 单位米，范围 (0,5]

length

number

必选

车辆长度，double，单位米，范围 (0,25]

axle_weight

number

可选

轴重，double, 单位吨，范围(0,100]

axle_count

number

必选

轴数，int，范围[2, 8]

is_trailer

number

可选

是否挂车 1:是，0:否

displacement

number

可选

百公里油耗，单位L ，范围(0, 150]

power_type

number

必选

动力类型 1-汽油; 2-柴油; 3-电动; 4-混合

emission_limit

number

必选

排放标准  取值范围0-6，对应无 (0)、国1-国6(1-6)标准

load_weight

number

必选

核定载重  单位吨，范围(0,100]

trajectory_restore

string

可选

轨迹还原参数，内容为json格式，需要把内容url encode后拼接到url中。

未编码的参数内容示例如下，其中id 为轨迹ID，type为类型，

会透传给服 务端; {"id":"xxxxxxxxxxx","type":1}

query

string

可选

location 和 query 至少传入其中一项，当 location 存在时，query 作为终点名称；否则，query 作为 keyword 用于检索

uid

string

可选

终点 uid

weight

number

必选

货车重量，单位：吨，范围：(0, 100]

例：baidumap://map/truck/navigation?&plate_number=粤B69999&truck_type=1&height=3&width=5&length=13&axle_count=4&power_type=1&emission_limit=4&load_weight=7&weight=78&scene=0&location=40.057023,116.307852&coord_type=1&plate_color=2&is_trailer=1

上一篇

iOS端

下一篇

常见问题

本篇文章对您是否有帮助？