第14章動画データの取得

API名：
video/videodata

概要：
リクエストされた車両のドライブレコーダーで撮影した動画データを取得します。

URI：
https://ドメイン名/openapi/v1/video/videoData

メソッド：
POST

14.1POSTメソッド

14.1.1リクエスト

API使用例：

Request URL: https://ドメイン名/openapi/v1/video/videoData
Request Method: POST
Request Head:
　　 content-type: application/json
　　　　Authorization: Bearer eyJ4NX…
Request Body:
{
"reqTime": "2023-06-12 13:37:42",
"vehicleCode": "12345678",
"combineVideosFlag": false,
"sensorDataFlag": false
}

各リクエストパラメータは下記の通りです。


パラメータ名	必須	データ型	デフォルト	説明
vehicleCode	〇	String		動画データを取得したい車両の車両コード(数字8桁以内)を指定します。※1
reqTime	〇	Date		取得したい動画の時刻を指定します。フォーマットはyyyy-mm-dd hh:mm:ssもしくはISO8601拡張形式でダブルコーテーションで囲って指定します。※2
combineVideosFlag		Boolean	false	カメラが複数台ある場合、各カメラの動画を結合し1つの動画とするか指定します。 true：結合する false：結合しない
sensorDataFlag		Boolean	false	動画と一緒にセンサデータ、ブレーキ・ウィンカーデータも取得するか指定します。 true：取得する false：取得しない

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

・車両コードが正しいフォーマットで指定されていない

・指定された車両が存在しない

・ドライブレコーダーが搭載されていない車両の車両コードが指定されている

※2　ISO8601拡張形式での指定は下記の通りです。

　　 yyyy-mm-ddTh:mm:ssZ 協定世界時UTCとして処理します。
　　 yyyy-mm-ddThh:mm:ss+09:00 日本標準時JSTとして処理します。
　　yyyy-mm-ddThh:mm:ss 日本標準時JSTとして処理します。
　　正しいフォーマットで指定されていない場合、エラーとなります。
　　

このAPIはリクエスト間のインターバル5分という制限あります。
5分以内に次のリクエストがあった場合はエラーとなります。

14.1.2レスポンス

各レスポンスパラメータは下記の通りです。


パラメータ名	データ型	説明
status	Object	ステータス情報が入ります。
	code	String	ステータスコードが入ります。詳しい内容は状態コードとエラーを参照してください。
	message	String	ステータス内容に関するメッセージが入ります。詳しい内容はを参照してください。詳しい内容は状態コードとエラーを参照してください。
