查询机器人地图列表

分页查询指定机器人的地图及地图文件信息。

接口基础信息

接口名称： 查询四足狗地图列表
接口说明： 用于查询四足狗地图列表
请求方式： POST
请求路径： remoteApi/mapList
是否需要登录： 否
是否需要权限： 是

请求参数

参数名	类型	是否必填	示例	说明
dogCode	String	否	123	狗编码
floor	String	否		楼层

请求示例

{
  "floor": "A1",
  "dogCode": "DOG2011258510273380352"
}

实际入参样例（其他http对外接口同理）

在原始业务入参中补充签名参数 timestamp、nonce、sign 和 appKey。secretKey 参与签名生成，实际请求中可不传。

{
  "floor": "A1",
  "dogCode": "DOG2011258510273380352",
  "secretKey": "kQwIOrYvnXmSDkwEiFngrKidMcdrgKor",
  "timestamp": "1770601919986",
  "nonce": "0erlgu8db6vuv6dA1RMT2xrwfKU6bNgu",
  "sign": "078550748A747823209C55BF8C87410F",
  "appKey": "123"
}

返回值

字段 / 类型	说明与示例
`floor` `String`	楼层编码（楼层唯一标识）示例：`a002`
`dogCode` `String`	关联的四足狗编号示例：`2`
`mapFileName` `String`	地图路径示例：`jueying_20250922162308649`
`twoDMapInfo` `String`	2D地图坐标信息示例：`-1217,-2827;820,1002`
`twoDMapBmpPath` `String`	2D 地图路径；示例见下方。

字段示例

twoDMapBmpPath

/mapInfo/showMapPic/jueying_20250922162308649.jpg

返回示例

{
  "success": true,
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "floor": "A1",
      "dogCode": "DOG2011258510273380352",
      "mapFileName": "orgin_20260114100648249.png",
      "twoDMapInfo": "-3008,-467;223,1050",
      "twoDMapBmpPath": "/mapInfo/showMapPic/orgin_20260114100648249.png"
    }
  ]
}

备注：

mapFileName 为文件名/路径，可通过下载资源文件获取真实的地图图片。
twoDMapInfo 中四个值分别为地图最小x绝对值坐标，地图最大x绝对值坐标，地图最小y绝对值坐标，地图最大y绝对值坐标。绝对值坐标代表地图的各个点在真实场地中的具体位置。
路网在地图图片上渲染时，路网/节点/停靠点的绝对值坐标需要转化为相对于地图图片原点的相对值坐标。

坐标转换

以地图图片左上角为原点，将实际绝对值坐标转换为图片中的相对坐标：

归一化x坐标 = ((绝对值x坐标 - 地图最小x绝对值坐标) / (地图最大x绝对值坐标 - 地图最小x绝对值坐标)) * 图片宽度;
归一化y坐标 = ((地图最大y绝对值坐标 - 绝对值y坐标) / (地图最大y绝对值坐标 - 地图最小y绝对值坐标)) * 图片高度;

获取路网返回绝对值坐标。使用上述公式转换坐标，并渲染到通过下载资源文件获取的地图图片上。

{
  "dogCode": "DOG2011258510273380352",
  "edgeCode": "A1_3",
  "edgeStartNode": "A1_2",
  "edgeEndNode": "A1_1",
  "startCoordinate": "-151.144200,15.114400,0.000000",
  "endCoordinate": "156.789000,6.782200,0.000000",
  "controlPoint1": "-48.499800,12.337000,0.000000",
  "controlPoint2": "54.144600,9.559600,0.000000",
  "floor": "A1",
  "moveDisable": true
}

edgeStartNode、edgeEndNode 分别表示路线的开始、结束节点；startCoordinate、endCoordinate 分别为对应节点的绝对值坐标。

将路网渲染在地图图片中效果如下：

// 标准化地图坐标，把路网，节点，停靠点的实际位置坐标转化为相对于地图图片原点的相对坐标，地图原点可以选择为地图最左最上点。代码示例如下：
//x、y为实际坐标
normalizeCoordinate(x, y)
{
    const canvasWidth = = this.stage.width();//地图图片的宽度
    const canvasHeight = this.stage.height();//地图图片的高度
    const normalizedX =
        ((x - this.minPos.x) / (this.maxPos.x - this.minPos.x)) * canvasWidth;//归一化后的x坐标
    const normalizedY =
        ((this.maxPos.y - y) / (this.maxPos.y - this.minPos.y)) * canvasHeight;//归一化后的y坐标
    return [normalizedX, normalizedY];
}//minPos.x为twoDMapInfo的第一项，maxPos.x为第二项，minPos.y为第三项，maxPos.y为第四项

错误码表

错误码	描述
400	参数错误
401	未授权
403	没有访问权限
404	找不到资源
500	服务器内部错误