Skip to content

JT/T 808 ゲートウェイデータ交換フォーマット

このページでは、emqx_jt808EMQX 間のデータ交換フォーマットを定義します。

規約:

  • ペイロードは JSON 形式で組み立てられます。
  • JSON のキー名はすべて小文字です。

JSON 構造例

端末からサーバーへ

json
{
  "header" : {
    "msg_id" : 1,
    "encrypt": 0,
    "len": VAL,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "seq": 1,
    "id": 1,
    "result": 0
  }
}

サーバーから端末へ

json
{
  "header": {
    "msg_id": 32769,
    "encrypt": 0,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "seq": 1,
    "id": 1,
    "result": 0
  }
}

データ型対応表

JT808 定義型JSON 型コメント
BYTEinteger10進数
WORDinteger10進数
DWORDinteger10進数
BYTE(n)string
BCD(n)string
STRINGstring

フィールド対応表

メッセージヘッダーのフィールド

フィールドJSON キー名値の型JSON 内の型
メッセージIDmsg_idwordinteger
暗号化方式encryptwordinteger
端末電話番号 (BCD6桁)phonebcd(6)string
メッセージシリアル番号msg_snwordinteger
オプションフィールドJSON キー名値の型JSON 内の型
メッセージ総数(分割時)frag_totalwordinteger
メッセージ分割シリアル番号frag_snwordinteger
  • frag_totalfrag_sn が存在する場合、メッセージ本文が長く複数パッケージに分割されていることを示します。

メッセージ本文のフィールド

端末からの一般応答 "msg_id": 1 0x0001

フィールドJSON キー名値の型JSON 内の型
応答シリアル番号seqwordinteger
応答IDidwordinteger
結果resultbyteinteger

プラットフォームからの一般応答 "msg_id": 32769 0x8001

フィールドJSON キー名値の型JSON 内の型
応答シリアル番号seqwordinteger
応答IDidwordinteger
結果resultbyteinteger

端末ハートビート "msg_id": 2 0x0002

空の JSON

サブパッケージ再送要求 "msg_id": 32771 0x8003

フィールドJSON キー名値の型JSON 内の型
元のメッセージシリアル番号seqwordinteger
再送パッケージ総数lengthbyteinteger
再送パッケージIDリストidsbyte(2*length)整数のリスト

端末登録 "msg_id": 256 0x0100

フィールドJSON キー名値の型JSON 内の型
省IDprovincewordinteger
市IDcitywordinteger
製造商IDmanufacturerbyte(5)string
端末モデルmodelbyte(20)string
端末IDdev_idbyte(7)string
車両色colorbyteinteger
車両識別番号license_numberstringstring

端末登録応答 "msg_id": 33024 0x8100

フィールドJSON キー名値の型JSON 内の型
応答シリアル番号seqwordinteger
結果resultbyteinteger
  • 登録成功後のみ存在するフィールド
オプションフィールドJSON キー名値の型JSON 内の型
認証コードauth_codestringstring

端末ログアウト "msg_id": 3 0x0003

空の JSON

端末認証 "msg_id": 258 0x0102

フィールドJSON キー名値の型JSON 内の型
認証コードcodestringstring

端末パラメータ設定 "msg_id": 33027 0x8103

フィールドJSON キー名値の型JSON 内の型
パラメータ総数lengthbyteinteger
パラメータ項目リストparamslistid と値のリスト [{"id":ID, "value": VAL}, ...]
パラメータ項目iddwordinteger
パラメータ値valuebyteinteger
  • プロトコルに基づくパラメータIDの説明あり

端末パラメータ照会 "msg_id": 33028 0x8104

空の JSON

特定端末パラメータ照会 "msg_id": 33030 0x8106

フィールドJSON キー名値の型JSON 内の型
パラメータ総数lengthbyteinteger
パラメータIDリストidsbyte(2*length)整数のリスト [1, 2, 3, 4, ...]
  • パラメータIDリストの要素は整数

端末応答パラメータ "msg_id": 260 0x0104

