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

天文学の予測

このセクションでは、天文学の予測の例を示します。

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

ユーザーストーリー

ユーザーは、イリノイ州シカゴでの太陽と月の上昇および設定時間に関する情報を取得したいと考えています。

リクエストのサマリー

リソース :	`report` –リソース表現は、拡張子 `.xml` またはを使用して指定されます `.json`
パラメータ :	`product` –クエリが要求するレポートの種類を示します。この例では、クエリはパラメータ値を使用 `forecast_astronomy` して天文学情報を要求します
	`name` –クエリが天気予報を要求する市区町村の名前を示します

リクエスト

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

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

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

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

レスポンス

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

イリノイ州シカゴの天文学情報

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

{
  "astronomy": {
  "astronomy": [
    {
    "sunrise": "7:12AM",
    "sunset": "4:14PM",
    "moonrise": "12:25PM",
    "moonset": "12:20AM",
    "moonPhase": 0.54,
    "moonPhaseDesc": "First Quarter",
    "iconName": "cw_first_qtr",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "utcTime": "2013-12-10T00:00:00.00-06:00"
    },
    {
    "sunrise": "7:13AM",
    "sunset": "4:14PM",
    "moonrise": "12:57PM",
    "moonset": "1:25AM",
    "moonPhase": 0.645,
    "moonPhaseDesc": "Waxing gibbous",
    "iconName": "cw_waxing_gibbous",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "utcTime": "2013-12-11T00:00:00.00-06:00"
    },
    {
    "sunrise": "7:14AM",
    "sunset": "4:14PM",
    "moonrise": "1:30PM",
    "moonset": "2:28AM",
    "moonPhase": 0.741,
    "moonPhaseDesc": "Waxing gibbous",
    "iconName": "cw_waxing_gibbous",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "utcTime": "2013-12-12T00:00:00.00-06:00"
    },
    {
    "sunrise": "7:14AM",
    "sunset": "4:14PM",
    "moonrise": "2:05PM",
    "moonset": "3:30AM",
    "moonPhase": 0.825,
    "moonPhaseDesc": "Waxing gibbous",
    "iconName": "cw_waxing_gibbous",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "utcTime": "2013-12-13T00:00:00.00-06:00"
    },
    {
    "sunrise": "7:15AM",
    "sunset": "4:15PM",
    "moonrise": "2:43PM",
    "moonset": "4:28AM",
    "moonPhase": 0.895,
    "moonPhaseDesc": "Waxing gibbous",
    "iconName": "cw_waxing_gibbous",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "utcTime": "2013-12-14T00:00:00.00-06:00"
    },
    {
    "sunrise": "7:16AM",
    "sunset": "4:15PM",
    "moonrise": "3:26PM",
    "moonset": "5:26AM",
    "moonPhase": 0.947,
    "moonPhaseDesc": "Full moon",
    "iconName": "cw_full_moon",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "utcTime": "2013-12-15T00:00:00.00-06:00"
    },
    {
    "sunrise": "7:17AM",
    "sunset": "4:15PM",
    "moonrise": "4:12PM",
    "moonset": "6:18AM",
    "moonPhase": 0.981,
    "moonPhaseDesc": "Full moon",
    "iconName": "cw_full_moon",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "utcTime": "2013-12-16T00:00:00.00-06:00"
    },
    {
    "sunrise": "7:17AM",
    "sunset": "4:15PM",
    "moonrise": "5:02PM",
    "moonset": "7:07AM",
    "moonPhase": 0.998,
    "moonPhaseDesc": "Full moon",
    "iconName": "cw_full_moon",
    "city": "Chicago",
    "latitude": 41.83,
    "longitude": -87.68,
    "utcTime": "2013-12-17T00:00:00.00-06:00"
    }
  ],
  "country": "United States",
  "state": "Illinois",
  "city": "Chicago",
  "latitude": 41.85003,
  "longitude": -87.65005,
  "timezone": -6
  },
  "feedCreation": "2013-12-10T15:44:37.120",
  "metric": true
}

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

