気象情報API

リクエストURL

XML
https://map.yahooapis.jp/weather/V1/place
JSONP
https://map.yahooapis.jp/weather/V1/place

目次


概要

  • 指定した緯度経度の雨の強さを取得できるAPIです。
  • 現在時刻の降水強度実測値から、60分後までの降水強度予測値を取得できます。

リクエストパラメーター一覧

本APIは、GETメソッドのみサポートしています。「Web APIの使い方#GETとは」をご参照ください。

パラメーター 説明
appid(必須) string Client ID(アプリケーションID)。詳細はこちらをご覧ください。
coordinates(必須) string 緯度経度です。
  • 経度・緯度の順番で、コンマ区切りで指定してください。
  • 世界測地系で指定してください。
  • 緯度経度を複数指定する場合は、半角スペースで区切ってください(最大10)。
output string 出力形式です。
  • xml - XML形式(デフォルト)
  • json - JSON形式
callback string JSONPとして出力する際のコールバック関数名を入力するためのパラメーター。UTF-8でエンコードした文字列を指定してください。
date string 日時を指定します(YYYYMMDDHHMI形式)。現在から2時間前までの日時を指定できます。
past integer 過去の降水強度実測値を取得する場合に指定できます。
  • 0 - 取得しない(デフォルト)
  • 1 - 1時間前までの降水強度実測値を取得する
  • 2 - 2時間前までの降水強度実測値を取得する
interval integer 取得間隔を指定してください。
  • 10 - 10分毎(デフォルト)
  • 5 - 5分毎

サンプルリクエストURL

東京都港区六本木付近の緯度:35.663613、経度:139.732293のリクエストです。

https://map.yahooapis.jp/weather/V1/place?coordinates=139.732293,35.663613&appid=<あなたのClient ID(アプリケーションID)>

API使用上の注意

URLの最大の長さは2048バイトです。
URLをエンコードして指定するパラメーターもありますが、エンコード後のURLの長さが2048バイトを超えないようにしてください。

レスポンスフィールド

フィールド 説明
YDF クエリーレスポンスのすべてを含みます。
 ResultInfo レスポンスのまとめ情報です。
  Count レスポンスに含まれるデータ件数です。
  Total 全データ件数です。
  Start 全データからの取得開始位置です。
  Status リクエストに処理結果を伝えるためのコードです。正常終了の場合、200を出力します。エラーの場合は、下記エラー項目を参照してください。
  Latency レスポンスを生成するのに要した時間です。
  Description データの説明です。詳細情報がある場合に表示されます。
 Feature 検索結果1件分のデータです。
  Id データの識別子です。
  Name データの名称です。
  Geometry 拠点の場所を表すGeometry要素です(世界測地系)。
   Type 図形種別です。
   Coordinates 座標情報です。
  Property 地点の詳細情報です。
   WeatherAreaCode 一次細分コード(4桁)です。
   WeatherList 気象情報リストです(実測値および予測値)。
    Weather 気象情報です。
     Type 気象情報の区分です。
  • observation - 実測値
  • forecast - 予測値
     Date 日付と時刻です(YYYYMMDDHHMI形式)。
     Rainfall 降水強度です(単位:mm/h)。小数点第二位までの精度です。
※降水強度は、気象レーダーで観測された降水の強さを時間雨量(mm/h)に換算した値で、実際の雨量とは異なります。

サンプルレスポンス

東京都港区六本木付近の緯度:35.663613、経度:139.732293のサンプルレスポンスです。

<YDF xmlns="http://olp.yahooapis.jp/ydf/1.0" firstResultPosition="1" totalResultsAvailable="1" totalResultsReturned="1">
    <ResultInfo>
      <Count>1</Count>
      <Total>1</Total>
      <Start>1</Start>
      <Status>200</Status>
      <Latency>0.004408</Latency>
      <Description/>
    </ResultInfo>
    <Feature>
      <Id>201210191610_139.73229_35.663613</Id>
      <Name>
        地点(139.73229,35.663613)の2012年10月19日 16時10分から60分間の天気情報
      </Name>
      <Geometry>
        <Type>point</Type>
        <Coordinates>139.73229,35.663613</Coordinates>
      </Geometry>
      <Property>
        <WeatherAreaCode>4410</WeatherAreaCode>
        <WeatherList>
          <Weather>
            <Type>observation</Type>
            <Date>201210191610</Date>
            <Rainfall>1.65</Rainfall>
          </Weather>
          <Weather>
            <Type>forecast</Type>
            <Date>201210191620</Date>
            <Rainfall>0.00</Rainfall>
          </Weather>
          <Weather>
            <Type>forecast</Type>
            <Date>201210191630</Date>
            <Rainfall>0.00</Rainfall>
          </Weather>
          <Weather>
            <Type>forecast</Type>
            <Date>201210191640</Date>
            <Rainfall>0.85</Rainfall>
          </Weather>
          <Weather>
            <Type>forecast</Type>
            <Date>201210191650</Date>
            <Rainfall>1.15</Rainfall>
          </Weather>
          <Weather>
            <Type>forecast</Type>
            <Date>201210191700</Date>
            <Rainfall>0.85</Rainfall>
          </Weather>
          <Weather>
            <Type>forecast</Type>
            <Date>201210191710</Date>
            <Rainfall>1.15</Rainfall>
          </Weather>
        </WeatherList>
      </Property>
    </Feature>
  </YDF>  

エラー

コード 説明
400 渡されたパラメーターがWeb APIで期待されたものと一致しない場合に返されます。
503 内部的な問題によってデータを返すことができない場合に返されます。

リクエストに対するエラーレスポンスです。

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>400</Code>
  <Message>Bad Request</Message>
</Error>

利用制限

気象情報APIは、24時間中1アプリケーションにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。

アプリケーションの管理

目次

利用のルール

開発のヒント