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

7 日間の天気予報

このセクションでは、単純な 7 日間の天気予報リクエストの例を示します。

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

ユーザーストーリー

ユーザーは、米国イリノイ州シカゴで、毎日 7 日間の天気予報を取得したいと考えています。

リクエストのサマリー

リソース : report –リソース表現は、拡張子 .xml またはを使用して指定されます .json
パラメータ : product –クエリによって要求されたレポートの種類を示します。この例では、パラメータ値を使用 forecast_7days_simple して、今後 7 日間の日報を要求します
  latitude –クエリが天気予報を要求する場所の緯度を示します
  longitude –クエリが天気予報を要求する場所の経度を示します

リクエスト

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

curl https://weather.cc.api.here.com/weather/1.0/report.json
?product=forecast_7days_simple
&latitude=41.83
&longitude=-87.68
-H "Authorization: Bearer {YOUR_TOKEN}"

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

curl https://weather.cc.api.here.com/weather/1.0/report.xml
?product=forecast_7days_simple
&latitude=41.83
&longitude=-87.68
-H "Authorization: Bearer {YOUR_TOKEN}"

レスポンス

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

  • イリノイ州シカゴの日報

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

{
  "dailyForecasts": {
  "forecastLocation": {
    "forecast": [
    {
      "daylight": "D",
      "description": "Drizzle. Overcast. Cool.",
      "skyInfo": "18",
      "skyDescription": "Overcast",
      "temperatureDesc": "Cool",
      "comfort": "9.21",
      "highTemperature": "12.00",
      "lowTemperature": "7.80",
      "humidity": "94",
      "dewPoint": "10.43",
      "precipitationProbability": "28",
      "precipitationDesc": "Drizzle",
      "rainFall": "0.00",
      "snowFall": "*",
      "airInfo": "32",
      "airDescription": "Damp",
      "windSpeed": "18.26",
      "windDirection": "163",
      "windDesc": "South",
      "windDescShort": "S",
      "uvIndex": "0",
      "uvDesc": "Minimal",
      "barometerPressure": "1007.17",
      "icon": "18",
      "iconName": "sprinkles",
      "iconLink": "https://weather.api.here.com/static/weather/icon/27.png",
      "dayOfWeek": "4",
      "weekday": "Wednesday",
      "utcTime": "2013-12-04T00:00:00.00-06:00"
    },
    {
      "daylight": "D",
      "description": "Sprinkles late. High level clouds. Cool.",
      "skyInfo": "12",
      "skyDescription": "High level clouds",
      "temperatureDesc": "Cool",
      "comfort": "-6.32",
      "highTemperature": "8.90",
      "lowTemperature": "-3.40",
      "humidity": "55",
      "dewPoint": "-8.74",
      "precipitationProbability": "18",
      "precipitationDesc": "Sprinkles late",
      "rainFall": "*",
      "snowFall": "*",
      "airInfo": "*",
      "airDescription": "",
      "windSpeed": "21.96",
      "windDirection": "276",
      "windDesc": "West",
      "windDescShort": "W",
      "uvIndex": "0",
      "uvDesc": "Minimal",
      "barometerPressure": "1012.06",
      "icon": "18",
      "iconName": "sprinkles",
      "iconLink": "https://weather.api.here.com/static/weather/icon/27.png",
      "dayOfWeek": "5",
      "weekday": "Thursday",
      "utcTime": "2013-12-05T00:00:00.00-06:00"
    },
    {
      ---remaining observations removed to shorten document 
    }
    ],
    "country": "United States",
    "state": "Illinois",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "distance": 0,
    "timezone": -6
  }
  },
  "feedCreation": "2013-12-04T09:44:13.574",
  "metric": true
}

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <WeatherReport>
    <dailyForecasts>
      <forecastLocation timezone="-6" distance="0.00" longitude="-87.68" latitude="41.83" city="Chicago" state="Illinois" country="United States">
        <forecast utcTime="2013-12-04T00:00:00.00-06:00" weekday="Wednesday" dayOfWeek="4">
          <daylight>D</daylight>
          <description>Drizzle. Overcast. Cool.</description>
          <skyInfo>18</skyInfo>
          <skyDescription>Overcast</skyDescription>
          <temperatureDesc>Cool</temperatureDesc>
          <comfort>9.21</comfort>
          <highTemperature>12.00</highTemperature>
          <lowTemperature>7.80</lowTemperature>
          <humidity>94</humidity>
          <dewPoint>10.43</dewPoint>
          <precipitationProbability>28</precipitationProbability>
          <precipitationDesc>Drizzle</precipitationDesc>
          <rainFall>0.00</rainFall>
          <snowFall>*</snowFall>
          <airInfo>32</airInfo>
          <airDescription>Damp</airDescription>
          <windSpeed>18.26</windSpeed>
          <windDirection>163</windDirection>
          <windDesc>South</windDesc>
          <windDescShort>S</windDescShort>
          <uvIndex>0</uvIndex>
          <uvDesc>Minimal</uvDesc>
          <barometerPressure>1007.17</barometerPressure>
          <icon>18</icon>
          <iconName>sprinkles</iconName>
          <iconLink>
            https://weather.api.here.com/static/weather/icon/27.png
          </iconLink>
        </forecast>
        <forecast utcTime="2013-12-05T00:00:00.00-06:00" weekday="Thursday" dayOfWeek="5">
          <daylight>D</daylight>
          <description>Sprinkles late. High level clouds. Cool.</description>
          <skyInfo>12</skyInfo>
          <skyDescription>High level clouds</skyDescription>
          <temperatureDesc>Cool</temperatureDesc>
          <comfort>-6.32</comfort>
          <highTemperature>8.90</highTemperature>
          <lowTemperature>-3.40</lowTemperature>
          <humidity>55</humidity>
          <dewPoint>-8.74</dewPoint>
          <precipitationProbability>18</precipitationProbability>
          <precipitationDesc>Sprinkles late</precipitationDesc>
          <rainFall>*</rainFall>
          <snowFall>*</snowFall>
          <airInfo>*</airInfo>
          <airDescription/>
          <windSpeed>21.96</windSpeed>
          <windDirection>276</windDirection>
          <windDesc>West</windDesc>
          <windDescShort>W</windDescShort>
          <uvIndex>0</uvIndex>
          <uvDesc>Minimal</uvDesc>
          <barometerPressure>1012.06</barometerPressure>
          <icon>18</icon>
          <iconName>sprinkles</iconName>
          <iconLink>
            https://weather.api.here.com/static/weather/icon/27.png
          </iconLink>
        </forecast>
        <forecast>
          ---remaining observations removed to shorten document
        </forecast>
      </forecastLocation>
    </dailyForecasts>
    <feedCreation>2013-11-21T13:10:51.272Z</feedCreation>
    <metric>true</metric>
  </WeatherReport>

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