7 日間の天気予報
このセクションでは、単純な 7 日間の天気予報リクエストの例を示します。
注 : この例では、 HERE トークンを使用して要求を認証します。 使用可能な認証オプションについては、『 Identity & Access Management 開発者ガイド』を参照してください。
ユーザーストーリー
ユーザーは、米国イリノイ州シカゴで、毎日 7 日間の天気予報を取得したいと考えています。
リクエストのサマリー
リクエスト
次のコードブロックは、応答データを 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>
このタイプのリクエストへの応答の詳細については、「返信をレポート」を参照してください。