第10章指定日以降の運行情報の取得

API名:
dailyreport/newmovement

概要:
指定日以降の運行情報を取得します。

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

メソッド:
GET
API使用例:

Request URL: https://ドメイン名/openapi/v1/dailyreport/newmovement
Request Method: GET
Request Head:
    content-type: application/json
    Authorization: Bearer eyJ4NX…
Qery String Parameters:
       "eigyousyoId":1,
       "eigyousyoCode": "",
       "IncludeRunning":false,
       "specifiedTime":"2021/6/1",
       "limit":200,
       "offset":0
各リクエストパラメータは下記の通りです。
パラメータ名
必須
データ型
デフォルト
説明
eigyousyoId
Integer
営業所IDを指定します。
指定されていない場合は全営業所で検索を行います。
eigyousyoCode
String
営業所コードを指定します。(数字8桁)
指定されていない場合は全営業所で検索を行います。
IncludeRunning
Boolean
false
運行中の車両も取得対象に含むかどうか指定します。
true:含める
false:含めない
含めない場合は、運行が終了しているもののみ取得します。
specifiedTime

Date
運行日を指定します。
指定された運行日以降の運行情報を取得します。
limit
Number
100
1回のリクエストで取得するレコード件数を指定します。
範囲:100~1000 ※1
offset
Number
0
どのレコードから取得するか指定します。※2

※1 100<limit値<1000 以外の値が指定されている場合、エラーとなります。


   

※2 下記の場合、エラーとなります。


  ・offset値に0より小さい値が指定されている


  ・offest値が全レコード件数より大きい値が指定されている


   
