Label detection App with Soracom Cloud Camera Service and Amazon Rekognition

NOTE: for English, please check English README

Soracom Cloud Camera Service (ソラカメ) の画像を SORACOM API で取得し、Amazon Rekognition で特定の label を検出し、結果を LINE Notify で通知するアプリケーションです。AWS Serverless Application Model (SAM) テンプレートを用いてデプロイできます。

デフォルトで 1 分ごとに実行されるので注意してください。

注意

このリポジトリにあるスクリプトは、あくまで例であり、動作を保証するものではありません。また、このスクリプトの内容は、商用利用を目的としたものではありません。ご自身の責任においてご利用ください。

構成

1. Amazon EventBridge で定期的に AWS Lambda を呼び出す
2. ソラカメ API で過去 1 分のイベント一覧を取得
3. イベント発生時の静止画像をダウンロード
4. 静止画像を Amazon Rekognition でラベリング
5. ラベリングした結果を LINE Notify で通知

利用手順

以下の手順で利用できます。

事前準備

アカウントや環境を準備してください。

1. Soracom Cloud Camera Service 対応のカメラを用意する (API の利用にはライセンスの契約も必要です)
2. LINE Notify をセットアップする
3. AWS アカウントを用意する
4. SORACOM SAM ユーザー の認証情報 (認証キー ID、認証キー) を準備する
5. AWS Serverless Application Model (SAM) をセットアップする

アプリケーションのデプロイ

1. sora-cam-label-detection-with-rekognition のデプロイのため、必要な環境変数を準備します。
   • soracomAuthKeyId: SORACOM SAM ユーザーの認証キー ID
   • soracomAuthKey: SORACOM SAM ユーザーの認証キー
   • deviceId: ソラカメ対応カメラのデバイス ID
   • lineNotifyToken: LINE Notify のトークン
   • rekognitionRegion: Amazon Rekognition のリージョン
   • targetLabelName: 検知したいラベルの名前
   • targetConfidence: この信頼度以上の場合にラベルを検知します
2. sora-cam-label-detection-with-rekognition をビルド・デプロイします
   • sam build sam deploy --guided --capabilities CAPABILITY_NAMED_IAM を用います

NOTE: sam build に PythonPipBuilder:ResolveDependencies のエラーで失敗する場合、pip install wheel または pip3 install wheel を実行してから再度試してください。

NOTE: CloudShell から実行する場合、CloudShell へ Python 3.9 をインストールしてください。以下の手順でビルド・デプロイできます。

script/cloudshell_install_python39.sh
python3.9 -m venv .venv
source .venv/bin/activate
pip install wheel
sam build
sam deploy --guided --capabilities CAPABILITY_NAMED_IAM

アプリケーションの削除

SAM でデプロイしたアプリケーションは sam delete コマンド、または AWS コンソールの CloudFormation メニューから削除できます。