匹配推测服务接口文档-20190530

目录文档修订记录 21. 匹配推测服务 31.1.匹配接口 3接口概述： 3接口定义： 3接口示例： 31.2.推测接口 4接口概述： 4接口定义： 4接口示例： 51.3.路径投影点接口 6接口概述： 6接口定义： 6接口示例： 61.4.单车路况接口 7接口概述： 7接口定义： 7接口示例： 8附录 9解密方式 9文档修订记录版本编号说明日期变更人20180925匹配推测服务接口信息2018-09-23李杨20190530匹配推测接口:1.1,1.2,增加link形状信息返回2019-05-30谯斌匹配推测服务1.1.匹配接口接口概述：本接口主要提供对多个点进行匹配处理,匹配出最优的5个备选link信息接口定义：基本信息接口名称：多点匹配接口接口地址：0:7086/TrafficStandaloneServer/getHttpMatched请求方法：POST请求数据类型：JSONArray响应类型：JSON状态：有效接口描述：提供对多个点进行匹配处理,匹配出最优的5个备选link信息请求参数参数名称是否必须数据类型默认值描述longitudetrueint经度latitudetrueint维度响应参数参数名称是否必须数据类型描述datatruearray[object]返回的搜索结果集合matchedListtruearray[object]推测结果集合linkIDtruestringlinkIDfootpointStatetrueint是否含有垂足footpointtruestring垂足点dist2Footpointtrueint距离垂足点dist2Spointtrueint垂足点到link起始点距离shapestrueString形状点接口示例：接口地址：0:7086/TrafficStandaloneServer/getHttpMatched请求参数样例：[{"longitude":1234400100,"latitude":418053300},{"longitude":1234397500,"latitude":418053100}]返回结果样例：{"header":"CODE_200","responseBody":"H4sIAAAAAAAAAL1VTW8aMRD9Lz5Ta77tgWtVqVJvHKMcUCEKSgpI7C3Kf49B2WVhrYVEaW7W2H7z3ozf+O4l/Fs0fx9Xyz/rfROmdy/heb15+v0zTIORsTKgikt2DpPwtN4sDxtl+bDdNrvtetPMm0WzClPohcoRJI4iAMhAAKCiE8GYQYmYnFGQDyjLkpR+ne5hOZMR3d635m3co6Ws2Sdh/7jYrfanFNQh8+wYYkdvQxBeJ0NFKkmEfFwQVgX1slXoE8WMCnlA3yImB6QhfbZ3QMRZJUeNvisKpWzfx585ckkNPOTfNVb8Rv54G/8fXykAbng3Z1rGCi/fV3iDaKhJhvQ9t3harfv9QcD/szZ7UjIjRT65DdVJlEuhpOZtiMV3yfhCY7lMnoXyl3i7XELK8klJRU5y5dTmRXBDz3AcFpWmMZYtvXQLRpSErJeC2Dl3wK2glLoBMPborkyrqlvOwesCSM2uuuUMqH1u2IVorBP0cbf061ShzTmWnwBTZcoaM6ZK3bHFA58NWzHySeinhlS/NEP+AjFZIqHrQ6oHNBt+GAeX378BAEpe/8IHAAA="}解密后结果样例：[{"matchedList":[{"linkID":"626353015494893","kind":"6","footpointState":0,"footpoint":"123.44001302000545,41.80522329314136","dist2Footpoint":11.881196,"dist2Spoint":19.678589,"shapes":"123.44025,41.80523;123.43919,41.80520"},{"linkID":"62635305474429","kind":"6","footpointState":1,"footpoint":"123.44025,41.80523","dist2Footpoint":22.815086,"dist2Spoint":16.179012,"shapes":"123.44036,41.80511;123.44025,41.80523"},{"linkID":"626353095142786","kind":"6","footpointState":1,"footpoint":"123.44025,41.80523","dist2Footpoint":22.815086,"dist2Spoint":33.363503,"shapes":"123.44045,41.80549;123.44025,41.80523"},{"linkID":"626353195142786","kind":"6","footpointState":-1,"footpoint":"123.44025,41.80523","dist2Footpoint":22.815086,"dist2Spoint":0,"shapes":"123.44025,41.80523;123.44045,41.80549"},{"linkID":"626353095142784","kind":"6","footpointState":1,"footpoint":"123.44025,41.80523","dist2Footpoint":22.815086,"dist2Spoint":60.61574,"shapes":"123.44098,41.80525;123.44025,41.80523"}]},{"matchedList":[{"linkID":"626353015494893","kind":"6","footpointState":0,"footpoint":"123.43975266251319,41.805215924533094","dist2Footpoint":10.474763,"dist2Spoint":41.298428,"shapes":"123.44025,41.80523;123.43919,41.80520"},{"linkID":"626353040212843","kind":"6","footpointState":0,"footpoint":"123.43975513795375,41.8051096198029","dist2Footpoint":22.310295,"dist2Spoint":31.147135,"shapes":"123.43938,41.80510;123.43977,41.80511"},{"linkID":"626353095142789","kind":"6","footpointState":-1,"footpoint":"123.43977,41.80511","dist2Footpoint":22.325666,"dist2Spoint":0,"shapes":"123.43977,41.80511;123.44017,41.80512"},{"linkID":"626353040212842","kind":"6","footpointState":1,"footpoint":"123.43938,41.8051","dist2Footpoint":38.589176,"dist2Spoint":16.633175,"shapes":"123.43918,41.80509;123.43938,41.80510"},{"linkID":"62635305474425","kind":"6","footpointState":-1,"footpoint":"123.44017,41.80512","dist2Footpoint":40.767242,"dist2Spoint":0,"shapes":"123.44017,41.80512;123.44036,41.80511"}]}]说明:responseBody中的内容为压缩加密内容,具体解压见附录1.2.推测接口接口概述：本接口主要提供对多个车GPS点轨迹进行推测,推测出最优的行驶路径信息接口定义：基本信息接口名称：多点匹配接口接口地址0:7086/TrafficStandaloneServer/getHttpMultiTrajectory请求方法：POST请求数据类型：JSONArray响应类型：JSON状态：有效接口描述：提供对多个车GPS点轨迹进行推测,推测出最优的行驶路径信息请求参数参数名称是否必须数据类型默认值描述deviceIDtrueString车辆IDgpstimetrueintGPS时间longitudetrueint经度latitudetrueint维度speedfalseint速度-辅助推测headingfalseshort方向-辅助推测响应参数参数名称是否必须数据类型描述datatruearray[object]返回的搜索结果集合deviceIDtruestring车辆IDtrajectorytruearray[object]轨迹信息linkIDtrueintLinkIdfeaturestruestring红绿灯等信息kindtrueint道路属性linkLengthtrueintlink长度laneFlagtruebyte车道标识avgSpeedtrueshort速度enterDistancetrueshort进入距离quitDistancetrueshort推出距离shapestrueString形状点信息接口示例：接口地址：0:7086/TrafficStandaloneServer/getHttpMultiTrajectory请求参数样例：[{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770416,"longitude":1234400100,"latitude":418053300,"speed":21,"heading":251},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770419,"longitude":1234397500,"latitude":418053100,"speed":25,"heading":265},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770422,"longitude":1234394400,"latitude":418052800,"speed":31,"heading":264},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770425,"longitude":1234391300,"latitude":418052599,"speed":33,"heading":262},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770428,"longitude":1234388000,"latitude":418052100,"speed":30,"heading":265},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770431,"longitude":1234385000,"latitude":418052000,"speed":30,"heading":266}]返回结果样例：{"header":"CODE_200","responseBody":"H4sIAAAAAAAAAO3UTWvCQBAG4P8ytjkFmdnZj9n0KoVCbz2KSNRVUyW1MQpF/O+NwVBDQQ+WCqXHfWdnmWcXtr+DSdhm4/DUgwSEHdPIEhutVUCcjj1rN5qMjJkqLwgxlEX6GsblW/EBSX8Hyyxf1K1WWTaMZLTX4rnaOQ1puSnCuioido51MSRCliOJmEynKuDh1EWWTyCxcX3ec8hn5RwSkWqd5uFxmc4goRjS7exlFUK1U5kYQl6GopetyzQfB0gwhvdNVn4Fh/b1PF3VE5DirtZY9WnqChrFD3XEnnwTIezjm4kY/0XXivRFkYuUuyDSeJXo0N4WtcY/isTRMSJ/U5H6ayLlf03kHLOR+lc8L7KRsnJe5K4CuW+e0+Ebj1XnPUYLGaI2p12L8L4VqCHdnQbIQ/2NbyKlLvB//kFPtc0FkG4igf1gP/gErNozqv0GAAA="}解密后结果样例：[{"deviceID":"83731b6135442e00fc9347bdb55f2980","trajectory":[{"linkID":"626353015494893","features":"00#626353085188163&8&315#00#00","kind":6,"linkLength":88,"laneFlag":1,"avgSpeed":25,"enterDistance":0,"quitDistance":88,"shapes":"123.44025,41.80523;123.43919,41.80520"},{"linkID":"626353015494893","features":"00#626353085188163&8&315#00#00","kind":6,"linkLength":88,"laneFlag":1,"avgSpeed":30,"enterDistance":0,"quitDistance":88,"shapes":"123.44025,41.80523;123.43919,41.80520"},{"linkID":"626353015494893","features":"00#626353085188163&8&315#00#00","kind":6,"linkLength":88,"laneFlag":1,"avgSpeed":30,"enterDistance":0,"quitDistance":88,"shapes":"123.44025,41.80523;123.43919,41.80520"},{"linkID":"626353015494894","features":"00#626353085188163&7&275#00#00","kind":6,"linkLength":40,"laneFlag":1,"avgSpeed":30,"enterDistance":0,"quitDistance":40,"shapes":"123.43919,41.80520;123.43871,41.80519"},{"linkID":"626353015494894","features":"00#626353085188163&7&275#00#00","kind":6,"linkLength":40,"laneFlag":1,"avgSpeed":32,"enterDistance":0,"quitDistance":40,"shapes":"123.43919,41.80520;123.43871,41.80519"},{"linkID":"626353015494894","features":"00#626353085188163&7&275#00#00","kind":6,"linkLength":40,"laneFlag":1,"avgSpeed":29,"enterDistance":0,"quitDistance":40,"shapes":"123.43919,41.80520;123.43871,41.80519"},{"linkID":"626353077335880","features":"00#626353085188163&6&268#00#00","kind":6,"linkLength":7,"laneFlag":1,"avgSpeed":29,"enterDistance":0,"quitDistance":7,"shapes":"123.43871,41.80519;123.43862,41.80519"},{"linkID":"62635305481511","features":"62635305481511&0%62635305481512_1$62635305481503_4#626353085188163&5&228#00#00","kind":6,"linkLength":40,"laneFlag":1,"avgSpeed":29,"enterDistance":0,"quitDistance":40,"shapes":"123.43862,41.80519;123.43814,41.80518"}]}]说明:responseBody中的内容为压缩加密内容,具体解压见附录1.3.路径投影点接口接口概述：本接口主要提供对多个车GPS点轨迹进行推测,然后返回每个GPS点的垂足点信息接口定义：基本信息接口名称：多点匹配接口接口地址：0:7086/TrafficStandaloneServer/getSubpoints请求方法：POST请求数据类型：JSONArray响应类型：JSON状态：有效接口描述：提供对多个车GPS点轨迹进行推测,然后返回每个GPS点的垂足点信息请求参数参数名称是否必须数据类型默认值描述deviceIDtruestring车辆IDgpstimetrueintGPS时间longitudetrueint经度latitudetrueint维度speedfalseint经度headingfalseshort方向响应参数参数名称是否必须数据类型描述datatruearray[object]返回的搜索结果集合deviceIDtruestring车辆IDsubpointstruearray[object]垂足点集合linkIDtruestringlinkIDgpstimetrueintGPS时间longitudetrueint经度latitudetrueint维度trajectorytruearray[string]轨迹信息接口示例：接口地址：0:7086/TrafficStandaloneServer/getSubpoints请求参数样例：[{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770416,"longitude":1234400100,"latitude":418053300,"speed":21,"heading":251},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770419,"longitude":1234397500,"latitude":418053100,"speed":25,"heading":265}]返回结果样例：{"header":"CODE_200","responseBody":"H4sIAAAAAAAAAI3OzQ6CMBAE4HfZc0O63S39OXvxGQgHCtVUEQhUE0N4d4k3owePk8x8mWqFLj5SG48H8GDJEIYSSTOrKOWpdcQmdEHrk3JWgoDlHqYxDXkBX61wnpacbhE8aoXGSMZSQJ+G65srVUmaJGp2bB3t634c9q6igllK3HOTwTMWVmqlNvELdH+C5Iz+BNFutYA8N5fY5nF+7o+/hHqrXxjgqUwDAQAA"}解密后结果样例[{"deviceID":"83731b6135442e00fc9347bdb55f2980","subpoints":[{"gpstime":1521770416,"linkID":"626353015494893","lon":123.44001,"lat":41.80522},{"gpstime":1521770419,"linkID":"626353015494893","lon":123.43975,"lat":41.805218}],"trajectory":["626353015494893"]}]说明:responseBody中的内容为压缩加密内容,具体解压见附录1.4.单车路况接口接口概述：本接口主要提供对多个车GPS点进行路况计算,然后返回每个车辆的路况信息,即单车融合后的单车路况结果接口定义：基本信息接口名称：多点匹配接口接口地址：0:7086/TrafficStandaloneServer/getHttpMutliTraffic请求方法：POST请求数据类型：JSONArray响应类型：JSON状态：有效接口描述：提供对多个车GPS点轨迹进行推测,然后返回每个GPS点的垂足点信息请求参数参数名称是否必须数据类型默认值描述deviceIDtruestring车辆IDgpstimetrueintGPS时间longitudetrueint经度latitudetrueint维度speedfalseint经度headingfalseshort方向响应参数参数名称是否必须数据类型描述datatruearray[object]返回的搜索结果集合uniqueIDtruestring唯一IDdataTimetrueint处理时间cityCodetruestring城市编码deviceIDtruestring车辆IDcntfstruearray[object]每个LINK的路况uniqueIDtruestring维度linkIDtruestring轨迹信息laneFlagtruebyte车道编码linkLengthtrueintLink长度linkClasstruebyte等级dataTimetrueint进入时间linkTypetruestringlinktypelinkFeaturestruestring特征avgSpeedtruefloat平均速度gpsSpeedtruefloatGps点速度travelTimetrueint旅行时间statustruebyte状态factortruefloat完走率typetrueint类型segmentstruearray[object]分段列表segIndextrueint分段编号segLengthtrueint分段长度segDisSPointtrueint距离link起始点距离segSpeedtruefloat平均速度gpsSpeedtruefloatGPS速度segTravelTimetrueint旅行时间segStatustruebyte状态segFactortruefloat完走率segInTimetrueint进入时间segOutTimetrueint退出时间segWaitTimetrueint等待时间接口示例：接口地址：0:7086/TrafficStandaloneServer/getHttpMutliTraffic请求参数样例：[{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770416,"longitude":1234400100,"latitude":418053300,"speed":21,"heading":251},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770419,"longitude":1234397500,"latitude":418053100,"speed":25,"heading":265}]返回结果样例：{"header":"CODE_200","responseBody":"H4sIAAAAAAAAAJWQT2vDMAzFv4sLPYUiWf6ba0dhsNt6KyO4iZKFpWnXuIUy9t3nJN1g7DR0kvX8fk/afYhL375f+PFB5EICOvBSowIEU6C0K0iFBaH1riDvTWEcktEiE1WIYdseWOSoyTqtpTGZKNt4Wx8rHt0wucCo5GtbzgRHlnBvkLRSkgHq0pOy+2qvdS29G9VlH+tB5LufZNV/kpnk0LX920Qz0pAmQK28cp7GUeh504UmhZ51T9w38VXkzs39ugtDopvf+0m0FhSaWbO9ncb94I7acIiXMw9/gGqJi/uL0+gcGlraJaFeACymy4Rr83xiThtKnYnmNHx3lIl4Dlfu7glkQg8xcYYpeR3KeDyLHFbjvzjlgaTg5sB9HK/38pnqCyObAureAQAA"}解密后结果样例[{"uniqueID":"20180925140106__31798_3996_681365","dataTime":1537855266,"cityCode":"210100","deviceID":"83731b6135442e00fc9347bdb55f2980","cntfs":[{"uniqueId":"20180925140106__31798_3996_681366","linkID":"626353015494893","laneFlag":1,"linkLength":88,"linkClass":6,"dataTime":1521770416,"linkType":"0","linkFeatures":"626353015494894&1#626353085188163&7&315#00#00","avgSpeed":25,"gpsSpeed":23,"travelTime":126,"status":1,"factor":0.25,"type":0,"segments":[]}]}]说明:responseBody中的内容为压缩加密内容,具体解压见附录1.5.推测接口openLR编码接口概述：本接口主要提供对多个车GPS点轨迹进行推测,推测出最优的行驶路径信息，并进行openLR编码接口定义：基本信息接口名称：多点匹配接口接口地址0:7086/TrafficStandaloneServer/getHttpMultiTrajectoryOpenLR请求方法：POST请求数据类型：JSONArray响应类型：JSON状态：有效接口描述：提供对多个车GPS点轨迹进行推测,推测出最优的行驶路径信息请求参数参数名称是否必须数据类型默认值描述deviceIDtrueString车辆IDgpstimetrueintGPS时间longitudetrueint经度latitudetrueint维度speedfalseint速度-辅助推测headingfalseshort方向-辅助推测响应参数参数名称是否必须数据类型描述datatruearray[object]返回的搜索结果集合deviceIDtruestring车辆IDtrajectorytruearray[object]轨迹信息linksOpenLRtrueint轨迹信息编码完的结果接口示例：接口地址：0:7086/TrafficStandaloneServer/getHttpMultiTrajectoryOpenLR请求参数样例：[{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770416,"longitude":1234400100,"latitude":418053300,"speed":21,"heading":251},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770419,"longitude":1234397500,"latitude":418053100,"speed":25,"heading":265},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770422,"longitude":1234394400,"latitude":418052800,"speed":31,"heading":264},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770425,"longitude":1234391300,"latitude":418052599,"speed":33,"heading":262},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770428,"longitude":1234388000,"latitude":418052100,"speed":30,"heading":265},{"deviceID":"83731b6135442e00fc9347bdb55f2980","gpstime":1521770431,"longitude":1234385000,"latitude":418052000,"speed":30,"heading":266}]返回结果样例：{"header":"CODE_200","responseBody":"H4sIAAAAAAAAAJVTTW/bMAz9K4UvuSSZvhw7g6oeNqAYMGDd0Ns2FLJNZRpcyZCUbMWw/z7KSbDAhQv0RPKReiQfxK9/ig4OtoUP74u3Rc0rTpsN5aUQDAgx7ZaLqumasjRsW5NiWaSgf0KbfHjCennz+7G/OkCI1rvrBV2TxRW41nfW7a4X+2RW9eJGyQBx8C6Cko96OFUrWj98Fg+38tubC1CmpwFUbx0gPvoyeN3Fo1HSdqrCDJpMuu/Tfa5JNmpELxCZKXT46FudkPcLGAg4GCaMDTE9w++8dUlJ3UTf7xPcgn/nfcA1dMpk3u1s2negyqpkFefY7D8me+QaPboVNduUOXuG0J8jxQnvgh8gJAu4oAmtysTZSuN/KZYDtLLBTVBQpCcInaPcZUIx6PTjMu5NcO0wsp5c2blB0SqPmD000zfY8yWFej2fC5DXPsyrt2KUzEi3EhPV5sherdqGvSxabju/0+CjzWN8MiZCUnn8CSQd7PSkZAIhy0iW356c2f8Z8Li02/X4mxhfC15TQZaCrmtS0posR1AQVp5Bxsmo1vlVDsZTOdp41PJ0f8Xf7/8Am8zAWPEDAAA="}解密后结果样例：[{"deviceID":"83731b6135442e00fc9347bdb55f2980","trajectory":"<?xmlversion='1.0'encoding='utf8'?><response><mapversion>18_Q4_G<\/mapversion><type>line<\/type><roads><road><id>7<\/id><resultType>tisa<\/resultType><linearLoc