轨迹查询与纠偏

GET

/api/v3/track/gettrack

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://yingyan.baidu.com/api/v3/track/gettrack?service_id&entity_name&ak=&sn='

响应示例

{
 "status": 0,
 "message": "成功",
 "total": 10156,
 "size": 100, 
 "distance": 70101.769271664,
 "toll_distance": 0, 
 "start_point": 
  { 
   "longitude": 121.47756835641, 
   "latitude": 31.228864478309, 
   "loc_time": 1487210008 
  }, 
 "end_point": 
  { 
   "longitude": 121.66034736775, 
   "latitude": 31.145494901873, 
   "loc_time": 1487260798
  }, 
 "points": 
 [
  {
  "loc_time": 1487210008,
  "latitude": 31.228864478309, 
  "longitude": 121.47756835641, 
  "create_time": "2017-02-16 09:53:56",
  "direction": 160,
  "height": 5,
  "key1": "value1",
  "radius": 10,
  "speed": 6.8, 
  "locate_mode": "GPS/北斗定位", 
  "transport_mode": "驾车"
    },
    {
      "loc_time": 1487210013,
      "latitude": 31.228900948179,
      "longitude": 121.47727614458,
      "create_time": "2017-02-16 09:53:56",
      "direction": 0,
      "height": 36,
      "key1": "value1",
      "radius": 10,
      "speed": 0,
      "locate_mode": "GPS/北斗定位", 
      "transport_mode": "停留"
    },
    ...
    {
      "loc_time": 1487210503,
      "latitude": 31.232230380323,
      "longitude": 121.47848441484,
      "create_time": "2017-02-16 10:02:09",
      "direction": 228,
      "height": 6,
      "key1": "value1",
      "radius": 5,
      "speed": 1.87,
      "locate_mode": "GPS/北斗定位", 
      "transport_mode": "停留"
    }
  }
]

请求参数

Query 参数

service_id

integer

必需

service的ID，service 的唯一标识；在轨迹管理台创建鹰眼服务时，系统返回的 service_id

entity_name

string

必需

entity唯一标识

start_time

integer

开始时间

可选

end_time

integer

可选

结束时间；结束时间不能大于当前时间，且起止时间区间不超过24小时。为提升响应速度，同时避免轨迹点过多造成请求超时（3s）失败，建议缩短每次请求的时间区间，将一天轨迹拆分成多段进行拼接

is_processed

string

可选

是否返回纠偏后里程；默认值：0 取值规则： 0：关闭轨迹纠偏，返回原始轨迹 1：打开轨迹纠偏，返回纠偏后轨迹。

process_option

string

可选

纠偏选项；默认值为： denoise_grade=1,need_mapmatch=0,transport_mode=auto 取值规则为： 1.去噪 denoise_grade（去噪力度）取值范围[0,5]，数值越大去噪力度越大，代表越多的点会被当做噪点去除。若取值0，则代表不去噪。示例： denoise_grade=0 （不去噪） denoise_grade=1 （系统默认去噪） denoise_grade=2（系统默认去噪，同时去除定位精度低于500的轨迹点，相当于保留GPS定位点、大部分Wi-Fi定位点和精度较高的基站定位点） denoise_grade=3（系统默认去噪，同时去除定位精度低于100的轨迹点，相当于保留GPS定位点和大部分Wi-Fi定位点） denoise_grade=4（系统默认去噪，同时去除定位精度低于50的轨迹点，相当于保留GPS定位点和精度较高的Wi-Fi定位点） denoise_grade=5（系统默认去噪，同时去除定位精度低于20的轨迹点，相当于仅保留GPS定位点） 2.绑路，示例： need_mapmatch=0 不绑路 need_mapmatch=1 绑路 3.交通方式，鹰眼将根据不同交通工具选择不同的纠偏策略，目前支持：自动（即鹰眼自动识别的交通方式）、驾车、骑行和步行，示例： transport_mode=auto（根据轨迹鹰眼自动识别交通方式） transport_mode=driving（驾车） transport_mode=riding（骑行） transport_mode=walking（步行）

supplement_mode

string

可选

轨迹补偿交通方式选择；默认值：no_supplement 在轨迹纠偏时，两个轨迹点定位时间间隔5分钟以上，被认为是中断。中断轨迹和里程提供以下5种估算方式。 no_supplement：不补充，中断两点间距离不记入里程。 straight：使用直线补充 driving：使用最短驾车路线规划补充 riding：使用最短骑行路线规划补充 walking：使用最短步行路线规划补充

supplement_content

string

可选

轨迹补偿内容；仅在supplement_mode不为no_supplement时生效。默认值：only_distance。可选值： only_distance：对于中断区间，只补偿中断的里程，不补偿轨迹点 distance_and_points：对于中断区间，既补偿里程，又补偿轨迹点

low_speed_threshold

