合作咨询
我们的专家服务团队将竭诚为您提供专业的合作咨询服务
为保证性能与准确性，单次请求中的起点数量乘以终点数量应小于100。
批量算路
本文导读
场景介绍
多个起点到多个终点的批量算路功能，在驾车、步行、骑行模式下，快速批量计算多个起点分别到多个终点的路线距离和耗时。
接口说明
以下是路径规划功能相关接口，主要由navi命名空间下的方法提供，更多接口及使用方法请参见接口文档。
| 接口名 | 描述 |
|---|---|
| getDrivingMatrix(params: DrivingMatrixParams): Promise<MatrixResult> | 驾车批量算路。 |
| getDrivingMatrix(context: common.Context, params: DrivingMatrixParams): Promise<MatrixResult> | 驾车批量算路。支持传入Context上下文。 |
| getWalkingMatrix(params: MatrixParams): Promise<MatrixResult> | 步行批量算路。 |
| getWalkingMatrix(context: common.Context, params: MatrixParams): Promise<MatrixResult> | 步行批量算路。支持传入Context上下文。 |
| getCyclingMatrix(params: MatrixParams): Promise<MatrixResult> | 骑行批量算路。 |
| getCyclingMatrix(context: common.Context, params: MatrixParams): Promise<MatrixResult> | 骑行批量算路。支持传入Context上下文。 |
| DrivingMatrixParams | 驾车批量算路的参数。 |
| MatrixParams | 步行、骑行批量算路的参数。 |
| MatrixResult | 批量算路的结果。 |
开发步骤
导入相关模块。
- import { navi } from '@kit.MapKit';
- import { BusinessError } from '@kit.BasicServicesKit';
驾车批量算路
根据多组起终点坐标批量检索符合条件的驾车路径规划方案。支持以下功能：
-
支持未来出行规划。
-
支持根据实时路况进行合理路线规划。
-
支持多种路线偏好选择，如时间最短、避免经过收费的公路、避开高速公路、距离优先等。
说明
- async testDrivingMatrix() {
- let params: navi.DrivingMatrixParams = {
- // 起点的经纬度
- origins: [{
- latitude: 31.9844,
- longitude: 118.766253
- }, {
- latitude: 31.9644,
- longitude: 118.746253
- }],
- // 终点的经纬度
- destinations: [{
- latitude: 31.9344,
- longitude: 118.706253
- }],
- // 时间预估模型
- trafficMode: 2,
- language: 'zh_CN'
- };
- try {
- const result = await navi.getDrivingMatrix(params);
- console.info(`Succeeded in getting driving matrix. result is ${JSON.stringify(result)}`);
- } catch (error) {
- const err: BusinessError = error as BusinessError;
- console.error(`Failed in getting driving matrix. Code is ${err.code}, message is ${err.message}`);
- }
- }
步行批量算路
根据多组起终点坐标批量检索符合条件的步行路径规划方案。支持以下功能：
-
支持150km以内的步行路径规划能力。
-
融入出行策略（时间最短、避免轮渡）。
说明
为保证性能与准确性，单次请求中的起点数量乘以终点数量应小于100。
- async testWalkingMatrix() {
- let params: navi.MatrixParams = {
- // 起点的经纬度
- origins: [
- {
- latitude: 31.9844,
- longitude: 118.766253
- }, {
- latitude: 31.9644,
- longitude: 118.746253
- }],
- // 终点的经纬度
- destinations: [{
- latitude: 31.9344,
- longitude: 118.706253
- }],
- language: 'zh_CN'
- };
- try {
- const result = await navi.getWalkingMatrix(params);
- console.info(`Succeeded in getting walking matrix. result is ${JSON.stringify(result)}`);
- } catch (error) {
- const err: BusinessError = error as BusinessError;
- console.error(`Failed in getting walking matrix. Code is ${err.code}, message is ${err.message}`);
- }
- }
骑行批量算路
根据多组起终点坐标批量检索符合条件的骑行路径规划方案。支持以下功能：
-
支持500km以内的骑行路径规划能力。
-
融入出行策略（时间最短、避免轮渡）。
说明
为保证性能与准确性，单次请求中的起点数量乘以终点数量应小于100。
- async testCyclingMatrix() {
- let params: navi.MatrixParams = {
- // 起点的经纬度
- origins: [{
- latitude: 31.9844,
- longitude: 118.766253
- }, {
- latitude: 31.9644,
- longitude: 118.746253
- }],
- // 终点的经纬度
- destinations: [{
- latitude: 31.9344,
- longitude: 118.706253
- }],
- language: 'zh_CN'
- };
- try {
- const result = await navi.getCyclingMatrix(params);
- console.info(`Succeeded in getting cycling matrix. result is ${JSON.stringify(result)}`);
- } catch (error) {
- const err: BusinessError = error as BusinessError;
- console.error(`Failed in getting cycling matrix. Code is ${err.code}, message is ${err.message}`);
- }
- }