フィールドJSON キー名値の型JSON 内の型
応答シリアル番号seqwordinteger
応答パラメータ数lengthbyteinteger
パラメータ項目リストparamslistid と値のリスト [{"id":ID, "value": VAL}, ...]
パラメータ項目iddwordinteger
パラメータ値valuebyteinteger
  • プロトコルに基づくパラメータIDの説明あり

端末制御 "msg_id": 33029 0x8105

フィールドJSON キー名値の型JSON 内の型
コマンドワードcommandbyteinteger
コマンドパラメータparamstringstring

端末プロパティ照会 "msg_id": 33031 0x8107

空の JSON

端末プロパティ応答 "msg_id": 263 0x0107

フィールドJSON キー名値の型JSON 内の型
端末タイプtypewordinteger
製造商IDmanufacturerbyte(5)string
端末モデルmodelbyte(20)string
端末IDidbyte(7)string
端末SIMカードICCIDiccidbyte(10)string
端末ハードウェアバージョン番号hardware_versionstringstring
端末ファームウェアバージョン番号firmware_versionstringstring
GNSSモジュールプロパティgnss_propbyteinteger
通信モジュールプロパティcomm_propbyteinteger
  • 端末ハードウェアバージョン番号とファームウェア番号の長さはバイナリメッセージ解析に使用され、外部には公開されません。

端末アップグレードパッケージコマンド "msg_id": 33032 0x8108

フィールドJSON キー名値の型JSON 内の型
アップグレードタイプtypebyteinteger
製造商IDmanufacturerbyte(5)string
バージョン番号長さver_lenbyteinteger
バージョン番号versionstringstring
アップグレードパッケージ長さfw_lendwordinteger
アップグレードパッケージfirmwarebinarystring(base64 encoded)

端末アップグレード結果通知 "msg_id": 264 0x0108

フィールドJSON キー名値の型JSON 内の型
アップグレードタイプtypebyteinteger
アップグレード結果resultbyteinteger

位置情報報告 "msg_id": 512 0x0200

フィールドJSON キー名値の型JSON 内の型
警報フラグalarmdwordinteger
状態statusdwordinteger
緯度latitudedwordinteger
経度longitudedwordinteger
高度altitudewordinteger
速度speedwordinteger
方向directionwordinteger
時刻timebcd(6)string
オプションフィールドJSON キー名値の型JSON 内の型
追加位置情報項目extra-map
  • 追加位置情報項目は extra に格納
フィールド(追加情報説明)JSON キー名値の型JSON 内の型
走行距離mileagedwordinteger
燃料計fuel_meterwordinteger
運転記録による速度speedwordinteger
手動確認が必要な警報イベントIDalarm_idwordinteger
超速警報追加情報(長さ1または5)overspeed_alarm-map
進入/退出エリア・ルート警報追加情報in_out_alarm-map
ルート走行時間短すぎ/長すぎ警報追加情報path_time_alarm-map
拡張車両信号状態ビット状態ビット表参照--
IO状態ビットio_status-map
アナログanalog-map
無線通信ネットワーク信号強度rssibyteinteger
GNSS衛星数gnss_sat_numbyteinteger
以降のカスタム情報の長さcustome-string(base64 encoded)
  • 超速警報追加情報(長さ1または5)は overspeed_alarm マップ内
フィールドJSON キー名値の型JSON 内の型
位置情報タイプtypebyteinteger
オプションフィールドJSON キー名値の型JSON 内の型
エリアまたは区間IDiddwordinteger
  • 進入/退出エリア・ルート警報追加情報は in_out_alarm マップ内
フィールドJSON キー名値の型JSON 内の型
位置情報タイプtypebyteinteger
エリアまたは区間IDiddwordinteger
方向directionbyteinteger
  • ルート走行時間短すぎ/長すぎ警報追加情報は path_time_alarm マップ内
フィールドJSON キー名値の型JSON 内の型
区間IDiddwordinteger
ルート走行時間timewordinteger
結果resultbyteinteger
  • IO状態ビットは io_status マップ内
フィールドJSON キー名値の型JSON 内の型
ディープスリープ状態deep_sleep1 bitinteger
スリープ状態sleep1 bitinteger
  • アナログは analog マップ内