number

可选

低速阈值；单位：千米/小时若填写该值且is_processed=1时，则返回结果中将增加low_speed_distance字段，表示速度低于该值的里程。示例： low_speed_threshold=20，则返回结果中将增加low_speed_distance字段表示此段轨迹中速度低于20千米/小时的里程，可用于网约车行业中计算低速里程。

coord_type_output

string

可选

返回的坐标类型；默认值：bd09ll 该字段用于控制返回结果中的坐标类型。可选值为： gcj02：国测局加密坐标 bd09ll：百度经纬度坐标该参数仅对国内（包含港、澳、台）轨迹有效，海外区域轨迹均返回 wgs84坐标系

sort_type

string

可选

返回轨迹点的排序规则；默认值：asc 取值规则： asc：按定位时间升序排序（旧->新）按定位时间降序排序（新->旧）

page_index

integer

可选

分页索引；默认值：1 与page_size一起计算从第几条结果返回，代表返回第几页。

page_size

string

可选

分页大小；默认值：100 返回结果最大个数与page_index一起计算从第几条结果返回，代表返回结果中每页有几个轨迹点。

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

状态码

必需

message

string

必需

响应信息；对status的中文描述

total

integer

必需

忽略掉page_index，page_size后的轨迹点数量；代表一共有多少条符合条件的轨迹点

size

integer

必需

返回的结果条数；代表本页返回了多少条符合条件的轨迹点数量

distance

number

必需

此段轨迹的里程数；单位：米
符合条件的所有轨迹点的总里程
注意：是total个轨迹点的里程，和分页及本页显示的size无关

toll_distance

number

必需

此段轨迹的收费里程数；单位：米收费道路包括高速等收费路段

low_speed_distance

number

必需

低速里程；单位：米
若请求参数中填写了low_speed_threshold，则返回该字段，否则不返回
代表速度低于low_speed_threshold的轨迹里程

start_point

object

必需

低速里程 double 单位：米若请求参数中填写了low_speed_threshold，则返回该字段，否则不返回代表速度低于low_speed_threshold的轨迹里程

longitude

number

经度

必需

latitude

number

纬度

必需

loc_time

integer

必需

定位时间；轨迹点定位时间

coord_type

string

必需

坐标类型;该字段仅在海外区域时返回，返回值为：wgs84。当坐标位于国内（含港、澳、台）时，返回坐标类型与请求参数 coord_type_output 所设一致，因此不再返回该字段

end_point

object

终点信息

必需

longitude

number

经度

必需

latitude

number

维度

必需

loc_time

integer

必需

定位时设备的时间;轨迹点定位时间

coord_type

string

必需

坐标类型 ;该字段仅在海外区域时返回，返回值为：wgs84。当坐标位于国内（含港、澳、台）时，返回坐标类型与请求参数 coord_type_output 所设一致，因此不再返回该字段

points

array [object {14}]

历史轨迹点列表

必需

loc_time

integer

可选

定位时的设备时间; 若是原始轨迹点位置纠正后的点，则loc_time为原始轨迹点的定位时间
若是鹰眼通过绑路补充的道路形状点（标识为_supplement=1），则loc_time使用了前序原始轨迹点的定位时间

latitude

number

维度

可选

longitude

number

经度

可选

create_time

integer

可选

创建时间；该时间为服务端时间

direction

integer

可选

方向；范围为[0,359]，0度为正北方向，顺时针

height

integer

可选

高度；只在GPS定位结果时才返回，单位米

floor

string

可选

楼层；仅在百度地图高精室内定位合作区域返回

radius

integer

定位精度；单位：米

可选

speed

number

可选

速度；单位：千米/小时

locate_mode

string

可选

轨迹对应的定位方式（鹰眼分析得出）；仅当请求参数is_processed=1时返回。
可能的返回值：未知；GPS/北斗定位；网络定位；基站定位

transport_mode

string

可选

轨迹对应的交通方式（鹰眼分析得出）；仅当请求参数is_processed=1且process_option中transport_mode=auto时返回。
可能的返回值：未知；驾车；骑行；步行；停留
注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通

coord_type

string

必需

坐标类型；该字段仅在海外区域时返回，返回值为：wgs84。当坐标位于国内（含港、澳、台）时，返回坐标类型与请求参数 coord_type_output 所设一致，因此不再返回该字段

_supplement

string

必需

是否为补充的点；若为原始轨迹点位置纠正后的点，则不返回该字段；
若该点为鹰眼纠偏绑路时自动补充的道路形状点，则_supplement=1；
若该点为通过supplement_mode和supplement_content在长距离中断区间使用路线规划补偿的轨迹点，则_supplement=2；

column-key

string

必需

自定义字段；当用户创建了track的自定义属性，且在创该属性赋有值，才会返回此字段

查询轨迹里程

轨迹分析