第6章作業情報の取得

API名:
vehicle/workInfo

概要:
リクエストされた車両の出庫、荷積、荷卸、帰庫地点の情報を取得します。

URI:
https://ドメイン名/openapi/v1/vehicle/workInfo



API使用例:

Request URL: https://ドメイン名/openapi/v1/vehicle/workInfo
Request Method: POST
Request Head:
    content-type: application/json
    Authorization:Bearer eyJ4NX…

Request body:
        {
          "dbIdList": [1,2,3]
        }


各リクエストパラメータは下記の通りです。
パラメータ名
必須
データ型
デフォルト
説明
dbIdList

Array
日報IDのリストを指定してください。
各レスポンスパラメータは下記の通りです。
パラメータ名
データ型
説明
status
Object
ステータス情報が入ります。
code
String
ステータスコードが入ります。
詳しい内容は第22章 状態コードとエラーを参照してください。
message
String
ステータス内容に関するメッセージが入ります。
詳しい内容は第22章 状態コードとエラーを参照してください。
results
Object
リクエスト結果の情報が入ります。
resultsの中身は下記の通りです。
パラメータ名
データ型
説明
matchedWorkInfoList
Array
マッチングした情報(運行の作業の地点情報と日時情報)を配列に保持しています。
dbId
Integer
マッチングした日報IDが入ります。
infoList
Array
マッチングした出庫の地点情報と日時情報が入ります。
workKind
Integer
作業の種類を示す値が入ります。
(1:出庫, 2:荷積, 3:荷卸, 4:帰庫, 0:他の作業)
latitude
String
地点の緯度が入ります。 ※1,※2
longitude
String
地点の経度が入ります。 ※1,※2
datetime
String
日時情報が入ります。 ※3

※1


フォーマット: 度形式、”xxx.xxxx”

※2


日本測地系となります。

※3


フォーマット: yyyy-MM-dd HH:mm:ss

レスポンスの例
 {                 
  "status": {                
   "code": "AF00E0000",               
   "message": "SUCCESS"               
  },                
  "results": {                
   "matchedWorkInfoList":[               
    {              
     "dbId":1,             
     "infoList":[             
      {            
       "workKind":1,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 05:00:00"           
      },            
      {            
       "workKind":2,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 05:10:00"           
      },            
      {            
       "workKind":0,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 06:10:00"           
      },            
      {            
       "workKind":0,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 07:10:00"           
      },            
      {            
       "workKind":2,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 08:10:00"           
      },            
      {            
       "workKind":4,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 09:10:00"           
      }            
     ]             
    },              
    {              
     "dbId":2,             
     "infoList":[             
      {            
       "workKind":1,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 05:00:00"           
      },            
      {            
       "workKind":3,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 05:10:00"           
      },            
      {            
       "workKind":3,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 06:10:00"           
      },            
      {            
       "workKind":0,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 07:10:00"           
      },            
      {            
       "workKind":0,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 08:10:00"           
      },            
      {            
       "workKind":0,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 09:10:00"           
      },            
      {            
       "workKind":4,           
       "latitude":"35.123456",           
       "longitude":"139.123456",           
       "datetime":"2021/04/26 10:10:00"           
      }            
     ]             
    }              
   ]               
   }                
 }