気象観測
このセクションでは、気象観測リクエストの例を示します。
注 : この例では、 HERE トークンを使用して要求を認証します。 使用可能な認証オプションについては、『 Identity & Access Management 開発者ガイド』を参照してください。
ユーザーストーリー
ユーザーが、ドイツのベルリンの現在の気象条件を取得しようとしています。
リクエストのサマリー
リクエスト
次のコードブロックは、応答データを 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>
このタイプのリクエストへの応答の詳細については、「返信をレポート」を参照してください。