詳細天気検索

API名: 
pptenki/mesh
概要: 

5kmメッシュ毎の詳細天気情報を取得します。

※この機能を利用するには別途契約が必要です。

URI: 

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

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/mesh?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6633583%2C139.7613555&timelater=3

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon - 緯度経度
緯度経度を指定します。
llboundsとの同時指定はできません。
latlon,llboundsのどちらも指定していない場合、エラーとなります。
llbounds - 緯度経度矩形範囲
緯度経度矩形範囲を指定します。
latlonとの同時指定はできません。
latlon,llboundsのどちらも指定していない場合、エラーとなります。
datetime   現在日時 日時
天気を取得する日時をYYYYMMDDhhの形式で指定します。
最大で指定できるのは現在時間から48時間後までです。
現在日時より過去の日時は指定できません。
timelater   8 検索範囲時間
指定日時(datetime)から天気を取得する時間(n時間分)を指定します。
1~49の範囲で指定可能です。
ただし、最大で取得できるのは現在時間から49時間分です。
datum   TOKYO 測地系
入出力緯度経度の測地系を指定します。

出力データ
出力フォーマット
{"status":{"code":"0000",
           "text":"OK"},
 "item":[{"area":{"sw":{"lat":35.65,
                        "lon":139.75},
                  "ne":{"lat":35.7,
                        "lon":139.8125}},
          "center":{"lat":35.675,
                    "lon":139.78125},
          "weatherData":[{"time":"201302181200",
                          "weather":{"code":"2",
                                     "text":"雨"},
                          "detailWeather":{"code":"300",
                                           "text":"雨"},
                          "temperature":4.9,
                          "wind":{"code":"1",
                                  "text":"上"},
                          "windVelocity":2.5,
                          "rainfall":0.7,
                          "uv":{"code":"1",
                                "text":"弱い"},
                          "lightning":{"code":"0",
                                       "text":"なし"},
                          "fog":{"code":"3",
                                 "text":"雨"}},...]
         }...]
}

キー名 データ型 説明
status       object ステータス情報が入ります。
  code     string ステータスコードが入ります。
説明
0000 正常終了
0001 タイムアウト発生またはデータサイズが
制限値を超えたため処理が中断された
  text     string ステータス内容に関するテキスト情報が入ります。
item       array 検索結果天気データの配列が入ります。
検索結果が0件の場合は空の配列となります。
  area     object 天気取得矩形範囲が入ります。
  center     object 天気取得中心の緯度経度が入ります。
  weatherData     array 天気データオブジェクトが入ります。
1時間毎の天気データの配列となります。
    time   string 予報に該当する日時(YYYYMMDDhhmm)が入ります。
    weather   object 気象情報が入ります。
データが存在しない場合はNULLが入ります。
      code string 気象情報コード(1桁)が入ります。
気象情報
0
1 曇り
2
4
      text string 気象情報が入ります。
    detailWeather   object 気象詳細情報が入ります。
データが存在しない場合はNULLが入ります。
      code string 気象詳細情報コード(3桁)が入ります。
      text string 気象詳細情報が入ります。
    temperature   number 気温(単位:℃)が入ります。
データが存在しない場合はNULLが入ります。
    wind   object 風向きが入ります。
データが存在しない場合はNULLが入ります。
      code string 風向きコードが入ります。
北を上とした風の方向を示します。
風向き
0 風なし
1
2 右上
3
4 右下
5
6 左下
7
8 左上
      text string 風向きが入ります。
    windVelocity   number 風速(単位:m/s)が入ります。
データが存在しない場合はNULLが入ります。
    rainfall   number 降水量(単位:mm/h)が入ります。
データが存在しない場合はNULLが入ります。
    uv   object UV情報が入ります。
データが存在しない場合はNULLが入ります。
      code string UV情報コードが入ります。
UV情報
0 なし
1 弱い
2 中程度
3 強い
4 非常に強い
5 極端に強い
      text string UV情報が入ります。
    lightning   object 落雷情報が入ります。
データが存在しない場合はNULLが入ります。
      code string 落雷情報コードが入ります。
落雷情報
0 なし
1 弱雷
2 中雷
3 強雷
      text string 落雷情報が入ります。
    fog   object 霧情報が入ります。
データが存在しない場合はNULLが入ります。
      code string 霧情報コードが入ります。
霧情報
0 無し
1 薄霧
2 濃霧
3
      text string 霧情報が入ります。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/mesh?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6633583%2C139.7613555&timelater=3

 

{"status":{"code":"0000",
           "text":"OK"},
 "item":[{"area":{"sw":{"lat":35.65,
                        "lon":139.75},
                  "ne":{"lat":35.7,
                        "lon":139.8125}},
          "center":{"lat":35.675,
                    "lon":139.78125},
          "weatherData":[{"time":"201302181200",
                          "weather":{"code":"2",
                                     "text":"雨"},
                          "detailWeather":{"code":"300",
                                           "text":"雨"},
                          "temperature":4.9,
                          "wind":{"code":"1",
                                  "text":"上"},
                          "windVelocity":2.5,
                          "rainfall":0.7,
                          "uv":{"code":"1",
                                "text":"弱い"},
                          "lightning":{"code":"0",
                                       "text":"なし"},
                          "fog":{"code":"3",
                                 "text":"雨"}},
                         {"time":"201302181300",
                          "weather":{"code":"2",
                                     "text":"雨"},
                          "detailWeather":{"code":"300",
                                           "text":"雨"},
                          "temperature":5.2,
                          "wind":{"code":"1",
                                  "text":"上"},
                          "windVelocity":1,
                          "rainfall":0.6,
                          "uv":{"code":"1",
                                "text":"弱い"},
                          "lightning":{"code":"0",
                                       "text":"なし"},
                          "fog":{"code":"3",
                                 "text":"雨"}},
                         {"time":"201302181400",
                          "weather":{"code":"2",
                                     "text":"雨"},
                          "detailWeather":{"code":"300",
                                           "text":"雨"},
                          "temperature":5.8,
                          "wind":{"code":"5",
                                  "text":"下"},
                          "windVelocity":2,
                          "rainfall":2.3,
                          "uv":{"code":"1",
                                "text":"弱い"},
                          "lightning":{"code":"0",
                                       "text":"なし"},
                          "fog":{"code":"3",
                                 "text":"雨"}}]}]}

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

{"status":{"code":"0000",
           "text":"OK"},
 "item":[]}