第27章運行状況の時間的な記録情報の取得

API名：
dailyreport/bstimechart

概要：
運行状況の時間的な記録情報を取得します。
温度データ、エンジン回転数などを取得できます。

URI：
https://ドメイン名/openapi/v1/dailyreport/bstimechart

メソッド：
GET

27.1GETメソッド

27.1.1リクエスト

API使用例：

Request URL: https://ドメイン名/openapi/v1/dailyreport/bstimechart?dbId=17&vehicleId=23&startDate=2023/01/01 00:00:00&endDate=2023/01/07 23:59:59&includeOnGoing=True
Request Method: GET
Request Head:
　　　　content-type: application/json
　　　　Authorization: Bearer eyJ4NX…
各リクエストパラメータは下記の通りです。
リクエストパラメータの必須の組み合わせは、主に2パターンあります。
パラメータ名
必須（2パターン）
データ型
デフォルト
説明
dbId
〇
Integer
運行IDを指定します。

※1


vehicleId
〇
Integer
車両IDを指定します。

※1


startDate
〇
Date
取得したいデータの開始日時を指定します。
フォーマット: yyyy/MM/dd HH:mm:ss

※1 ※2


endDate
〇
Date
取得したいデータの終了日時を指定します。
フォーマット: yyyy/MM/dd HH:mm:ss

※1 ※2


includeOnGoing
Boolean
False
運行中データ含むかどうかを指定します。
True：運行中のデータを含む
False：運行中のデータを含まない

※1
vehicleId、startDate、endDateよりもdbIdで指定したパラメータが優先されます。

※2
startDateとendDateの指定は、最大１週間(168時間)可能です。
startDate≦データの記録時刻≦endDate を満たすデータを返却します。

27.1.2レスポンス

各レスポンスパラメータは下記の通りです。
パラメータ名
データ型
説明
status
Object
ステータス情報が入ります。
code
String
ステータスコードが入ります。
詳しい内容は状態コードとエラー‌を参照してください。
message
String
ステータス内容に関するメッセージが入ります。
詳しい内容は状態コードとエラー‌を参照してください。
results
Object
リクエスト結果の情報が入ります。
recordCount
Integer
リクエストにより取得したレコードの行数が入ります。
resultList
Array
データが入ります。
dbId
Integer
運行が入ります。
eigyousyoId
Integer
営業所IDが入ります。
vehicleId
Integer
車両IDが入ります。
dateT
Date
時間が入ります。
フォーマット：yyyy/MM/dd HH:mm:ss
distance
Integer
距離が入ります。
単位：10m
latitude
String
緯度が入ります。
単位：0.1秒
longitude
String
経度が入ります。
単位：0.1秒
roadKind
Integer
道路区分が入ります。
1:一般道１
2:一般道２
3:高速道
4:専用道
loadingKind
Integer
荷積区分が入ります。
1:空車
2:実車
speed
Integer
dateTのときの速度が入ります。 
範囲：0～255
単位：km/h
speedAvg
Integer
(dateT-1分)からdateTの間での平均速度が入ります。 
範囲：0～255
単位：km/h
speedMax
Integer
(dateT-1分)からdateTの間での最高速度が入ります。 
範囲：0～255
単位：km/h
speedMin
Integer
(dateT-1分)からdateTの間での最低速度が入ります。 
範囲：0～255
単位：km/h
engineRevAvg
Integer
(dateT-1分)からdateTの間での平均エンジン回転数が入ります。 
単位：rpm
engineRevMax
Integer
(dateT-1分)からdateTの間での最高エンジン回転数が入ります。 
単位：rpm
engineRevMin
Integer
(dateT-1分)からdateTの間での最低エンジン回転数が入ります。 
単位：rpm
analog1Avg
Decimal
(dateT-1分)からdateTの間でのアナログ１の温度の平均値が入ります。 
精度：0.1
単位：℃
analog1Max
Decimal
(dateT-1分)からdateTの間でのアナログ１の温度の最高値が入ります。 
精度：0.1
単位：℃
analog1Min
Decimal
(dateT-1分)からdateTの間でのアナログ１の温度の最低値が入ります。 
精度：0.1
単位：℃
analog2Avg
Decimal
(dateT-1分)からdateTの間でのアナログ２の温度の平均値が入ります。 
精度：0.1
単位：℃
analog2Max
Decimal
(dateT-1分)からdateTの間でのアナログ２の温度の最高値が入ります。 
精度：0.1
単位：℃
analog2Min
Decimal
(dateT-1分)からdateTの間でのアナログ２の温度の最低値が入ります。 
精度：0.1
単位：℃
analog3Avg
Decimal
(dateT-1分)からdateTの間でのアナログ３の温度の平均値が入ります。 
精度：0.1
単位：℃
analog3Max
Decimal
(dateT-1分)からdateTの間でのアナログ３の温度の最高値が入ります。 
精度：0.1
単位：℃
analog3Min
Decimal
(dateT-1分)からdateTの間でのアナログ３の温度の最低値が入ります。 
精度：0.1
単位：℃
analog4Avg
Decimal
(dateT-1分)からdateTの間でのアナログ４の温度の平均値が入ります。 
精度：0.1
単位：℃
analog4Max
Decimal
(dateT-1分)からdateTの間でのアナログ４の温度の最高値が入ります。 
精度：0.1
単位：℃
analog4Min
Decimal
(dateT-1分)からdateTの間でのアナログ４の温度の最低値が入ります。 
精度：0.1
単位：℃
latitudeBefore50s
Integer
50秒前のlatitudeからの緯度の差分が入ります。
 単位：0.1秒
