Soracom

Users

ドキュメント
Home ドキュメント SORACOM Flux アクションリファレンス

簡易物体検知アクション

簡易物体検知アクションは、静止画に写っている物体を簡易的に検知して、物体に関する情報を、次のチャネルに送信します。

検出対象の物体クラスを指定すると、指定した物体クラスのみを検知します。指定しない場合は、対応するすべての物体クラス を検知します。

以下の物体クラスは、検知した数が出力データに含まれます。

  • バス
  • トラック

上記以外の物体クラスは、画像内の位置情報、信頼スコアとともに、検知した物体を返します。詳細は、簡易物体検知アクションの出力データ を参照してください。

チャネルにアクションを追加する手順については、チャネルにアクションを追加する (処理を分岐する) を参照してください。

簡易物体検知アクションの設定

ここでは、簡易物体検知アクションの CONFIG について説明します。そのほかの項目については、アクションリファレンスの 「新しいアクションを作成」画面 を参照してください。

CONFIG

簡易物体検知アクションの動作を設定します。

項目説明
[画像 URL]

簡易物体検知の対象の静止画の URL を指定します。たとえば、この Flux アプリで、SORACOM Harvest Files イベントソースを利用する場合は、${event.payload.presignedUrls.get} を指定すると、SORACOM Harvest Files にアップロードしたファイルに対して、簡易物体検知が実行されます。

  • この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.temp}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp}) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。
[検出対象物体クラス]

検出対象の物体クラスを指定します。指定した物体クラスが画像内に検出されたかどうかを判定します。選択されていない場合、すべての物体クラスが検出対象となります。複数の物体クラスを指定できます。

指定できる物体クラスについては、対応する物体クラス を参照してください。

検出対象物体クラスの設定 検出対象物体クラスの設定

対応する物体クラス

簡易物体検知アクションが対応する物体クラスは以下のとおりです。

対応する物体クラスの一覧を表示する
物体クラス名ID
person
自転車bicycle
car
バイクmotorcycle
飛行機airplane
バスbus
電車train
トラックtruck
ボートboat
信号機traffic light
消火栓fire hydrant
停止標識stop sign
パーキングメーターparking meter
ベンチbench
bird
cat
dog
horse
sheep
cow
elephant
bear
シマウマzebra
キリンgiraffe
リュックbackpack
umbrella
ハンドバッグhandbag
ネクタイtie
スーツケースsuitcase
フリスビーfrisbee
スキー板skis
スノーボードsnowboard
ボールsports ball
kite
バットbaseball bat
グローブbaseball glove
スケートボードskateboard
サーフボードsurfboard
テニスラケットtennis racket
ボトルbottle
ワイングラスwine glass
カップcup
フォークfork
ナイフknife
スプーンspoon
ボウルbowl
バナナbanana
リンゴapple
サンドイッチsandwich
オレンジorange
ブロッコリーbroccoli
ニンジンcarrot
ホットドッグhot dog
ピザpizza
ドーナツdonut
ケーキcake
椅子chair
ソファcouch
鉢植えpotted plant
ベッドbed
ダイニングテーブルdining table
トイレtoilet
テレビtv
ノートパソコンlaptop
マウスmouse
リモコンremote
キーボードkeyboard
携帯電話cell phone
電子レンジmicrowave
オーブンoven
トースターtoaster
シンクsink
冷蔵庫refrigerator
book
時計clock
花瓶vase
はさみscissors
テディベアteddy bear
ヘアドライヤーhair drier
歯ブラシtoothbrush

簡易物体検知アクションの出力データ

簡易物体検知アクションの出力データは以下のとおりです。

例:

{
  "person": 1,
  "car": 0,
  "bus": 0,
  "truck": 0,
  "cat": 0,
  "dog": 0,
  "objects": [
    {
      "location": [
        0.42561606168746946,
        0.3883926073710124,
        0.5880238652229309,
        0.8953371047973633
      ],
      "score": 0.6473677158355713,
      "label": "person",
      "ts": "2024-06-17T05:28:24Z"
    },
    {
      "location": [
        0.3454461991786957,
        0.6387763867775599,
        0.39976382851600645,
        0.739234521985054
      ],
      "score": 0.5285048484802246,
      "label": "cup",
      "ts": "2024-06-17T05:28:24Z"
    }
  ]
}
項目説明
person検知した人の数。
car検知した車の数。
bus検知したバスの数。
truck検知したトラックの数。
cat検知した猫の数。
dog検知した犬の数。
objects[]簡易物体検知アクションが検知した物体の情報。
objects[].location検知した物体の静止画内の位置情報。
objects[].score検知した物体の正確さを示すスコア。
objects[].label検知した物体。
objects[].ts検知した日時。

検出対象物体クラスを指定した場合の出力データ

検出対象物体クラスにトラック (truck) を指定した場合の出力データの例です。

トラックを検知した場合:

{
  "person": 0,
  "car": 0,
  "bus": 0,
  "truck": 1,
  "cat": 0,
  "dog": 0,
  "objects": [
    {
      "location": [
        0.04083414,
        0.21190794,
        0.4107799,
        0.8861815
      ],
      "score": 0.91171336,
      "label": "truck",
      "ts": "2026-03-16T23:39:13Z"
    }
  ]
}

トラックを検知しなかった場合:

{
  "person": 0,
  "car": 0,
  "bus": 0,
  "truck": 0,
  "cat": 0,
  "dog": 0,
  "objects": []
}