運転分析 API

/violation/analyze [POST]

基本情報

概要

走行データをもとに運転分析（走行道路の判定、道路交通法違反検知）を行います。

実装企業

ナビタイムジャパン

URL

https://{HOST}/violation/analyze

出力形式

• GZIP (application/gzip)
  • 解凍した中身はJSON

注意点

• 分析完了後、連携企業側に実装する運転分析完了通知APIにて運転分析完了状態(分析成功/失敗)等を通知します。
  通知内容に関しては、運転分析結果通知APIをご確認ください。
  

パラメータ

なし

リクエストボディ

リクエストボディ 注意点

走行データはGZIP圧縮(RFC1952)したJSON文字列をBase64形式エンコードしリクエストボディに設定してください。

リクエストボディ パラメータ

パラメータ名		必須	概要	型名	選択値/制限	デフォルト値
target			分析対象
	company	✔	企業ID ナビタイムが利用企業向けに発行	文字列
	user_id	✔	利用ユーザを識別するID 利用企業側で発行	文字列	半角英数字128文字まで
	analyze_id	✔	分析を識別するID 利用企業側で発行	文字列	半角英数字128文字まで
	datum		走行データ 測地系	文字列	wgs84(世界測地系) tokyo(日本測地系)	wgs84(世界測地系)
	lonlat_format		走行データ フォーマット	文字列	degree(度表記) millsec(ミリ秒)	degree(度表記)
	car_type		車種	文字列	乗用or貨物 車両サイズ に対応した設定値	普通乗用車
drive_data			走行データ
	date	✔	日時	文字列	フォーマット YYYYMMDDhhmmss
	lon	✔	経度	文字列
	lat	✔	緯度	文字列

リクエストボディ サンプル

{
  "target": {
    "company": "company_code",
    "user_id": "user1",
    "analyze_id": "analyze1",
    "datum": "wgs84",
    "lonlat_format": "degree"
  },
  "drive_data": [
    {
      "date": "202011121030",
      "lon": "139.508351",
      "lat": "35.59508"
    },
    {
      "date": "202011121031",
      "lon": "139.508361",
      "lat": "35.59558"
    }
  ]
}

レスポンス

レスポンス パラメータ

パラメータ名	概要	型名	説明
status	分析受付結果	文字列	success:受付成功 error:受付失敗
error	エラーメッセージ	配列	受付時に発生したエラー情報を設定

レスポンス サンプル(StatusCode:200)

{
  "status": "success",
  "error": null
}

レスポンス サンプル(StatusCode:400)

{
  "status": "error",
  "error": [
    "Company is not allowed.",
    "Body is not Base64/Json/Gzip."
  ]
}