weather apiで「日ごと、1時間ごと」の天気データを取得
Lifesocketのweather api(天気予報API)とは、Webやスマートフォンのアプリケーション、システム開発など、さまざまなシーンで活用できる気象データを便利なAPI方式で提供する気象データサービスです。
リアルタイムで高精度な気象データは、一般的に入手が困難なだけでなく、加工や解析を独自に行うことも難しいのが特徴です。しかし、Lifesocketのweather api(天気予報API)を活用することで、手軽にそして簡単にさまざまな気象データをご利用いただけます。
Lifesocketのweather api(天気予報API)では、まずは無料のお試し利用も可能です。
本記事ではweather api(天気予報API)でどのようなことができるのか紹介いたします。また、weather api(天気予報API)の詳細な機能、レスポンス項目、サンプルについてもご紹介いたします。
最後までお読みいただくことにより、Lifesocket「天気予報取得API」の具体的な仕様への理解が深まる内容となっております。
この記事を参考に、ぜひLifesocketのweather api(天気予報API)を効果的にご活用ください。
目次[非表示]
- 1.ダウンロード:天気APIサービス概要資料
- 2.weather apiとは?
- 3.weather apiの特徴・できること
- 3.1.商用利用可
- 3.2.月額固定金額
- 3.3.30日間の無料トライアル
- 4.weather apiの実装事例、サンプル紹介
- 5.weather apiの概要
- 6.weather api(日ごと)機能の紹介
- 6.1.■weather apiの概要
- 6.2.■ピンポイントコードの指定のリクエスト
- 6.3.■緯度経度の指定のリクエスト
- 7.weather api(1日ごと)レスポンス項目一覧
- 8.weather api(日ごと)のサンプル
- 9.weather api(1時間ごと)機能の紹介
- 9.1.■天気予報取得APIの概要
- 9.2.■ピンポイントコードの指定のリクエスト
- 9.3.■緯度経度の指定のリクエスト
- 10.weather api(1時間ごと)レスポンス項目一覧
- 11.weather api(1時間ごと)のサンプル
- 12.weather apiの導入事例
- 12.1.●小売り業の販促担当者の課題例
- 12.2.●Lifesocketからの提案
- 13.weather apiの価格・プラン
- 13.1.■価格・プラン
ダウンロード:天気APIサービス概要資料
Lifesocketではweatherapi(天気予報API)を30日間お試しできる無料トライアル期間のあるプランをご用意しています。
日本全国で日々変動する天気の最新情報を組み込むためには、Lifesocketのweather api(天気予報API)のご利用が大変便利です。
weather apiとは?
Lifesocketのweather api(天気予報API)では、天気予報や生活指数情報(花粉、紫外線など)をセットにしたAPIをパッケージにしてご提供しています。さらにweather api(天気予報API)を月単位で利用でき、利用期間に応じて開始・終了が可能です。Lifesocketでは他にもラインナップはございますが、今回は「天気予報・生活指数取得API」についてご説明いたします。
下記が、Lifesocketのweather api(天気予報API)「天気予報・生活指数取得API」で提供している情報となります。
- 天気予報取得API(地点もしくは緯度経度指定)
- 日別天気予報
- 1時間毎天気予報
- 生活指数取得API(地点もしくは緯度経度指定)
- スギヒノキ花粉飛散指数
- 傘指数
- 洗濯指数
- 体感ストレス指数
- ビール指数
- 熱帯夜指数
- お肌指数
- 熱中症指数
- 紫外線指数
weather apiの特徴・できること
では、Lifesocketで提供しているweather apiの特徴を3つご紹介いたします。
-
商用利用可
- 商用利用が可能であるため、自社サービスに天気情報を組み込んでお客様に提供することが可能です。
-
月額固定金額
- Lifesocketでは月額固定金額でご利用いただくことが可能です。従量課金ではないため、毎月のリクエスト数を気にせずご利用いただくことが出来ます。(分間のリクエスト制限はございます。)
-
30日間の無料トライアル
- Lifesocketで提供しているweather apiを無料で30日間お試しいただけます。実装してみてから導入を検討したいという方は、まずは30日間無料トライアルでお試しください。
また、気象予報士も在籍しているため、天気に関する質問・相談も承っております。
※Lifesocketは株式会社エムティーアイ (東証第一部上場:9438)の提供サービスです。予報許可(許可第 206 号)を取得しております。
weather apiの実装事例、サンプル紹介
では、実際に実装したイメージをお伝えします。
下記画像は、日ごとの天気予報取得APIから各要素を取得して、週間天気として表にしたものです。このように、週間天気を自社のサイトやアプリに実装することが可能です。
レイアウトや天気情報の活用方法は他にもありますので、サービスにあった実装を行ってください。
Lifesocketのweather api(天気予報API)は、多くの企業様にご導入いただいております。こちらにそれぞれの事例の紹介がございますので、是非参考にしてください。
weather apiの概要
ここでは、Lifesocket weather apiで提供しております「天気予報・生活指数取得API」のうち、「天気予報取得API」に関する説明をいたします。「天気予報取得API」は日ごとの情報と1時間ごとの情報に分かれているので、まずは概要を説明いたします。機能、レスポンス、サンプルは日ごと、1時間ごと別にご紹介いたします。
- 指定したピンポイントもしくは緯度経度指定で天気予報を取得できます。
- 1分間の利用可能なアクセス数が設定されています。
(プレミアム、ビジネススタンダード:3,000回/分)
制限を超えた場合、次の1分間までアクセス回数上限エラー(E_AUTH_002)となります。
weather api(日ごと)機能の紹介
■weather apiの概要
- 最大10日間の日ごとの天気を取得できます。
例)ピンポイントコードで取得する方法
GET : https://www.life-socket.jp/api/v1/weather/{pinpointCode}
例)緯度経度で取得する方法
GET : https://www.life-socket.jp/api/v1/weather/location/{lat}/{lon
■ピンポイントコードの指定のリクエスト
パラメータ
パラメータ名 |
必須 |
デフォルト |
説明 |
---|---|---|---|
PinpointCode |
〇 |
- |
ピンポイントのコード |
days |
1 |
取得する日数(1:当日分 - 10:10日分) |
|
lang |
ja |
langパラメータについて。"ja"か"en"に設定することは任意です。 |
■緯度経度の指定のリクエスト
パラメータ
パラメータ名 |
必須 |
デフォルト |
説明 |
---|---|---|---|
lat - 緯度 |
〇 |
- |
パラメータlatは-90~90の範囲で指定してください。 |
lon - 経度 |
〇 |
- |
パラメータlonは-180~180の範囲で設定してください。 |
days |
1 |
取得する日数(1:当日分 - 10:10日分) |
|
lang |
ja |
langパラメーターについて。"ja"か"en"に設定することは任意です。 |
weather api(1日ごと)レスポンス項目一覧
下記表をご参照ください。
項目名 |
型 |
形式・サンプル |
説明 |
---|---|---|---|
AnnounceDatetime |
string |
"YYYY-MM-DDThh:mm:ss" |
発表日時 |
RegionCode |
string |
"XX" |
地方コード |
RegionName |
string |
"関東" |
地方名 |
PrefCode |
string |
"XX" |
都道府県コード |
PrefName |
string |
"茨城県" |
都道府県名 |
AreaCode |
string |
"XXXXX" |
地域コード |
AreaName |
string |
"南部" |
地域名 |
PinpointCode |
string |
"XXXXXXX" |
ピンポイントコード |
PinpointName |
string |
"取手市" |
ピンポイント名 |
Daily |
array |
日ごと天気リスト |
|
- DateTime |
string |
"YYYY-MM-DDThh:mm:ss" |
予報日付 |
- WeatherCode |
string |
"XXXXX" |
天気コード |
- WeatherName |
string |
"晴れ" |
天気名 |
- TemperatureMin |
number |
99 |
最低気温(℃) |
- TemperatureMax |
number |
99 |
最高気温(℃) |
- RainPercentage |
number |
99 |
降水確率(%) |
- RainQuantity |
number |
99.9 |
降水量(mm/h) |
- WindDirection |
string |
"XX" |
風向の数字情報 |
- WindDirectionName |
string |
"XX" |
風向名 |
- WindSpeed |
number |
99.9 |
風速(m/s) |
- Icon |
string |
"XX" |
天気コード番号 |
weather api(日ごと)のサンプル
取手市(ピンポイントコード:1082171)のリクエストです。
■リクエスト
https://www.life-socket.jp/api/v1/weather/1082171?days=1&lang=ja
■レスポンス
{
"AnnounceDatetime": "2018-12-06T12:13:15",
"RegionCode": "04",
"RegionName": "関東",
"PrefCode": "40",
"PrefName": "茨城県",
"AreaCode": "80020",
"AreaName": "南部",
"PinpointCode": "1082171",
"PinpointName": "取手市",
"Hourly": [
{
"DateTime": "2019-12-26",
"WeatherCode": "12903",
"WeatherName": "曇り夜遅くから雨",
"TemperatureMin": 1,
"TemperatureMax": 11,
"RainPercentage": 50,
"RainQuantity": 2.5,
"WindDirection": "03",
"WindDirectionName": "東北東",
"WindSpeed": 1.1,
"Icon": "cloudy_aftermidnight_rain_2014.png"
},
]
}
weather api(1時間ごと)機能の紹介
■天気予報取得APIの概要
- 最大52時間先までの1時間毎の天気を取得できます。
例)ピンポイントコードで取得する方法
GET : https://www.life-socket.jp/api/v1/weather/hourly/{pinpointCode}
例)緯度経度で取得する方法
GET : https://www.life-socket.jp/api/v1/weather/hourly/location/{lat}/{lon
■ピンポイントコードの指定のリクエスト
パラメータ
パラメータ名 |
必須 |
デフォルト |
説明 |
---|---|---|---|
PinpointCode |
〇 |
- |
ピンポイントのコード |
hours |
24 |
最小1、最大52 |
|
lang |
ja |
langパラメータについて。"ja"か"en"に設定することは任意です。 |
■緯度経度の指定のリクエスト
パラメータ
パラメータ名 |
必須 |
デフォルト |
説明 |
---|---|---|---|
lat - 緯度 |
〇 |
- |
パラメータlatは-90~90の範囲で指定してください。 |
lon - 経度 |
〇 |
- |
パラメータlonは-180~180の範囲で設定してください。 |
hours |
24 |
取得する時間(最小1,最大52) |
|
lang |
ja |
langパラメーターについて。"ja"か"en"に設定することは任意です。 |
weather api(1時間ごと)レスポンス項目一覧
下記表をご参照ください。
項目名 |
型 |
形式・サンプル |
説明 |
---|---|---|---|
AnnounceDatetime |
string |
"YYYY-MM-DDThh:mm:ss" |
発表日時 |
RegionCode |
string |
"XX" |
地方コード |
RegionName |
string |
"関東" |
地方名 |
PrefCode |
string |
"XX" |
都道府県コード |
PrefName |
string |
"茨城県" |
都道府県名 |
AreaCode |
string |
"XXXXX" |
地域コード |
AreaName |
string |
"南部" |
地域名 |
PinpointCode |
string |
"XXXXXXX" |
ピンポイントコード |
PinpointName |
string |
"取手市" |
ピンポイント名 |
Hourly |
string |
時間ごと天気リスト |
|
- DateTime |
string |
"YYYY-MM-DDThh:mm:ss" |
予報日付 |
- WeatherCode |
string |
"XXXXX" |
天気コード |
- WeatherName |
string |
"晴れ" |
天気名 |
- Temperature |
number |
99 |
気温(℃) |
- RainPercentage |
number |
99 |
降水確率(%) |
- RainQuantity |
number |
99.9 |
降水量(mm/h) |
- WindDirection |
string |
"XX" |
風向の数字情報 |
- WindDirectionName |
string |
"XX" |
風向名 |
- WindSpeed |
number |
99.9 |
風速(m/s) |
- Humidity |
number |
99 |
湿度(%) |
- SnowstormRisk |
number |
9 |
吹雪危険度指数 |
- SnowstormRiskName |
string |
"XX" |
吹雪危険度説明 |
- SnowfallQuantity |
number |
999 |
降雪量(cm) |
- Icon |
string |
"XX" |
天気コード番号 |
weather api(1時間ごと)のサンプル
取手市(ピンポイントコード:1082171)のリクエストです。
■リクエスト
https://www.life-socket.jp/api/v1/weather/hourly/1082171/?hours=1&lang=ja
■レスポンス
{
"AnnounceDatetime": "2018-12-06T12:13:15",
"RegionCode": "04",
"RegionName": "関東",
"PrefCode": "40",
"PrefName": "茨城県",
"AreaCode": "80020",
"AreaName": "南部",
"PinpointCode": "1082171",
"PinpointName": "取手市",
"Hourly": [
{
"DateTime": "2018-12-06T22:00:00",
"WeatherCode": "12000",
"WeatherName": "曇り",
"Temperature": 25,
"RainPercentage": 40,
"RainQuantity": 0.1,
"WindDirection": "05",
"WindDirectionName": "北北西"
"WindSpeed": 1.1
"Humidity": 96
"SnowstormRisk": 0,
"SnowstormRiskName": "なし",
"SnowfallQuantity": 0,
"Icon": "cloudy_2014.png"
},
]
}
weather apiの導入事例
Lifesocketではweather apiや生活指数情報(花粉、紫外線など)をセットにしたAPIをパッケージにしてご提供しています。Lifesocketのweather apiでは、当社の気象データの取り扱いノウハウと実績、予報許可(許可第206号)を取得した気象ナレッジで天気サービスの活用をお手伝いします。Lifesocket weather apiのサービス導入事例は『Lifesocket weather api導入事例』からご覧ください。また、天気予報や生活指数など、APIの詳細や仕様書はAPI詳細や仕様書は『天気予報API|天気予報、生活指数をAPIで提供』のページからご確認いただけます。
●小売り業の販促担当者の課題例
食品や日用品などの小売業では天気によって売れる商品が変わってくるので、天気に応じて自社サイトやアプリ内で効果的に商品PRをしたい。
●Lifesocketからの提案
その日の天気や特売情報を組み合わせて、お客様に商品PRを行う事ができます。
サービス上にも天気が表示させることで、さらに説得力のある情報発信ができます。
weather apiサービス表示のイメージ
weather apiの価格・プラン
weather apiを活用して、いつでも好きな時に最新の天気予報を呼び出すにしても、最初から有料サービスを契約するには不安があるので、まずは無料で試したい方も多いと思います。そこでLifesocketでは天気予報APIを30日間お試しできる無料トライアル期間のあるプランをご用意しています。
プラン詳細はこちらから>
■価格・プラン
weather api(天気予報API)は、22,000円/月(税込)からご利用可能です。
※プランには無料トライアルがついています。
その他、気象観測データや高解像度雨レーダーの提供もございます。Lifesocketサービス詳細をご希望の方はこちらをご覧ください。
終わり・あわせて読みたい記事紹介
本記事ではLifesocketのラインナップの一つである「weather api」について紹介しました。30日間の無料トライアル期間を設けておりますので、是非1度お試しください。活用方法の相談も承っておりますので、こちらからお気軽にご相談ください。