各レスポンスパラメータは下記の通りです。
パラメータ名
データ型
説明
status
Object
ステータス情報が入ります。
code
String
ステータスコードが入ります。
詳しい内容は状態コードとエラーを参照してください
message
String
ステータス内容に関するメッセージが入ります。
詳しい内容は状態コードとエラーを参照してください
results
Object
リクエスト結果の情報が入ります。
totalCount
Integer
リクエスト内容から検索された運行の数の合計が入ります。
営業所が指定されている場合は、指定された営業所の指定日以降の全運行数です。
営業所が指定されていない場合は、全営業所の指定日以降の全運行数です。
count
Integer
今回のレスポンスで取得された運行数が入ります。
offset
Integer
リクエストで指定されたoffsetの値が入ります。
newMovementInfo
Array
営業所ごとの運行情報が入ります。
eigyousyoId
Integer
営業所IDが入ります。
eigyousyoCode
String
営業所コードが入ります。(数字8桁)
branchList
Array
営業所の所属情報が入ります。
branchCode
String
属している所属の所属コードが入ります。(数字8桁)
branchName
String
属している所属の所属名称が入ります。
movementBasicInfo
Array
運行の各種情報が入ります。
coseBin
String
登録されている場合は、コース番号が入ります。
dailyReportKind
Byte
日報の種類が入ります。
0:車載機からの走行データで作成された日報
1:ITP-WebServiceV3上で手入力で作成された日報
2:運行中(まだ帰庫されていない)の日報
dbId
Int
運行ごとの運行IDが入ります。
directiveNoUsed
Byte
管理番号の入力要否が入ります。
0:入力必要なし
1:入力が必要
displayMovementStartTime
String
出庫された時刻が入ります。mm/dd hh:mm
driveRecordFlag
Byte
車載機画面への撮影ボタンの表示有無が入ります。
0:表示しない
1:表示する
driverBranchCode
String
乗務員の属する所属の所属コードが入ります。(数字8桁)
driverBranchName
String
乗務員の属する所属の所属名称が入ります。
driverCode
String
運行する乗務員の乗務員コードが入ります。(数字8桁)
driverId
Int
運行する乗務員の乗務員IDが入ります。
driverEigyousyoId
Integer
乗務員の属する営業所の営業所IDが入ります。
driverKind
Byte
運行する乗務員の乗務員区分が入ります。
0:主乗務員
1:副乗務員
driverName
String
運行する乗務員の乗務員名称が入ります。
endFlag
Byte
帰庫もしくは乗換の実施状況が入ります。
1:乗換
2:帰庫
maintenanceFlag1
Byte
下記修正の実施状況が入ります。
0:未修正
1:車両乗換修正もしくは乗務員コード/指示書№以外の修正
maintenanceFlag2
Byte
下記修正の実施状況が入ります。
0:未修正
1:乗務員コード/指示書№の修正
maintenanceKind
Byte
日報メンテナンスの実施状況が入ります。
0:未修正
1:日報メンテナンスされた日報
maintenanceTime
Date
日報メンテナンスがされている場合、メンテナンスされた時刻が入ります。
makeReportFlag
Byte
日報の区分が入ります。
1:車両の走行データで新規作成された日報
2:ITP-WebServiceV3の日報表示画面で新規作成された日報
moveIndicationCodeCheckFlag
Byte
入力された管理番号のチェック実施要否が入ります。
0:必要なし
1:必要
moveindicationCode
String
登録されている場合、管理番号が入ります。
movementEndTime
Date
運行の終了日時が入ります。
movementStartTime
Date
運行の開始日時が入ります。
outputFlag
Byte
上位連携での乗換日報CSV出力状況が入ります。
0:出力しない
1:出力する
rollCallEnd
String
点呼を行った場合、点呼終了状況が入ります。
true:点呼終了
false:点呼終了していない
rollCallStart
String
点呼開始状況が入ります。
true:点呼開始
false:点呼をしていない
safetyDailyReport
Byte
安全日報の出力有無が入ります。
0:なし
1:あり
2:安全日報のみ印刷
transferKind
Int
どんな乗換だったのかが入ります。
0:出庫→帰庫
1:出庫→乗換
2:乗換→乗換
3:乗換→帰庫
transferKindDisp
String
上記乗換状態の番号に対応する名称が入ります。
vehicleBranchCode
String
車両の属する所属の所属コードが入ります。(数字8桁)
vehicleBranchName
String
車両の属する所属の所属名称が入ります。
vehicleCode
String
運行する車両の車両コードが入ります。(数字8桁)
vehicleDbId
Integer
車両を管理するDBの番号が入ります。
vehicleEigyousyoCode
String
車両の属する営業所の営業所コードが入ります。(数字8桁)
vehicleEigyousyoId
Integer
車両が属する営業所の営業所IDが入ります。
vehicleId
Int
運行する車両のIDが入ります。
vehicleName
String
運行する車両の車両名称が入ります。
transferKindList
Array
日報選択画面で乗換状態を切り替える場合に使用できる乗換状態のリストです。
transferKind
Int
日報選択画面で切り替え可能な乗換状態の種類が入ります。
0:出庫→帰庫
1:出庫→乗換
2:乗換→乗換
3:乗換→帰庫
transferKindDisp
String
上記乗換状態の番号に対応する名称が入ります。
dataTypeCd
String
MMデータ識別コードが入ります。
dailyReportPrintFlag
Byte
日報印刷状况フラグが入ります。
0:未印刷
1:印刷済み
settings
Array
設定情報が入ります。
controlNoDisplayFlag
Byte
ITP-WebServiceV3日報表示画面への管理番号表示有無が入ります。
0:表示しない
1:表示する
controlNoName
String
登録されている"管理番号"の名称が入ります。
dateDispalyFlag
Boolean
出庫日付の表示有無が入ります。
true:出庫の日付を表示する
false:出庫の日付を表示しない
directiveNoUsed
String
管理番号の入力要否に関するお客様が決めた設定情報が入ります。
0:必要なし
1:必要
moveindicationCodeCheckFlag
Byte
入力された管理番号のチェック要否に関するお客様が決めた設定情報が入ります。
transferDisplayFlag
Byte
日報表示画面への乗換日報ID、乗換状況の表示有無に関するお客様が決めた設定情報が入ります。
0:表示しない
1:表示する
transferReportSettingFlag
Byte
乗換えた日報をどのように集計するかお客様が決めた設定情報が入ります。
0:各日報ごとに集計する
1:1つの日報としてまとめて集計する
transferTableMakeFlag
Byte
乗換日報の作成有無に関するお客様が決めた設定情報が入ります。
0:作成しない
1:作成可能
レスポンス例:

  "status":{
       "code": "AF00E0000",
       "message": "SUCCESS"
    },
    "results":{
     "totalCount":1000.
         "count":200,
         "offset":0,
         "newMovementInfo":[{
            "eigyousyoId":1,
            "eigyousyoCode":1,
            "branchList":[{
            "branchCode": "",
            "branchName": "全て"
           },{
            "brachCode": "00000000",
            "branchName": "無所属"
           },{
            "branchCode": "00000002",
            "branchName": "所属1"
          }
     }],
         "movementBasicInfo":[{
            "coseBin": "",
            "dailyReportKind":1,
"dataTypeCd": "03",
            "dailyReportPrintFlag": 0,
            "dbId":92220042,
            "directiveNoUsed":null,
            "displayMovementStartTime":"12/22 02:02",
            "driveRecordFlag":0,
            "driverBranchCode":"00000002",
            "driverBranchName":"所属1",
            "driverCode":"20180589"
            "driverEigyousyoId":1,
            "driverId":5060,
            "driverKind":0,
            "driverName":"乗務員1",
            "endFlag":2,
            "maintenanceFlag1":1,
            "maintenanceFlag2":0,
            "maintenanceKind":1,
            "maintenanceTime":"2021/12/22 21:27:03",
            "makeReportFlag":2,
            "moveIndicationCodeCheckFlag":null,
            "moveindicationCode":"",
            "movementEndTime":"2021/12/22 03:02:00",
            "movementStartTime":"2021/12/22 02:02:00",
            "outputFlag":1,
            "rollCallEnd":"",
            "rollCallStart":"",
            "safetyDailyReport":0,
            "transferKind":0,
            "transferKindDisp":"出庫-帰庫",
            "transferKindList"[{
                   "transferKind":0,
                   "transferKindDisp":"出庫-帰庫"
             },{
                   "transferKind":1,
                   "transferKindDisp":"出庫-乗換"
             }],
             "vehicleBranchCode":"00000002",
             "vehicleBranchName":"所属1",
             "vehicleCode":"00000006",
             "vehicleDbId":3035,
             "vehicleEigyousyoCode":"00000001",
             "vehicleEigyousyoId":1,
             "vehicleId":8733,
             "vehicleName":"車両1", 
         }]
                "settings": {
                    "controlNoDisplayFlag": 1,
                    "controlNoName": "管理番号",
                    "dateDispalyFlag": false,
                    "directiveNoUsed": 0,
                    "moveindicationCodeCheckFlag": 0,
                    "transferDisplayFlag": 1,
                    "transferReportSettingFlag": 1,
                    "transferTableMakeFlag": 1

    }
}