フィールドJSON キー名値の型JSON 内の型
アナログ0ad016 bitinteger
アナログ1ad116 bitinteger
  • 拡張車両信号状態ビットは extra マップ内
フィールドJSON キー名値の型JSON 内の型
信号(2ビット)signal- 2 bitsmap, {"low_beam": VAL, "high_beam": VAL}
右ウインカー信号right_turn1 bitinteger
左ウインカー信号left_turn1 bitinteger
ブレーキ信号brake1 bitinteger
バック信号reverse1 bitinteger
フォグライト信号fog1 bitinteger
サイドマーカーside_marker1 bitinteger
ホーン状態horn1 bitinteger
エアコン状態air_conditioner1 bitinteger
ニュートラル信号neutral1 bitinteger
リターダ作動retarder1 bitinteger
ABS作動abs1 bitinteger
ヒーター作動heater1 bitinteger
クラッチ状態cluth1 bitinteger
  • 信号状態は signal マップ内
フィールドJSON キー名値の型JSON 内の型
ロービーム信号low_beam1 bitinteger
ハイビーム信号high_beam1 bitinteger

例:

json
{
  "header": {
    "msg_id": 1,
    "encrypt": 0,
    "len": VAL,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "alarm": VAL,
    "status": VAL,
    "latitude": VAL,
    "longitude": VAL,
    "altitude": VAL,
    "speed": VAL,
    "direction": VAL,
    "time": VAL,
    "extra": {
      "mileage": VAL,
      "fuel_unit": VAL,
      "speed": VAL,
      "alarm_id": VAL,
      "overspeed_alarm": {
        "type": VAL,
        "id": VAL
      },
      "in_out_alarm": {
        "type": VAL,
        "id": VAL,
        "direction": VAL
      },
      "path_time_alarm": {
        "id": VAL,
        "time": VAL,
        "result": VAL
      },
      "signal": {
        "low_beam": VAL,
        "high_beam": VAL
      },
      "right_turn": VAL,
      "left_turn": VAL,
      "brake": VAL,
      "reverse": VAL,
      "fog": VAL,
      "side_marker": VAL,
      "horn": VAL,
      "air_conditioner": VAL,
      "neutral": VAL,
      "retarder": VAL,
      "abs": VAL,
      "heater": VAL,
      "cluth": VAL,
      "io_status": {
        "deep_sleep": VAL,
        "sleep": VAL
      },
      "analog": {
        "ad0": VAL,
        "ad1": VAL
      }
    }
  }
}

位置情報照会 "msg_id": 33281 0x8201

空の JSON

位置情報照会応答 "msg_id": 513 0x0201

フィールドJSON キー名値の型JSON 内の型
応答シーケンスseqwordinteger
位置報告params-map

一時位置追跡制御 "msg_id": 33282 0x8202

フィールドJSON キー名値の型JSON 内の型
間隔(秒)periodwordinteger
追跡期間expirydwordinteger

手動警報確認メッセージ "msg_id": 33283 0x8203

フィールドJSON キー名値の型JSON 内の型
警報メッセージシーケンスseqwordinteger
手動警報タイプtypedwordinteger

テキストメッセージ送信 "msg_id": 33536 0x8300

フィールドJSON キー名値の型JSON 内の型
フラグflagbyteinteger
テキスト情報textstringstring

イベント設定 "msg_id": 33537 0x8301

フィールドJSON キー名値の型JSON 内の型
設定タイプtypebyteinteger
イベント総数lengthbyteinteger
イベントリストeventslistイベントのリスト [{"id": ID, "length": LEN, "content": CON}, ...]
イベントIDidbyteinteger
イベント長さlengthbyteinteger
イベント内容contentstringstring

イベント報告 "msg_id": 769 0x0301

フィールドJSON キー名値の型JSON 内の型
イベントIDidbyteinteger

質問送信 "msg_id": 33538 0x8302

フィールドJSON キー名値の型JSON 内の型
フラグflagbyteinteger
質問長さlengthbyteinteger
質問内容questionstringstring
回答候補リストanswerslist回答のリスト [{"id": ID, "len": LEN, "answer": ANS}, ...]
回答IDidbyteinteger
回答内容長さlenbyteinteger
回答内容answerstringstring

