POST api/Obd/SingleTravel
单个行程详情 [车机]
Request Information
Body Parameters
SingTravelModel| Name | Description | Type | Additional information |
|---|---|---|---|
| TravelId |
行程ID |
integer |
None. |
| Start |
一天的开始时间 UTC |
date |
None. |
| End |
一天的结束时间 UTC |
date |
None. |
| DeviceId |
设备Id |
integer |
None. |
| MapType |
地图类型 |
string |
None. |
| MaxCount |
最多条数 |
integer |
None. |
| UserId | integer |
None. |
|
| Token |
登录后获取到的 Token |
string |
None. |
| Language |
语言选项 |
string |
None. |
| AppId |
APP应用标识 |
string |
None. |
Request Formats
application/json, text/json
Sample:
{
"TravelId": 1,
"Start": "2025-12-12T05:28:46.2336427+08:00",
"End": "2025-12-12T05:28:46.2336427+08:00",
"DeviceId": 4,
"MapType": "sample string 5",
"MaxCount": 6,
"UserId": 7,
"Token": "sample string 8",
"Language": "sample string 9",
"AppId": "sample string 10"
}
application/xml, text/xml
Sample:
<SingTravelModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ParModel"> <AppId>sample string 10</AppId> <Language>sample string 9</Language> <Token>sample string 8</Token> <DeviceId>4</DeviceId> <End>2025-12-12T05:28:46.2336427+08:00</End> <MapType>sample string 5</MapType> <MaxCount>6</MaxCount> <Start>2025-12-12T05:28:46.2336427+08:00</Start> <TravelId>1</TravelId> <UserId>7</UserId> </SingTravelModel>
Response Information
Resource Description
State 状态
0. 表示成功
100. 表示无数据
1100. 表示设备不存在
4000. 表示失败
| Name | Description | Type | Additional information |
|---|---|---|---|
| TravelOilData |
单个行程油耗详情 |
OilData |
None. |
| DabAction |
不良行为数据 |
BadDriveAction |
None. |
| TravelInfo |
行程数据 |
SingleTravelInfo |
None. |
| ExceptionMessageItems |
设备报警信息集合 |
ExceptionMessageCount |
None. |
| TravelTrack |
行程轨迹 |
Track |
None. |
| Star |
行程评分 最高五颗星 |
integer |
None. |
| State |
状态码 |
integer |
None. |
Response Formats
application/json, text/json
Sample:
{
"TravelOilData": {
"AvgOil": 1.0,
"AvgSpeed": 2.0,
"TotalOil": 3.0,
"DetailItems": [
{
"Speed": 1.0,
"Oil": 2.0,
"Time": "sample string 3"
},
{
"Speed": 1.0,
"Oil": 2.0,
"Time": "sample string 3"
}
]
},
"DabAction": {
"FastAccelerate": 1,
"UrgentRefueling": 2,
"FastLaneChanging": 3,
"FastCornering": 4,
"FastSpeedUp": 5,
"TotalBadAction": 15
},
"TravelInfo": {
"TotalDistance": 1.0,
"TotalTime": 2.0,
"LowDistance": 3.0,
"LowTime": 4.0,
"LowSpeedingOil": 5.0,
"HighDistance": 6.0,
"HighTime": 7.0,
"HighSpeedingOil": 8.0,
"MiddleDistance": 9.0,
"MiddleTime": 10.0,
"MediumSpeedingOil": 11.0,
"SpeedingDistance": 12.0,
"SpeedingTime": 13.0,
"SpeedingOil": 14.0,
"IdlingDistance": 15.0,
"IdlingTime": 16.0,
"IdlingOil": 17.0
},
"ExceptionMessageItems": {
"shock": 1,
"PullOut": 2,
"trailer": 3,
"FatigueDriving": 4,
"Battery": 5,
"GPS": 6,
"Coolant": 7,
"Rapid": 8,
"Come": 9,
"RapidLaneChange": 10,
"SharpTurn": 11,
"SlamTheBrakesOn": 12,
"Speeding": 13,
"idling": 14
},
"TravelTrack": {
"Items": [
{
"Address": "sample string 1",
"Lng": 2.0,
"Lat": 3.0,
"OLng": 4.0,
"OLat": 5.0
},
{
"Address": "sample string 1",
"Lng": 2.0,
"Lat": 3.0,
"OLng": 4.0,
"OLat": 5.0
}
]
},
"Star": 1,
"State": 2
}
application/xml, text/xml
Sample:
<SingleTravelResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ResModel">
<State>2</State>
<DabAction xmlns:d2p1="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ViewModel">
<d2p1:FastAccelerate>1</d2p1:FastAccelerate>
<d2p1:FastCornering>4</d2p1:FastCornering>
<d2p1:FastLaneChanging>3</d2p1:FastLaneChanging>
<d2p1:FastSpeedUp>5</d2p1:FastSpeedUp>
<d2p1:UrgentRefueling>2</d2p1:UrgentRefueling>
</DabAction>
<ExceptionMessageItems>
<Battery>5</Battery>
<Come>9</Come>
<Coolant>7</Coolant>
<FatigueDriving>4</FatigueDriving>
<GPS>6</GPS>
<PullOut>2</PullOut>
<Rapid>8</Rapid>
<RapidLaneChange>10</RapidLaneChange>
<SharpTurn>11</SharpTurn>
<SlamTheBrakesOn>12</SlamTheBrakesOn>
<Speeding>13</Speeding>
<idling>14</idling>
<shock>1</shock>
<trailer>3</trailer>
</ExceptionMessageItems>
<Star>1</Star>
<TravelInfo xmlns:d2p1="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ViewModel">
<d2p1:HighDistance>6</d2p1:HighDistance>
<d2p1:HighSpeedingOil>8</d2p1:HighSpeedingOil>
<d2p1:HighTime>7</d2p1:HighTime>
<d2p1:IdlingDistance>15</d2p1:IdlingDistance>
<d2p1:IdlingOil>17</d2p1:IdlingOil>
<d2p1:IdlingTime>16</d2p1:IdlingTime>
<d2p1:LowDistance>3</d2p1:LowDistance>
<d2p1:LowSpeedingOil>5</d2p1:LowSpeedingOil>
<d2p1:LowTime>4</d2p1:LowTime>
<d2p1:MediumSpeedingOil>11</d2p1:MediumSpeedingOil>
<d2p1:MiddleDistance>9</d2p1:MiddleDistance>
<d2p1:MiddleTime>10</d2p1:MiddleTime>
<d2p1:SpeedingDistance>12</d2p1:SpeedingDistance>
<d2p1:SpeedingOil>14</d2p1:SpeedingOil>
<d2p1:SpeedingTime>13</d2p1:SpeedingTime>
<d2p1:TotalDistance>1</d2p1:TotalDistance>
<d2p1:TotalTime>2</d2p1:TotalTime>
</TravelInfo>
<TravelOilData xmlns:d2p1="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ViewModel">
<d2p1:AvgOil>1</d2p1:AvgOil>
<d2p1:AvgSpeed>2</d2p1:AvgSpeed>
<d2p1:DetailItems>
<d2p1:OilDetail>
<d2p1:Oil>2</d2p1:Oil>
<d2p1:Speed>1</d2p1:Speed>
<d2p1:Time>sample string 3</d2p1:Time>
</d2p1:OilDetail>
<d2p1:OilDetail>
<d2p1:Oil>2</d2p1:Oil>
<d2p1:Speed>1</d2p1:Speed>
<d2p1:Time>sample string 3</d2p1:Time>
</d2p1:OilDetail>
</d2p1:DetailItems>
<d2p1:TotalOil>3</d2p1:TotalOil>
</TravelOilData>
<TravelTrack xmlns:d2p1="http://schemas.datacontract.org/2004/07/NewGPS2012.AppApi.Models.ViewModel">
<d2p1:Items>
<d2p1:TrackPoint>
<d2p1:Address>sample string 1</d2p1:Address>
<d2p1:Lat>3</d2p1:Lat>
<d2p1:Lng>2</d2p1:Lng>
<d2p1:OLat>5</d2p1:OLat>
<d2p1:OLng>4</d2p1:OLng>
</d2p1:TrackPoint>
<d2p1:TrackPoint>
<d2p1:Address>sample string 1</d2p1:Address>
<d2p1:Lat>3</d2p1:Lat>
<d2p1:Lng>2</d2p1:Lng>
<d2p1:OLat>5</d2p1:OLat>
<d2p1:OLng>4</d2p1:OLng>
</d2p1:TrackPoint>
</d2p1:Items>
</TravelTrack>
</SingleTravelResult>