results	Object	リクエスト結果の情報が入ります。
	fileUrl	String	取得した動画ファイルのURLが入ります。リクエスト時にcombineVideosFlagをtrueにした場合、全カメラ動画を結合した動画ファイルのURLが入ります。リクエスト時にcombineVideosFlagをflaseにした場合、各カメラの動画が入ったZipファイルのURLが入ります。動画のファイル名については動画データの詳細を参照してください。動画の長さは30秒です。
	startTime	Date	動画の開始時刻が入ります。 yyyy/mm/dd hh:mm:ss
	endTime	Date	動画の終了時刻が入ります。 yyyy/mm/dd hh:mm:ss
	cameraNameDict	Array	各カメラのカメラ名称が入ります。 (お客様設定値)
	vehicleCode	String	動画を取得した車両の車両コードが入ります。(数字8桁)
	vehicleName	String	動画を取得した車両の名称が入ります。
	driverCode	String	動画取得した車両を運転していた乗務員の乗務員コードが入ります。(数字8桁)
	timeOut	Boolean	タイムアウトかどうかの情報が入ります。 true:タイムアウト false:タイムアウトではない
	driverName	String	動画取得した車両を運転していた乗務員の乗務員名が入ります。
	loadingKind	String	車両の荷積状態が入ります。空車もしくは実車
	address	String	動画が撮影されたときの地点の住所が入ります。
	dbId	Integer	動画が撮影されたときの運行の運行IDが入ります。
	sendStatus	Integer	動画の取得状態を表す番号が入ります。 0：送信依頼中 1：送信中 4：送信失敗 10：取得開始 11：取得完了 12：送信待機(データの空きなし) 13：送信待機(通信のコネクションなし) 14：取消完了 15：データ無 16：リトライオーバ 20：取消要求
	returnCode	Integer	取得した動画の処理状態を表す番号が入ります。 1000：正常に終了 1031：ファイルの保存に失敗 1032：音声変換に失敗 1033：動画の変換に失敗 1034：動画の表紙変換に失敗
	sensorData	Array	リクエスト時にsensorDataFlagをtureにした場合、センサデータが入ります。詳しくはセンサデータの詳細を参照下さい。
	brakeData	Array	リクエスト時にsensorDataFlagをtrueにした場合、ブレーキ情報が入ります。
		recordCode	String	ブレーキ操作に対するレコード区分が入ります。ブレーキON：F19C ブレーキOFF：F19D
		time	Date	上記レコードが記録された時刻が入ります。
	leftWinkerData	Array	リクエスト時にsensorDataFlagをtrueにした場合、ウィンカー情報が入ります。※1
		recordCode	String	ウィンカー操作に対するレコード区分が入ります。左ウィンカーON：F1B0、左ウィンカーOFF：F1AF
		time	Date	上記レコードが記録された時刻が入ります。
	rightWinkerData	Array	リクエスト時にsensorDataFlagをtrueにした場合、ウィンカー情報が入ります。※1
		recordCode	String	ウィンカー操作に対するレコード区分が入ります。右ウィンカーON：F1AE、右ウィンカーOFF：F1AD
		time	Date	上記レコードが記録された時刻が入ります。
	hasVedioData		ファイル存在設定true、ファイル存在設定falseです。

※1　ハザードの場合は、右ウィンカー：F1AE、左ウィンカー：F1B0が同時に記録されます。

・取得した動画のファイル名規則は下記の通りです。

　video_会社コード_車両シリアル番号_撮影日時_カメラ番号.mp4

レスポンス例

｛
"status":{
"code":"AF00E0000",
"message":"success"
}
　　"results":[
{
"fileUrl":"https://itpv3.transtron.fujitsu.com/video/companyGroup2/Temp/00000333/video/00000333_0010007388_20210720143534.zip?key=8hHiYlrnFWDI7dlDu_-crw&expires=1626845734",
"hasVedioData": False,
"startTime":"2021/07/20 14:35:34",
"endTime":"2021/07/20 14:36:04",
"cameraNameDict":["デジカメ0","デジカメ2","前方1","荷室1","左側1","後方","右側","荷室","左側"],
"vehicleCode":"12345678",
"vehicleName":"車両1",
"driverCode":"87654321",
"timeOut":false,
"driverName": "佐藤",
"loadingKind":"空車",
"returnCode": 1000,
"address":"東京都千代田区丸の内1丁目9-1",
"dbId":"123",
"sendStatus"：11,
"sensorData":[
{
time:"2021/10/14 05:00:00.000",
speed:60.0,
latitude:"035.40.403",
longitude:"139.46.131",
engine:2000,
positioning:1,
dop:10,
gyro:0.1,
g1:0.11,
g2:0.22,
g3:0.33,
loadKind:1,
roadKind:2,
distance:10.00
}
]
"brakeData":[
{
"recordCode":"F19C",
"time":"2021/08/26 09:10:00",
},
{
"recordCode":"F19D",
"time":"2021/08/26 09:10:30",
}
]
"leftWinkerData":[
{
"recordCode":"F1AF",
"time":"2021/08/26 09:10:00"
},
{
"recordCode":"F1B0",
"time":"2021/08/26 09:10:30"
}
]
"rightWinkerData":[
{
"recordCode":"F1AD",
"time":"2021/08/26 09:10:00"
},
{
"recordCode":"F1AE",
"time":"2021/08/26 09:10:30"
}
]

]

}