台風詳細検索

API名:

pptenki/typhoon

概要:

台風情報を取得します。現在発生している台風(5つまで)の詳細情報を取得します。

※現在、新規での利用受付を中止しております
※この機能を利用するには別途契約が必要です。

情報元について:
気象・防災情報元:株式会社東芝
このAPIが返却する上記情報は、情報元の提供規準に準拠します。

URI:

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/typhoon

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/typhoon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip

リクエストパラメータ

パラメータ	必須	デフォルト値	説明
datum		TOKYO	測地系出力緯度経度の測地系を指定します。

出力データ

出力フォーマット

{"item":[{"name":"台風３号（マンゴー）",
          "time":"201311152100",
          "areaClass":"不明",
          "intensityClass":"不明",
          "location":"フィリピンの東",
          "center":{"lat":8.8,
                    "lon":128.5},
          "direction":"北西",
          "speed":15,
          "pressure":1002,
          "windSpeed":18,
          "maxWindSpeed":50,
          "prediction":[{"time":"201311142100",
                         "kmlUri":"http://spd.pinten.jp/result/TYPHOON_XML/kml/TC1338/.../VPTW40_..._..._TSB_.....kml",
                         "labelInfo":[{"position":{"lat":11.9,
                                                   "lon":111},
                                       "time":"201311142100"}, ...]
                       }, ...]
         }, ...]
}

キー名

データ型

説明

item

array

検索結果の配列が入ります。
検索結果が0件の場合は空の配列となります。

name

string

台風名が入ります。
データが存在しない場合はNULLが設定されます。

time

string

気象庁発表日時(YYYYMMDDhhmm)が入ります。
データが存在しない場合はNULLが設定されます。

areaClass

string

大きさ階級が入ります。

大型

超大型

不明又は階級を報じない

NULL

intensityClass

string

強さ階級が入ります。

強い

非常に強い

猛烈な

不明又は階級を報じない

NULL

location

string

存在地域が入ります。
データが存在しない場合はNULLが設定されます。

center

object

中心位置の緯度経度が入ります。
データが存在しない場合はNULLが入ります。

direction

string

進行方向が入ります。
データが存在しない場合はNULLが入ります。

speed

number

速さ(単位:km/h)が入ります。
データが存在しない場合はNULLが入ります。

pressure

number

中心気圧(単位:hPa)が入ります。
データが存在しない場合はNULLが入ります。

windSpeed

number

中心付近の最大風速(単位:m/s)が入ります。
データが存在しない場合はNULLが入ります。

maxWindSpeed

number

最大瞬間風速(単位:m/s)が入ります。
データが存在しない場合はNULLが設定されます。

prediction

array

予測情報の配列が入ります。

time

string

予測の日時(YYYYMMDDhhmmss)が入ります。
データが存在しない場合はNULLが入ります。

kmlUri

string

kmlのパスが入ります。
データが存在しない場合はNULLが入ります。

labelInfo

array

予報円の外にラベル表示するための表示位置情報と日時情報の配列が入ります。
データが存在しない場合は空の配列が入ります。

position

object

表示位置情報の緯度経度が入ります。
データが存在しない場合はNULLが入ります。

time

string

表示日時情報(YYYYMMDDhhmm)が入ります。
データが存在しない場合はNULLが入ります。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/typhoon?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip

{"item":[{"name":"台風１１号（ウトア）",
          "time":"201308151850",
          "areaClass":"不明又は階級を報じない",
          "intensityClass":"不明又は階級を報じない",
          "location":"華南",
          "center":{"lat":24.1958917,
                    "lon":111.0004283},
          "direction":"北",
          "speed":15,
          "pressure":994,
          "windSpeed":18,
          "maxWindSpeed":25,
          "prediction":[{"time":"20130815180000",
                         "kmlUri":"http://spd.pinten.jp/result/TYPHOON_XML/kml/.../.....kml",
                         "labelInfo":[{"position":{"lat":24.1958917,
                                                   "lon":111.0004283},
                                       "time":"201308151800"}]},
                        {"time":"20130816180000",
                         "kmlUri":"http://spd.pinten.jp/result/TYPHOON_XML/kml/.../.....kml",
                         "labelInfo":[{"position":{"lat":24.1958917,
                                                   "lon":111.0004283},
                                       "time":"201308151800"},
                                      {"position":null,
                                       "time":"201308161800"}]}]},
         {"name":"台風１０号（マンクット）",
          "time":"201308080645",
          "areaClass":"不明又は階級を報じない",
          "intensityClass":"不明又は階級を報じない",
          "location":"ベトナム",
          "center":{"lat":20.095475,
                    "lon":104.8998789},
          "direction":"西北西",
          "speed":15,
          "pressure":998,
          "windSpeed":18,
          "maxWindSpeed":25,
          "prediction":[{"time":"20130808060000",
                         "kmlUri":"http://spd.pinten.jp/result/TYPHOON_XML/kml/.../.....kml",
                         "labelInfo":[{"position":{"lat":20.095475,
                                                   "lon":104.8998789},
                                       "time":"201308080600"}]},
                        {"time":"20130808180000",
                         "kmlUri":"http://spd.pinten.jp/result/TYPHOON_XML/kml/.../.....kml",
                         "labelInfo":[{"position":{"lat":20.0954753,
                                                   "lon":104.9476931},
                                       "time":"201308080600"},
                                      {"position":{"lat":21.2618531,
                                                   "lon":104.1079522},
                                       "time":"201308081800"}]},
                        {"time":"20130809060000",
                         "kmlUri":"http://spd.pinten.jp/result/TYPHOON_XML/kml/.../.....kml",
                         "labelInfo":[{"position":{"lat":20.0954753,
                                                   "lon":104.9476931},
                                       "time":"201308080600"},
                                      {"position":{"lat":21.2618531,
                                                   "lon":104.1079522},
                                       "time":"201308081800"},
                                      {"position":{"lat":22.2964269,
                                                   "lon":103.1172606},
                                       "time":"201308090600"}]}]}]}

[検索結果が0件の場合]

{"item":[]}