HA FlightRadar24 低空飛行機アナウンサー
概要
このリポジトリは「FlightRadar24 Low-Flying Plane Announcer」と題されたHome Assistant(HA)用のオートメーション設定を提供します。主な目的は、FlightRadar24の航空機データを利用して自宅上空を低空で通過する機体を検知し、AI生成の音声(TTS等)でユーザーに通知することです。low-flight-announcer.yamlというYAMLファイルに自動化ロジックがまとめられており、閾値(高度・水平距離)や通知対象の絞り込み、再通知の抑制などを設定可能。軽量で導入しやすく、既存のHome Assistant環境に追加してすぐに試せる設計になっています。
リポジトリの統計情報
- スター数: 12
- フォーク数: 0
- ウォッチャー数: 12
- コミット数: 3
- ファイル数: 2
- メインの言語: 未指定
主な特徴
- FlightRadar24の機体情報をトリガーにして低空飛行を検出し自動でアナウンスする。
- AI生成音声(TTS)を利用した可聴通知をHome Assistantのメディアプレイヤーへ配信。
- YAMLベースの設定で閾値(高度・距離)や再通知間隔を容易にカスタマイズ可能。
- 軽量で既存のHome Assistantセットアップに簡単に組み込める構成。
技術的なポイント
このプロジェクトはHome Assistantの自動化機能と外部データ(FlightRadar24)の連携を軸に設計されています。一般的な実装フローとしては、FlightRadar24のデータをHome Assistant側で利用可能なセンサーに取り込み(Community integrationやWebhook、RESTful sensor等を想定)、該当センサーの状態変化をオートメーションのトリガーにします。検出ロジックはYAMLのテンプレート式で記述され、機体の高度(ft/m)や地上からの水平距離(km/m)を比較して「低空」と判断する閾値を基準に動作します。
通知部分はHome AssistantのTTSサービスまたは外部AI音声APIを呼び出して音声ファイルを生成し、media_player.play_mediaやtts.say等で再生する形が一般的です。本リポジトリ名からは「AI-generated voice notifications」とあるため、ElevenLabsやAmazon Polly、Google Cloud TTS等の外部合成サービスに接続する設計も想定できますが、ローカルTTS(espeak/ngrok経由でのOSSソリューション)を利用することでプライバシーを保ちつつ簡易導入できます。
設計上の注意点としては、FlightRadar24のデータ取得頻度とAPI制限、誤検知の抑制(同一機体に対する連続通知のデバウンス)、および高度や座標演算の精度確保があります。距離計算には緯度経度を用いた大円距離(ハーサイン距離)をテンプレートで実装するか、Home Assistantのゾーン機能を併用すると実用的です。また、都市部などで常時飛行機がいる環境では通知頻度が高くなりがちなので、時間帯フィルタやアクティブ時間の設定、同一機体の最小間隔を明確に定義することが推奨されます。
更に拡張として、機種タイプやフライトのフラグ(軍用機/民間機/ヘリコプター)でフィルタリングする、過去ログから特定の機体をホワイトリスト/ブラックリスト化する、または通知に含める情報(登録番号、コールサイン、推定高度)をテンプレートで柔軟にカスタマイズすることが可能です。運用面では外部TTS利用時のレイテンシ、費用対効果、プライバシー対応も考慮すべき技術的課題になります。
プロジェクトの構成
主要なファイルとディレクトリ:
- README.md: file
- low-flight-announcer.yaml: file
まとめ
Home Assistantに簡単追加できる、FlightRadar24連携の低空飛行通知自動化。実用性が高く拡張も容易。
リポジトリ情報:
- 名前: ha-flightradar24-announcer
- 説明: Home Assistant automation that announces low-flying aircraft overhead using FlightRadar24 data and AI-generated voice notifications
- スター数: 12
- 言語: null
- URL: https://github.com/LunaticKrave/ha-flightradar24-announcer
- オーナー: LunaticKrave
- アバター: https://avatars.githubusercontent.com/u/33677630?v=4
READMEの抜粋:
FlightRadar24 Low-Flying Plane Announcer
![GitHub issues](https://im…