バイオウェザー予報検索

/weather_bio [GET]

基本情報

概要

指定された地点のバイオウェザー予報を検索します。
インフルエンザや紫外線など、26項目の指標をご用意しています。
予報は一日ごとと一週間ごとを切り替えられます。

禁止事項

データ提供元より許諾されていないため、本APIはバイオウェザー情報だけを
検索するようなコンテンツでの利用はお控えください。

URL

https://{HOST}/{CID}/v1/weather_bio

※RapidAPIでは提供しておりません

出力形式

  • JSON

対応言語

  • ja

出力順

  • 時刻昇順

 

本 API を使用する際は、 利用規約の表示について にある規約を含めてください。

データの保存期間について

日ごと:当日と翌日のデータ(正確には50時間分程度)が保存されています。
週ごと : 当日から7日分のデータが保存されています。

データの保存期間に関する注意

データ提供元からのデータ配信タイミングの都合上、0時~6時の間に週間予報を取得した場合は当日~6日分のデータが返却されます。

パラメータ

パラメータ名 必須 概要 型名 デフォルト値 上下限/選択値 備考
coord 緯度経度 カンマ区切りの数値(緯度, 経度)
forecast 予報の出力期間 文字列 daily:日ごと
weekly:週ごと
kinds 出力項目 文字列 出力したいバイオウェザー予報の種類を指定できます。
詳細は出力項目一覧をご覧ください。
ピリオド区切りで複数指定できます
start_time 開始時刻 文字列(日付時刻)
YYYY-MM-DDThh:mm:ss
現在時刻 「forecast=daily」の時のみ有効
過去の日時は指定できません
term_hour 取得する予報期間 数値 24(時間) 最小値:1
最大値:48
「forecast=daily」の時のみ有効
datum 緯度経度の測地系 文字列 wgs84 wgs84:世界測地系
tokyo:旧日本測地系
coord_unit 出力データに含まれる緯度経度の単位 文字列 degree degree:度表記の10進法
millisec:ミリ秒表記

出力項目一覧について

以下に出力項目の一覧を示します。パラメータ名称をAPIで指定することで出力することができます。
各項目には対応forecast、対象月が設定されているものがあります。
対応していないforecastを指定する、もしくは対象外の月にリクエストするとパラメータ不正のエラーとなりますので、ご注意ください。
例:インフルエンザをforecast=dailyで指定するとエラーとなる

出力項目一覧

パラメータ名称 名称 対応forecast 対象月 ランク段階
influenza インフルエンザ weekly 通年 0〜3
herpangina ヘルパンギーナ weekly 通年 0〜3
hfmd 手足口病 weekly 通年 0〜3
myocardial_infarction 心筋梗塞 weekly 通年 0〜3
cerebral_hemorrhage 脳出血 weekly 通年 0〜3
cerebral_infarction 脳梗塞 weekly 通年 0〜3
childhood_asthma 小児喘息 weekly 通年 0〜3
arthralgia 関節痛 weekly 通年 0〜3
uv 紫外線 daily / weekly 通年 0〜3
tropical_night 熱帯夜 daily / weekly 通年 0〜2
umbrella daily / weekly 通年 0〜2
washing 洗濯 daily / weekly 通年 0〜2
skin お肌 daily / weekly 通年 0〜4
cold_sensitivity 冷え性 daily / weekly 通年 0〜2
stress 体感ストレス daily / weekly 通年 0〜2
hyperthrmia 熱中症 daily / weekly 通年 0〜3
road_surface_temperature 路面温度 daily 通年 0〜4
stroll お散歩 daily 通年 0〜100
clothes 服装 daily / weekly 通年 1〜14
dry_skin 乾燥肌 daily / weekly 1〜3月 / 10〜12月 0〜3
migraine 偏頭痛 daily / weekly 9〜10月 0〜3
depressed うつ気分 weekly 通年 0〜3
cozily 快適 daily / weekly 通年 0〜4
lost_article 忘れ物 daily / weekly 通年 0〜2
traffic_accident 交通事故 daily / weekly 通年 0〜2
beer ビール weekly 7〜9月 0〜3