質問応答 "msg_id": 770 0x0302

フィールドJSON キー名値の型JSON 内の型
応答シーケンスseqwordinteger
回答IDidbyteinteger

情報サービスメニュー設定 "msg_id": 33539 0x8303

フィールドJSON キー名値の型JSON 内の型
設定タイプtypebyteinteger
情報項目総数lengthbyteinteger
情報項目リストmenuslistメニューのリスト
情報タイプtypebyteinteger
情報名長さlengthwordinteger
情報名infostringstring

情報サービス/キャンセル "msg_id": 771 0x0303

フィールドJSON キー名値の型JSON 内の型
情報タイプidbyteinteger
発信/キャンセルフラグflagbyteinteger

情報サービス "msg_id": 33540 0x8304

フィールドJSON キー名値の型JSON 内の型
情報タイプtypebyteinteger
情報長さlengthwordinteger
情報内容infostringstring

コールバック電話 "msg_id": 33792 0x8400

フィールドJSON キー名値の型JSON 内の型
フラグtypebyteinteger
電話番号phonestringstring

電話帳設定 "msg_id": 33793 0x8401

フィールドJSON キー名値の型JSON 内の型
設定タイプtypebyteinteger
連絡先総数lengthbyteinteger
連絡先項目contactslist連絡先のリスト
フラグtypebyteinteger
電話番号長さphone_lenbyteinteger
電話番号phonestringstring
連絡先名長さname_lenbyteinteger
連絡先名namestringstring

連絡先項目例

json
[{"type": TYPE, "phone_len": PH_LEN, "phone": PHONE, "name_len": NAME_LEN, "name": NAME}, ...]

車両制御 "msg_id": 34048 0x8500

フィールドJSON キー名値の型JSON 内の型
制御フラグflagbyteinteger

車両制御応答 "msg_id": 1280 0x0500

フィールドJSON キー名値の型JSON 内の型
応答シリアルseqwordinteger
位置報告本文locationmap位置情報のマップ

円形エリア設定 "msg_id": 34304 0x8600

フィールドJSON キー名値の型JSON 内の型
設定属性typebyteinteger
エリア総数lengthbyteinteger
エリア項目areaslistエリアのリスト
エリアIDiddwordinteger
エリアプロパティflagdwordinteger
中心緯度center_latitudedwordinteger
中心経度center_longitudedwordinteger
半径radiusdwordinteger
開始時刻start_timestringstring
終了時刻end_timestringstring
最大速度max_speedwordinteger
超速継続時間overspeed_durationbyteinteger

エリアリスト例

json
[{"id": ID,
  "flag": FLAG,
  "center_latitude": CEN_LAT,
  "center_longitude": CEN_LON,
  "radius": RADIUS,
  "start_time": START_TIME,
  "end_time": END_TIME,
  "max_speed": MAX_SPEED,
  "overspeed_duration": OVERSPEED_DURATION
  },
 ...
]

円形エリア削除 "msg_id": 34305 0x8601

フィールドJSON キー名値の型JSON 内の型
エリア数lengthbyteinteger
エリアIDリストidslistIDのリスト
エリアID 1~n-dwordinteger
json
[ID1, ID2, ...]

矩形エリア設定 "msg_id": 34306 0x8602

フィールドJSON キー名値の型JSON 内の型
設定属性typebyteinteger
エリア総数lengthbyteinteger
エリア項目areaslist矩形エリアのリスト
エリアIDiddwordinteger
エリアプロパティflagdwordinteger
左上緯度lt_latdwordinteger
左上経度lt_lngdwordinteger
右下緯度rb_latdwordinteger
右下経度rb_lngdwordinteger
開始時刻start_timestringstring
終了時刻end_timestringstring
最大速度max_speedwordinteger
超速継続時間overspeed_durationbyteinteger

矩形エリア削除 "msg_id": 34307 0x8603

フィールドJSON キー名値の型JSON 内の型
エリア数lengthbyteinteger
エリアIDリストidslistIDのリスト
エリアID 1~n-dwordinteger

多角形エリア設定 "msg_id": 34308 0x8604

