根据监测点ID查询监测点的解算结果

接口名称

findmm.result.queryByPointId

接口描述

根据监测点ID查询监测点的解算结果。如何及时获取更新解算结果,请查看【开发指南】-【最佳实践】。

接口参数
名称 类型 说明 示例
request JSON 请求参数,必选;JSON中各参数说明如下:
1.pointId,监测点ID,Long,必选
2.beginTime,开始时间,Long,UTC时间戳,单位为微秒,必选
3.endTime,结束时间,Long,UTC时间戳,单位为微秒,必选
4.pageNo,页码,Long,必选
5.pageSize,分页大小,Long,必选
6.coordsys,坐标系统,String,可选,默认值为XYZ,支持如下三种坐标系
(1)“XYZ”,WGS84 空间直角坐标
(2)“BLH”,WGS84 大地坐标
(3)“ENU”,站心坐标系
7.xyz,参考坐标,JSON字符串,coordsys为ENU时必选,JSON的各参数说明如下
(1)x,Double,WGS84 空间直角坐标X,必选
(2)y,Double,WGS84 空间直角坐标X,必选
(3)z,Double,WGS84 空间直角坐标X,必选
备注:这里的xyz的取值,可选取一段时间内的解算结果的均值,作为基准值。
1.当coordsys为XYZ时
request={"pointId":10333,"beginTime":1451187681000,"endTime":1483202481000,"pageNo":1,"pageSize":10}
2.当coordsys为BLH时
request={"pointId":10333,"beginTime":1451187681000,"endTime":1483202481000,
"pageNo":1,"pageSize":10,"coordsys":"BLH"}
3.当coordsys为ENU时
request={"pointId":10333,"beginTime":1451187681000,"endTime":1483202481000,"pageNo":1,"pageSize":10,
"coordsys":"ENU","xyz":"{\"z\":3220358.6083,\"y\":4763412.8169,\"x\":2747782.4749}"}
4.示例代码
public static int queryResultByPointId(Long pointId,Long beginTime,Long endTime,
Long pageNo,Long pageSize,String coordsys,Double x,Double y,Double z){
Map<string, string=""> paramMap = new HashMap<string, string="">();
JSONObject request = new JSONObject();
request.put("pointId", pointId);
request.put("beginTime", beginTime);
request.put("endTime", endTime);
request.put("pageNo", pageNo);
request.put("pageSize", pageSize);
request.put("coordsys", coordsys);
JSONObject xyz = new JSONObject();
xyz.put("x", x);
xyz.put("y", y);
xyz.put("z", z);
request.put("xyz", xyz.toString());
paramMap.put("request", request.toString());
return executeMethod("findmm.result.queryByPointId",paramMap);
}​
返回结果
类型 示例
JSON(正常)

1.coordsys为XYZ时,返回值为

{
  "data":{
    "pageNo":3,
    "pageSize":10,
    "totalItems":21,
    "list":[
      {
        "pointId":13629,
        "recordTime":1541052000000,
        "dq":3.0,
        "z":3295477.0584,
        "y":4646741.518,
        "x":-2878494.462
      }
    ]
  },
  "code":0
}

备注:"dq":3.0代表该解算结果对应站点原始观测数据的数据质量等级被评定为三等。数据质量等级分四等,一、二、三等可满足解算需求,四等数据质量最差。dq数据查询时间限定2018年8月27日之后数据。

2.coordsys为BLH时,返回值为

{"data":{"pageNo":3,"pageSize":10,"totalItems":21,"list":[{"b":31.101242945,"pointId":13629,"l":120.603714665,"recordTime":1541052000000,"h":0.0,"dq":3.0}]},"code":0}

备注:经纬度保留9位小数,大地高保留4位小数。

3.coordsys为ENU时,返回值为

{"data":{"pageNo":3,"pageSize":10,"totalItems":21,"list":[{"e":90.4,"n":-22.8,"pointId":13629,"recordTime":1541052000000,"u":37.5,"dq":3.0}]},"code":0}

备注:enu的单位为毫米,保留1位小数。

JSON(异常) 参照状态码列表