<WeatherReport>
  <astronomy timezone="-6" longitude="-87.65005" latitude="41.85003" city="Chicago" state="Illinois" country="United States">
    <astronomy utcTime="2013-12-10T00:00:00.00-06:00" longitude="-87.68" latitude="41.83" city="Chicago">
      <sunrise>7:12AM</sunrise>
      <sunset>4:14PM</sunset>
      <moonrise>12:25PM</moonrise>
      <moonset>12:20AM</moonset>
      <moonPhase>0.540</moonPhase>
      <moonPhaseDesc>First Quarter</moonPhaseDesc>
      <iconName>cw_first_qtr</iconName>
    </astronomy>
    <astronomy utcTime="2013-12-11T00:00:00.00-06:00" longitude="-87.68" latitude="41.83" city="Chicago">
      <sunrise>7:13AM</sunrise>
      <sunset>4:14PM</sunset>
      <moonrise>12:57PM</moonrise>
      <moonset>1:25AM</moonset>
      <moonPhase>0.645</moonPhase>
      <moonPhaseDesc>Waxing gibbous</moonPhaseDesc>
      <iconName>cw_waxing_gibbous</iconName>
    </astronomy>
    <astronomy utcTime="2013-12-12T00:00:00.00-06:00" longitude="-87.68" latitude="41.83" city="Chicago">
      <sunrise>7:14AM</sunrise>
      <sunset>4:14PM</sunset>
      <moonrise>1:30PM</moonrise>
      <moonset>2:28AM</moonset>
      <moonPhase>0.741</moonPhase>
      <moonPhaseDesc>Waxing gibbous</moonPhaseDesc>
      <iconName>cw_waxing_gibbous</iconName>
    </astronomy>
    <astronomy utcTime="2013-12-13T00:00:00.00-06:00" longitude="-87.68" latitude="41.83" city="Chicago">
      <sunrise>7:14AM</sunrise>
      <sunset>4:14PM</sunset>
      <moonrise>2:05PM</moonrise>
      <moonset>3:30AM</moonset>
      <moonPhase>0.825</moonPhase>
      <moonPhaseDesc>Waxing gibbous</moonPhaseDesc>
      <iconName>cw_waxing_gibbous</iconName>
    </astronomy>
    <astronomy utcTime="2013-12-14T00:00:00.00-06:00" longitude="-87.68" latitude="41.83" city="Chicago">
      <sunrise>7:15AM</sunrise>
      <sunset>4:15PM</sunset>
      <moonrise>2:43PM</moonrise>
      <moonset>4:28AM</moonset>
      <moonPhase>0.895</moonPhase>
      <moonPhaseDesc>Waxing gibbous</moonPhaseDesc>
      <iconName>cw_waxing_gibbous</iconName>
    </astronomy>
    <astronomy utcTime="2013-12-15T00:00:00.00-06:00" longitude="-87.68" latitude="41.83" city="Chicago">
      <sunrise>7:16AM</sunrise>
      <sunset>4:15PM</sunset>
      <moonrise>3:26PM</moonrise>
      <moonset>5:26AM</moonset>
      <moonPhase>0.947</moonPhase>
      <moonPhaseDesc>Full moon</moonPhaseDesc>
      <iconName>cw_full_moon</iconName>
    </astronomy>
    <astronomy utcTime="2013-12-16T00:00:00.00-06:00" longitude="-87.68" latitude="41.83" city="Chicago">
      <sunrise>7:17AM</sunrise>
      <sunset>4:15PM</sunset>
      <moonrise>4:12PM</moonrise>
      <moonset>6:18AM</moonset>
      <moonPhase>0.981</moonPhase>
      <moonPhaseDesc>Full moon</moonPhaseDesc>
      <iconName>cw_full_moon</iconName>
    </astronomy>
    <astronomy utcTime="2013-12-17T00:00:00.00-06:00" longitude="-87.68" latitude="41.83" city="Chicago">
      <sunrise>7:17AM</sunrise>
      <sunset>4:15PM</sunset>
      <moonrise>5:02PM</moonrise>
      <moonset>7:07AM</moonset>
      <moonPhase>0.998</moonPhase>
      <moonPhaseDesc>Full moon</moonPhaseDesc>
      <iconName>cw_full_moon</iconName>
    </astronomy>
  </astronomy>
  <feedCreation>2013-12-10T15:49:53.254Z</feedCreation>
  <metric>true</metric>
</WeatherReport>

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