latitudeBefore40s
Integer
40秒前のlatitudeからの緯度の差分が入ります。
単位：0.1秒
latitudeBefore30s
Integer
30秒前のlatitudeからの緯度の差分が入ります。
単位：0.1秒
latitudeBefore20s
Integer
20秒前のlatitudeからの緯度の差分が入ります。
単位：0.1秒
latitudeBefore10s
Integer
10秒前のlatitudeからの緯度の差分が入ります。
単位：0.1秒
longitudeBefore50s
Integer
50秒前のlongitudeからの経度の差分が入ります。
単位：0.1秒
longitudeBefore40s
Integer
40秒前のlongitudeからの経度の差分が入ります。
単位：0.1秒
longitudeBefore30s
Integer
30秒前のlongitudeからの経度の差分が入ります。
単位：0.1秒
longitudeBefore20s
Integer
20秒前のlongitudeからの経度の差分が入ります。
単位：0.1秒
longitudeBefore10s
Integer
10秒前のlongitudeからの経度の差分が入ります。
単位：0.1秒
レスポンス例：
{
    "status": {
       "code": "AF00E0000",
       "message": "SUCCESS"
   },
   "results": {
       "recordCount": 1,
       "resultList": [
           {
               "dbId": 17,
               "eigyousyoId": 11,
               "vehicleId": 23,
               "dateT": "2023/01/03 07:17:23",
               "distance": 111,
               "latitude": "116.34528",
               "longitude": "39.21028",
               "roadKind": 4,
               "loadingKind": 2,
               "speed": 0,
               "speedAvg": 0,
               "speedMax": 0,
               "speedMin": 0,
               "engineRevAvg": 0,
               "engineRevMax": 0,
               "engineRevMin": 0,
               "analog1Avg": 0.0,
               "analog1Max": 0.0,
               "analog1Min": 0.0,
               "analog2Avg": 0.0,
               "analog2Max": 0.0,
               "analog2Min": 0.0,
               "analog3Avg": 0.0,
               "analog3Max": 0.0,
               "analog3Min": 0.0,
               "analog4Avg": 0.0,
               "analog4Max": 0.0,
               "analog4Min": 0.0,
               "latitudeBefore50s": 0,
               "latitudeBefore40s": 0,
               "latitudeBefore30s": 0,
               "latitudeBefore20s": 0,
               "latitudeBefore10s": 0,
               "longitudeBefore50s": 0,
               "longitudeBefore40s": 0,
               "longitudeBefore30s": 0,
               "longitudeBefore20s": 0,
               "longitudeBefore10s": 0
           }
       ]
   }
}