フィールドJSON キー名値の型JSON 内の型
エリアIDiddwordinteger
エリアプロパティflagdwordinteger
開始時刻start_timestringstring
終了時刻end_timestringstring
最大速度max_speedwordinteger
超速継続時間overspeed_durationbyteinteger
頂点総数lengthwordinteger
頂点リストpointslist頂点のリスト
頂点緯度latdwordinteger
頂点経度lngdwordinteger

多角形エリア削除 "msg_id": 34309 0x8605

フィールドJSON キー名値の型JSON 内の型
エリア数lengthbyteinteger
エリアIDリストidslistIDのリスト
エリアID 1~n-dwordinteger

ルート設定 "msg_id": 34310 0x8606

フィールドJSON キー名値の型JSON 内の型
ルートIDiddwordinteger
ルートプロパティflagwordinteger
開始時刻start_timestringstring
終了時刻end_timestringstring
曲がり角総数lengthwordinteger
曲がり角項目pointslist頂点のリスト
曲がり角IDpoint_iddwordinteger
区間IDpath_iddwordinteger
曲がり角緯度point_latdwordinteger
曲がり角経度point_lngdwordinteger
区間幅widthbyteinteger
区間属性attribbyteinteger
区間走行超過閾値passedwordinteger
区間走行不足閾値uncoveredwordinteger
区間最大速度max_speedwordinteger
区間超速継続時間overspeed_durationbyteinteger

ルート削除 "msg_id": 34311 0x8607

フィールドJSON キー名値の型JSON 内の型
ルート数lengthbyteinteger
ルートIDリストidslistIDのリスト
ルートID-dwordinteger

運転記録データ収集コマンド "msg_id": 34560 0x8700

フィールドJSON キー名値の型JSON 内の型
コマンドcommandbyteinteger
データブロックparamstring(base64 encoded)string

運転記録データアップロード "msg_id": 1792 0x0700

フィールドJSON キー名値の型JSON 内の型
応答シリアル番号seqwordinteger
コマンドcommandbyteinteger
データブロックdatastring(base64 encoded)string

運転記録パラメータ下行コマンド "msg_id": 34561 0x8701

フィールドJSON キー名値の型JSON 内の型
コマンドcommandbyteinteger
データブロックparamstring(base64 encoded)string

電子運送状報告 "msg_id": 1793 0x0701

フィールドJSON キー名値の型JSON 内の型
電子運送状長さlengthdwordinteger
電子運送状内容datastring(base64 encoded)string

運転者身分情報アップロード要求 "msg_id": 34562 0x8702

空の JSON

運転者身分情報収集報告 "msg_id": 1794 0x0702

フィールドJSON キー名値の型JSON 内の型
状態statusbyteinteger
時刻timestringstring
ICカード読み取り結果ic_resultbyteinteger
運転者名driver_namestringstring
職業資格証明書コードcertificatestringstring
発行機関名organizationstringstring
証明書有効期限cert_expirystringstring

位置データ一括アップロード "msg_id": 1796 0x0704

フィールドJSON キー名値の型JSON 内の型
位置データタイプtypebyteinteger
データ項目数lengthwordinteger
位置報告データ項目locationlist位置情報のリスト

CANバスデータアップロード "msg_id": 1797 0x0705

フィールドJSON キー名値の型JSON 内の型
データ項目数lengthwordinteger
CANバスデータ受信時刻timebcd(5)integer
CANバスデータ項目can_datalistCANデータのリスト
CANバスチャネル番号channel1 bitinteger
フレームタイプframe_type1 bitinteger
データ収集方法data_method1 bitinteger
CANバスIDid29 bitsinteger
CANデータdatabinarystring(base64 encoded)

マルチメディアイベント情報アップロード "msg_id": 2048 0x0800

フィールドJSON キー名値の型JSON 内の型
マルチメディアデータIDiddwordinteger
マルチメディアタイプtypebyteinteger
マルチメディアエンコード形式formatbyteinteger
イベント項目コードeventbyteinteger
チャンネルIDchannelbyteinteger

マルチメディアデータアップロード "msg_id": 2049 0x0801

