バイオウェザー予報検索
/weather_bio [GET]
基本情報
概要
指定された地点のバイオウェザー予報を検索します。
インフルエンザや紫外線など、26項目の指標をご用意しています。
予報は一日ごとと一週間ごとを切り替えられます。
※当APIをご利用の場合は、専用データ利用のオプション契約が別途必要となります
禁止事項
データ提供元より許諾されていないため、本APIはバイオウェザー情報だけを
検索するようなコンテンツでの利用はお控えください。
URL
https://{HOST}/{CID}/v1/weather_bio
※APIマーケットでは提供しておりません
出力形式
- JSON
対応言語
- ja
出力順
- 時刻昇順
本 API を使用する際は、 利用規約の表示について にある規約を含めてください。
データの保存期間について
日ごと：当日と翌日のデータ（正確には50時間分程度）が保存されています。
週ごと : 当日から７日分のデータが保存されています。
データの保存期間に関する注意
データ提供元からのデータ配信タイミングの都合上、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"
}
}