対象外の月のデータが出力される場合について

対象月から対象外の月へ跨ぐ場合、対象外の月の結果が併せて出力される場合がありますが、
対象外の月のデータは、精度が担保されておらず利用非推奨となりますのであらかじめご了承ください。
例:
  パラメータ:forecast=weekly&kinds=beer(対象月:7〜9月)
  9/25にリクエストした場合、
  レスポンスには9/25~10/1までの結果が出力されるが、10/1のデータの利用は非推奨

パラメータ構成例

  • 東京都新宿区近辺にて、インフルエンザと乾燥肌の週間予報を取得
/weather_bio?coord=35.691468,139.70353&forecast=weekly&kinds=influenza.dry_skin

レスポンス

名称 レスポンス名 型名 配列 説明
バイオウェザー予報情報 items BioWeatherItemオブジェクト
単位情報 unit Unitオブジェクト 出力される単位の情報

BioWeatherItemオブジェクト

名称 レスポンス名 型名 配列 説明
観測地点 observatory BioWeatherObservatoryオブジェクト
リクエストされた緯度経度 request_coord Coordinateオブジェクト
バイオウェザー情報 bio_weather BioWeatherオブジェクト データがない場合、空の配列が返却されます

BioWeatherObservatoryオブジェクト

名称 レスポンス名 型名 配列 説明
観測地点の名称 name 文字列
観測地点の緯度経度 coord Coordinateオブジェクト

観測地点の緯度経度について

リクエストされた緯度経度から最も近い観測所の予報を返却するため、指定された緯度経度の住所と返却される住所が異なる場合があります

Coordinateオブジェクト

名称 レスポンス名 型名 配列 説明
緯度 lat 数値
経度 lon 数値

BioWeatherオブジェクト

名称 レスポンス名 型名 配列 説明
リクエストした出力項目 kind 文字列
項目名称 name 文字列
種別 type 文字列
予報情報 forecasts BioWeatherForecastオブジェクト

BioWeatherForecastオブジェクト

名称 レスポンス名 型名 配列 説明
ランク rank 数値 出力項目によりランクの段階数が異なります。出力項目一覧を参考にしてください。
ランク名称 name 文字列 出力項目によりランク名称は異なります。
詳細情報 detail 文字列 forecast=weekly の場合のみ出力
データがある場合のみ出力
日時 date 文字列

Unitオブジェクト

名称 レスポンス名 型名 配列 説明
測地系 datum 文字列
緯度経度の出力形式 coord_unit 文字列

レスポンス例(パラメータ:coord=35.691468,139.70353&kinds=influenza.dry_skin&forecast=weekly 2022/2/21にリクエストした場合)

