夜虫指数

DATA SOURCES

データソース

気象予報データは Open-Meteo、月条件は SunCalc を使って計算しています。

気象データ

Open-Meteo の hourly forecast から、対象日の夜間と直近雨量判定に必要な前日分を取得します。 風速は m/s 指定で取得し、画面でも m/s として表示します。取得した条件は、スコアが最も高い代表時間帯の値として表示します。 Open-Meteo への取得は 1 時間キャッシュします。

  • temperature_2m: 気温、総合スコア、甲虫補正に使用
  • relative_humidity_2m: 湿度、総合スコアと理由表示に使用
  • precipitation: 観察時間帯の雨による減点に使用
  • wind_speed_10m / wind_gusts_10m: 風と突風の評価に使用
  • cloud_cover: 月明かりの見え方の補正に使用

月条件

SunCalc で代表時間帯の月条件を計算します。スコアでは、月が地平線より上にあり、明るく、雲が少ない場合に月明かりの影響を強く見ます。

  • 月の明るさ: 月明かりの影響判定に使用
  • 月高度: 月が見える位置にあるかの判定に使用
  • 月相: 取得条件として表示

エリアデータ

エリアは 20km 程度の広域単位で定義し、公開レスポンスには正確な緯度経度を返しません。内部では気象予報と月条件の計算に代表座標を使います。

  • 月別の季節係数: 時期による活動量の補正
  • エリア別の季節スコア: エリアごとの季節適性の補正
  • 生息環境スコア: 広域環境による補正
  • 代表座標: API や画面には表示しない内部計算用の値

公開データの利用

夜虫指数の画面と公開 API で表示される指数データを利用する場合は、出典として「夜虫指数」または yorumushi.com を明記してください。具体的な観察地点、街灯、採集地、生息地、希少種のリアルタイム出現情報を推定または公開する目的での利用は避けてください。

fallback

Open-Meteo の取得に失敗した場合は、画面と API を落とさないためにアプリ内の fallback weather を使用します。fallback は表示継続用で、精度評価には使いません。Open-Meteo の障害、API の利用上限、ネットワークエラーが発生している間は、実際の気象予報に基づく指数として正しく動作しない可能性があります。