アメダス検索API
【概要】
気象庁が運用しているアメダス(地域気象観測システム)は全国に約1300カ所設置されています。
本サービスは、入力された位置情報から最寄りのアメダスを探すことができます。
最寄りのアメダスの観測所番号など、アメダス関連の情報を返すAPIです。
以下の説明をよく読んでご利用下さい。
(詳細についてはブログも見てください。)
【取得できる情報について】
最寄りのアメダスは指定した緯度経度を中心とした、アメダスの種類ごとに設定された範囲から探します。範囲内にアメダスが無い場合は空のレスポンスがあります。
大概な最寄り検索ですので、微妙な位置関係にある場合など、実際の最寄りと異なる場合があります。
基となるアメダスのデータは気象庁より取得したものを利用しています。
・データ取得元ページ 地域気象観測システム(アメダス) - 気象庁
このAPIで取得した観測所番号は当サイトにて運用している1時間降水量APIに利用できます。
【使い方】
この場では軽く使い方の説明をします。
[エンドポイント]
https://mgpn.org/api/weather/amedas.cgi
[パラメータ]
lon = 東経[度](必須):検索の基準となる経度。指定可能な値:東経121°~155°
lat = 北緯[度](必須):検索の基準となる緯度。指定可能な値:北緯20°~46°
type = アメダスの種類(省略可):2~5で指定。省略時は2。
format = 応答形式(省略可):省略時はJSON。xmlと指定するとXML形式で応答します。
[応答内容]
status = 200:成功 400:パラメータ不正 500:内部エラー
id = 観測所番号
name = 観測所名(漢字)
yomi = 観測所名(半角カタカナ)
latitude = 観測の緯度[度](北緯)
longitude = 観測の経度[度](東経)
type = アメダスの種類
エンドポイントに対してパラメータを適宜付与し、GETメソッドにてリクエストしてください。
[サンプル]
東京スカイツリー(東経139.810833度 北緯35.710139度)有線ロボット雨量計以上 XML形式
【アメダスの種類について】
以下の表の通りアメダスは観測装置ごとに種類があります。
種類 | 観測種目 | typeで指定する数字 | 検索範囲 |
地上気象観測装置 | 降水量、気温、風向、風速、日照時間(一部の観測所を除く)、積雪の深さ(一部の観測所に限る) | 5 | 約40km圏内 |
有線ロボット気象計 | 降水量、気温、風向、風速、日照時間 | 4 | 約21km圏内 |
有線ロボット気象計 | 降水量、気温、風向、風速 | 3 | 約21km圏内 |
有線ロボット雨量計 | 降水量 | 2 | 約17km圏内 |
有線ロボット積雪深計 | 積雪の深さ | (指定できません) |
例えばtype=3と指定した場合、3・4・5に該当するアメダスの中で最も近いものを返します。
【免責事項】
本サービスは予告なく変更、中断、終了する場合があります。
本サービスでは正確な情報を提供するように注意を払っておりますが、これについて保証しません。
本サービスを生命や財産にかかわる、重要なシステムに利用する事を禁止します。
本サービスを利用した事により損害や不利益が生じても管理者・製作者は一切責任を負いません。
本サービスが利用できなかった事により損害や不利益が生じても管理者・製作者は一切責任を負いません。
以上に同意の上、ご利用ください。
【APIの利用について】
サーバーに過剰な負荷をかけないように注意してね。
詳細はAPIトップページを参照してください。
【更新履歴】
2018/02/11 テスト公開
2020/11/23 ドメイン変更
【問い合わせ】
本サービスに関するお問い合わせはこちらからお願い致します。