{
    "items": [
        {
            "observatory": {
                "name": "新宿区",
                "coord": {
                    "lat": 35.697076,
                    "lon": 139.70032
                }
            },
            "request_coord": {
                "lat": 35.691468,
                "lon": 139.70353
            },
            "bio_weather": [
                {
                    "kind": "influenza",
                    "name": "インフルエンザ",
                    "type": "健康",
                    "forecasts": [
                        {
                            "rank": 2,
                            "name": "警戒",
                            "detail": "6 時間以内での空気中のウイルス生存率は約 20%です。かぜ・インフルエンザにかかりやすい気象状況ですので注意しましょう。外出後の手洗いやうがいはもちろん、人混みをさけるなど注意してください。",
                            "date": "2022-02-21T00:00:00+09:00"
                        },
                        {
                            "rank": 2,
                            "name": "警戒",
                            "detail": "6 時間以内での空気中のウイルス生存率は約 20%です。かぜ・インフルエンザにかかりやすい気象状況ですので注意しましょう。外出後の手洗いやうがいはもちろん、人混みをさけるなど注意してください。",
                            "date": "2022-02-22T00:00:00+09:00"
                        },
                        {
                            "rank": 2,
                            "name": "警戒",
                            "detail": "6 時間以内での空気中のウイルス生存率は約 20%です。かぜ・インフルエンザにかかりやすい気象状況ですので注意しましょう。外出後の手洗いやうがいはもちろん、人混みをさけるなど注意してください。",
                            "date": "2022-02-23T00:00:00+09:00"
                        },
                        {
                            "rank": 2,
                            "name": "警戒",
                            "detail": "6 時間以内での空気中のウイルス生存率は約 20%です。かぜ・インフルエンザにかかりやすい気象状況ですので注意しましょう。外出後の手洗いやうがいはもちろん、人混みをさけるなど注意してください。",
                            "date": "2022-02-24T00:00:00+09:00"
                        },
                        {
                            "rank": 2,
                            "name": "警戒",
                            "detail": "6 時間以内での空気中のウイルス生存率は約 20%です。かぜ・インフルエンザにかかりやすい気象状況ですので注意しましょう。外出後の手洗いやうがいはもちろん、人混みをさけるなど注意してください。",
                            "date": "2022-02-25T00:00:00+09:00"
                        },
                        {
                            "rank": 1,
                            "name": "注意",
                            "detail": "6 時間以内での空気中のウイルス生存率は約 5%です。かぜ・インフルエンザにかかりにくい気象状況ですが安心は禁物です。外出後の手洗いやうがいは日常的に行いましょう。",
                            "date": "2022-02-26T00:00:00+09:00"
                        },
                        {
                            "rank": 1,
                            "name": "注意",
                            "detail": "6 時間以内での空気中のウイルス生存率は約 5%です。かぜ・インフルエンザにかかりにくい気象状況ですが安心は禁物です。外出後の手洗いやうがいは日常的に行いましょう。",
                            "date": "2022-02-27T00:00:00+09:00"
                        }
                    ]
                },
                {
                    "kind": "dry_skin",
                    "name": "乾燥肌",
                    "type": "健康",
                    "forecasts": [
                        {
                            "rank": 3,
                            "name": "スーパー警戒",
                            "detail": "肌水分が非常に減少する気象条件ですので、乾燥肌に十分警戒してください。強風下など、外気に長時間肌をさらしたりすることのないよう気をつけましょう。",
                            "date": "2022-02-21T00:00:00+09:00"
                        },
                        {
                            "rank": 3,
                            "name": "スーパー警戒",
                            "detail": "肌水分が非常に減少する気象条件ですので、乾燥肌に十分警戒してください。強風下など、外気に長時間肌をさらしたりすることのないよう気をつけましょう。",
                            "date": "2022-02-22T00:00:00+09:00"
                        },
                        {
                            "rank": 3,
                            "name": "スーパー警戒",
                            "detail": "肌水分が非常に減少する気象条件ですので、乾燥肌に十分警戒してください。強風下など、外気に長時間肌をさらしたりすることのないよう気をつけましょう。",
                            "date": "2022-02-23T00:00:00+09:00"
                        },
                        {
                            "rank": 3,
                            "name": "スーパー警戒",
                            "detail": "肌水分が非常に減少する気象条件ですので、乾燥肌に十分警戒してください。強風下など、外気に長時間肌をさらしたりすることのないよう気をつけましょう。",
                            "date": "2022-02-24T00:00:00+09:00"
                        },
                        {
                            "rank": 2,
                            "name": "警戒",
                            "detail": "肌水分が減少する気象条件ですので、乾燥肌に警戒してください。乾燥しやすい方は、保湿クリームや化粧水等を用いたスキンケアが効果的です。",
                            "date": "2022-02-25T00:00:00+09:00"
                        },
                        {
                            "rank": 1,
                            "name": "注意",
                            "detail": "肌水分がやや減少する気象条件ですので、乾燥肌に注意してください。洗いすぎなどによる皮脂成分の過剰な流出にも気を付けましょう。",
                            "date": "2022-02-26T00:00:00+09:00"
                        },
                        {
                            "rank": 2,
                            "name": "警戒",
                            "detail": "肌水分が減少する気象条件ですので、乾燥肌に警戒してください。乾燥しやすい方は、保湿クリームや化粧水等を用いたスキンケアが効果的です。",
                            "date": "2022-02-27T00:00:00+09:00"
                        }
                    ]
                }
            ]
        }
    ],
    "unit": {
        "datum": "wgs84",
        "coord_unit": "degree"
    }
}