フィールドJSON キー名値の型JSON 内の型
マルチメディアIDiddwordinteger
マルチメディアタイプtypebyteinteger
マルチメディアエンコード形式formatbyteinteger
イベント項目コードeventbyteinteger
チャンネルIDchannelbyteinteger
位置報告locationbyte(28)map
マルチメディアデータパッケージmultimediabinarystring(base64 encoded)

マルチメディアデータアップロード応答 "msg_id": 34816 0x8800

フィールドJSON キー名値の型JSON 内の型
マルチメディアIDmm_iddwordinteger
再送パッケージ総数lengthbyteinteger
再送パッケージIDリストretx_idslist再送IDのリスト

即時カメラ撮影コマンド "msg_id": 34817 0x8801

フィールドJSON キー名値の型JSON 内の型
チャンネルIDchannel_idbyteinteger
撮影コマンドcommandwordinteger
間隔/録画時間periodwordinteger
保存フラグsavebyteinteger
解像度resolutionbyteinteger
画像/動画品質qualitybyteinteger
明るさbrightbyteinteger
コントラストcontrastbyteinteger
彩度saturatebyteinteger
色相chromaticitybyteinteger

即時カメラ撮影応答 "msg_id": 2053 0x0805

フィールドJSON キー名値の型JSON 内の型
応答シリアル番号seqwordinteger
結果resultbyteinteger
マルチメディアID数lengthwordinteger
マルチメディアIDリストidsbyte(4*length)integer

保存マルチメディアデータ取得 "msg_id": 34818 0x8802

フィールドJSON キー名値の型JSON 内の型
マルチメディアタイプbyte
チャンネルIDbyte
イベント項目コードbyte
開始時刻string
終了時刻string

保存マルチメディアデータ取得応答 "msg_id": 2050 0x0802

フィールドJSON キー名値の型JSON 内の型
応答シリアル番号seqwordinteger
マルチメディアデータ総数lengthwordinteger
検索結果項目resultlist検索結果のリスト
マルチメディアIDiddwordinteger
マルチメディアタイプtypebyteinteger
チャンネルIDchannelbyteinteger
イベント項目コードeventbyteinteger
位置報告locationbyte(28)map

保存マルチメディアデータアップロードコマンド "msg_id": 34819 0x8803

フィールドJSON キー名値の型JSON 内の型
マルチメディアタイプtypebyteinteger
チャンネルIDchannelbyteinteger
イベント項目コードeventbyteinteger
開始時刻start_timestringstring
終了時刻end_timestringstring
削除フラグdeletebyteinteger

音声録音開始コマンド "msg_id": 34820 0x8804

フィールドJSON キー名値の型JSON 内の型
録音コマンドcommandbyteinteger
録音時間timewordinteger
保存フラグsavebyteinteger
音声サンプリングレートratebyteinteger

単一保存マルチメディア項目取得アップロードコマンド "msg_id": 34821 0x8805

フィールドJSON キー名値の型JSON 内の型
マルチメディアIDiddwordinteger
削除フラグflagbyteinteger

下行データ送信 "msg_id": 35072 0x8900

フィールドJSON キー名値の型JSON 内の型
送信メッセージタイプtypebyteinteger
送信メッセージ内容databinarystring(base64 encoded)

上行データ送信 "msg_id": 2304 0x0900

フィールドJSON キー名値の型JSON 内の型
送信メッセージタイプtypebyteinteger
送信メッセージ内容databinarystring(base64 encoded)

データ圧縮報告 "msg_id": 2305 0x0901

フィールドJSON キー名値の型JSON 内の型
圧縮メッセージ長さlengthdwordinteger
圧縮メッセージ本文databinarystring(base64 encoded)

プラットフォームRSA公開鍵 "msg_id": 35328 0x8A00

フィールドJSON キー名値の型JSON 内の型
eedwordinteger
nnbyte(128)string(base64 encoded)

端末RSA公開鍵 "msg_id": 2560 0x0A00

フィールドJSON キー名値の型JSON 内の型
eedwordinteger
nnbyte(128)string(base64 encoded)

予約済み 0x8F00 ~ 0x8FFF

予約済み 0x0F00 ~ 0x0FFF