目的地の天気 API 開発者ガイド

気象観測

このセクションでは、気象観測リクエストの例を示します。

注 : この例では、 HERE トークンを使用して要求を認証します。 使用可能な認証オプションについては、『 Identity & Access Management 開発者ガイド』を参照してください。

ユーザーストーリー

ユーザーが、ドイツのベルリンの現在の気象条件を取得しようとしています。

リクエストのサマリー

リソース : report –リソース表現は、拡張子 .xml またはを使用して指定されます .json
パラメータ : product –クエリが要求するレポートの種類を示します。この例では、パラメーター値を使用 observation して、指定された場所に最も近い 8 つのレポートポイントの現在の気象条件に関するレポートを要求します
  name –クエリが天気予報を要求する市区町村の名前を示します

リクエスト

次のコードブロックは、応答データを JSON で配信するように指定して、リクエスト全体を示しています。

curl https://weather.cc.api.here.com/weather/1.0/report.json
?product=observation
&name=Berlin-Tegel
-H "Authorization: Bearer {YOUR_TOKEN}"

HERE は、応答データが XML で配信されることを示す同じ要求です。

curl https://weather.cc.api.here.com/weather/1.0/report.xml
?product=observation
&name=Berlin-Tegel
-H "Authorization: Bearer {YOUR_TOKEN}"

レスポンス

リクエストに対する応答には、次の内容が含まれます。

  • 観察情報を含む一連の場所
  • 各場所の天気予報情報

JSON 形式の応答例は次のとおりです。

{
   "observations":{
    "location":[
     {
      "observation":[
         {
          "daylight":"D",
          "description":"Partly sunny. Chilly.",
          "skyInfo":"14",
          "skyDescription":"Partly sunny",
          "temperature":"1.00",
          "temperatureDesc":"Chilly",
          "comfort":"-0.70",
          "highTemperature":"*",
          "lowTemperature":"*",
          "humidity":"87",
          "dewPoint":"-1.00",
          "precipitation1H":"*",
          "precipitation3H":"*",
          "precipitation6H":"*",
          "precipitation12H":"*",
          "precipitation24H":"*",
          "precipitationDesc":"*",
          "airInfo":"*",
          "airDescription":"",
          "windSpeed":"5.56",
          "windDirection":"30",
          "windDesc":"Northeast",
          "windDescShort":"NE",
          "barometerPressure":"1016.26",
          "barometerTrend":"",
          "visibility":"7.00",
          "snowCover":"*",
          "icon":"6",
          "iconName":"mostly_cloudy",
          "iconLink":"https://weather.api.here.com/static/weather/icon/17.png",
          "ageMinutes":"39",
          "activeAlerts":"0",
          "country":"Germany",
          "state":"Berlin",
          "city":"Berlin-Tegel",
          "latitude":52.56,
          "longitude":13.31,
          "distance":0,
          "elevation":31,
          "utcTime":"2015-01-21T13:20:00.00+01:00"
         }
      ],
      "country":"Germany",
      "state":"Berlin",
      "city":"Berlin-Tegel",
      "latitude":52.56,
      "longitude":13.31,
      "distance":0,
      "timezone":1
     }
    ]
   },
   "feedCreation":"2015-01-21T12:59:49.582Z",
   "metric":true
}

XML 形式の応答例は次のとおりです。

<WeatherReport>
  <observations>
    <location timezone="1" distance="0.00" longitude="13.31" latitude="52.56" city="Berlin-Tegel" state="Berlin" country="Germany">
      <observation utcTime="2015-01-21T13:20:00.00+01:00" elevation="31.00" distance="0.00" longitude="13.3100" latitude="52.5600" city="Berlin-Tegel" state="Berlin"
        country="Germany">
        <daylight>D</daylight>
        <description>Partly sunny. Chilly.</description>
        <skyInfo>14</skyInfo>
        <skyDescription>Partly sunny</skyDescription>
        <temperature>1.00</temperature>
        <temperatureDesc>Chilly</temperatureDesc>
        <comfort>-0.70</comfort>
        <highTemperature>*</highTemperature>
        <lowTemperature>*</lowTemperature>
        <humidity>87</humidity>
        <dewPoint>-1.00</dewPoint>
        <precipitation1H>*</precipitation1H>
        <precipitation3H>*</precipitation3H>
        <precipitation6H>*</precipitation6H>
        <precipitation12H>*</precipitation12H>
        <precipitation24H>*</precipitation24H>
        <precipitationDesc>*</precipitationDesc>
        <airInfo>*</airInfo>
        <airDescription />
        <windSpeed>5.56</windSpeed>
        <windDirection>30</windDirection>
        <windDesc>Northeast</windDesc>
        <windDescShort>NE</windDescShort>
        <barometerPressure>1016.26</barometerPressure>
        <barometerTrend />
        <visibility>7.00</visibility>
        <snowCover>*</snowCover>
        <icon>6</icon>
        <iconName>mostly_cloudy</iconName>
        <iconLink>https://weather.api.here.com/static/weather/icon/17.png</iconLink>
        <ageMinutes>36</ageMinutes>
        <activeAlerts>0</activeAlerts>
      </observation>
    </location>
  </observations>
  <feedCreation>2015-01-21T12:56:09.739Z</feedCreation>
  <metric>true</metric>
</WeatherReport>

このタイプのリクエストへの応答の詳細については、「返信をレポート」を参照してください。