

 Amazon Forecast は、新規のお客様は利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Weather Index
<a name="weather"></a>

Amazon Forecast の Weather Index はビルトインの特徴量化であり、履歴気象情報および予測される気象情報をモデルに組み込みます。これは、気温と降水量が製品需要に大きな影響を与える可能性がある小売業のユースケースで特に役立ちます。

Weather Index が有効になっている場合、Forecast は、予測子のトレーニング中に精度の向上が見られる時系列にのみ気象の特徴量化を適用します。時系列に気象情報を追加してもバックテスト中の予測精度が向上しない場合、Forecast はその特定の時系列に Weather Index を適用しません。

Weather Index を適用するには、ターゲットの時系列データセットおよび関連する時系列データセットに [geolocation 属性](#adding-geolocation)を含める必要があります。また、ターゲットの時系列タイムスタンプの[タイムゾーン](#specifying-timezones)を指定する必要があります。データセット要件の詳細については、「[条件と制約事項](#weather-conditions-restrictions)」を参照してください。

**Python ノートブック**  
Weather Index の使用に関するステップバイステップガイドについては、「[NY Taxi: Amazon Forecast with Weather Index](https://github.com/aws-samples/amazon-forecast-samples/tree/master/notebooks/advanced/Weather_index)」(NY タクシー: Weather Index を使用した Amazon Forecast) を参照してください。

**Topics**
+ [Weather Index の有効化](#enabling-weather)
+ [データセットへの geolocation の追加](#adding-geolocation)
+ [タイムゾーンの指定](#specifying-timezones)
+ [条件と制限](#weather-conditions-restrictions)

## Weather Index の有効化
<a name="enabling-weather"></a>

Weather Index は、予測子のトレーニング段階で有効になります。[`CreateAutoPredictor`](API_CreateAutoPredictor.md) オペレーションを使用する場合、Weather Index は [AdditionalDataset](API_AdditionalDataset.md) データ型に含まれます。

Weather Index を有効にする前に、ターゲットの時系列および関連する時系列データセットに geolocation 属性を含め、タイムスタンプのタイムゾーンを定義する必要があります。詳細については、「[Adding Geolocation Information](#adding-geolocation)」(geolocation 情報の追加) と「[Specifying Time Zones](#specifying-timezones)」(タイムゾーンの指定) を参照してください。

Forecast コンソールまたは Forecast ソフトウェア開発キット (SDK) を使用して、Weather Index を有効にできます。

------
#### [ Console ]

**Weather Index を有効にするには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/) で Amazon Forecast コンソールを開きます。

1. **[Dataset groups]** (データセットグループ) から、データセットグループを選択します。

1. ナビゲーションペインで、**[Predictors]** (予測子) を選択します。

1. **[Train new predictor]** (新しい予測子のトレーニング) を選択します。

1. **[Enable Weather Index]** (Weather Index を有効化) を選択します。

------
#### [ SDK ]

**Weather Index を有効にするには**

[`CreateAutoPredictor`](API_CreateAutoPredictor.md) オペレーションを使用して、[AdditionalDataset](API_AdditionalDataset.md) データ型に `"Name": "weather"` と `"Value": "true"` を追加して Weather Index を有効にします。

```
    "DataConfig": { 
        ...
        "AdditionalDatasets": [
            ...                      
            {             
                "Name": "weather",       
            }      
            ]   
        },
```

------

## データセットへの geolocation の追加
<a name="adding-geolocation"></a>

Weather Index を使用するには、ターゲットの時系列データセットおよび関連する時系列データセットに各項目についての geolocation 属性を含める必要があります。属性は、データセットスキーマ内の `geolocation` 属性タイプで定義されます。

あるデータセット内のすべての geolocation の値は、単一のリージョン内にのみ存在する必要があります。リージョンは、米国 (ハワイ州とアラスカ州を除く)、カナダ、南米、中米、アジアパシフィック、欧州、アフリカおよび中東です。

次の 2 つの形式のいずれかで geolocation 属性を指定します。
+ **[Latitude & Longitude]** (緯度と経度) (すべてのリージョン) - 緯度と経度を 10 進数のフォーマットで指定します (例: 47.61\$1-122.33)
+ **郵便番号** (米国のみ) - 国コード (US) の後に 5 桁の郵便番号を指定します (例: US\$198121)

[Latitude & Longitude (緯度および経度)] の形式は、すべてのリージョンでサポートされています。[Postal code (郵便番号)] の形式は、米国リージョンでのみサポートされています。

**Topics**
+ [緯度と経度の境界](#geolocation-bounds)
+ [データセットスキーマに geolocation を含める](#geolocation-schema)
+ [geolocation フォーマットの設定](#geolocation-format)

### 緯度と経度の境界
<a name="geolocation-bounds"></a>

以下は、承認されたリージョンの緯度と経度の境界です。

------
#### [ US Region ]

**境界**: 緯度 (24.6, 50.0)、経度 (-126.0, -66.4)。

![\[Map of North America showing United States, parts of Canada and Mexico with major cities.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/weather-us-bounds.png)


------
#### [ Canada Region ]

**境界**: 緯度 (41.0, 75.0)、経度 (-142.0, -52.0)。

![\[Map showing northern Canada and parts of the US, highlighting territories and major cities.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/weather-can-bounds.PNG)


------
#### [ Europe Region ]

**境界**: 緯度 (34.8, 71.8)、経度 (-12.6, 44.8)。

![\[Map of Northern Europe and surrounding regions showing countries and major cities.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/weather-euro-bounds.png)


------
#### [ South America Region ]

**境界**: 緯度 (-56.6, 14.0)、経度 (-82.4, -33.00)。

![\[Map of South America showing countries, major cities, and Brazilian states.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/weather-sa-bounds.PNG)


------
#### [ Asia Pacific Region ]

**境界**: 緯度 (-47.8, 55.0)、経度 (67.0, 180.60)。

![\[Map showing East Asia, Southeast Asia, and Australia with country names and ocean labels.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/weather-apac-bounds.png)


------
#### [ Central America Region ]

**境界**: 緯度 (6.80、33.20)、経度 (-118.80、-58.20)。

![\[Map showing southern US, Mexico, Central America, and Caribbean with major cities and bodies of water.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/weather-ca-bounds.png)


------
#### [ Africa & Middle East Region ]

**境界**: 緯度 (-35.60, 43.40)、経度 (-18.80, -58.20)。

![\[Map showing North Africa, Middle East, and parts of Europe with country names and borders.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/weather-africa-bounds.png)


------

### データセットスキーマに geolocation を含める
<a name="geolocation-schema"></a>

コンソールまたは [CreateDataset](API_CreateDataset.md) オペレーションを使用して、ターゲット時系列および関連する時系列の JSON スキーマ内で場所の属性タイプを「geolocation」として定義します。スキーマの属性は、データセットに表示されるとおりに順序付けする必要があります。

```
 { 
  "Attributes":[
    {
       "AttributeName": "timestamp",
       "AttributeType": "timestamp"
    },
    {
       "AttributeName": "target_value",
       "AttributeType": "float"
    },
    {
       "AttributeName": "item_id",
       "AttributeType": "string"
    },
    {
       "AttributeName": "location",
       "AttributeType": "geolocation"
    }
  ]
}
```

### geolocation フォーマットの設定
<a name="geolocation-format"></a>

geolocation 属性の形式は、**[Postal Code]** (郵便番号) または **[Latitude & Longitude]** (緯度と経度) の形式にすることができます。Forecast コンソールまたは Forecast ソフトウェア開発キット (SDK) を使用して、 geolocation の形式を設定できます。

------
#### [ Console ]

**時系列データセットに geolocation 属性を追加するには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/) で Amazon Forecast コンソールを開きます。

1. **[データセットグループの作成]** を選択します。

1. **[Schema builder]** (スキーマビルダー) で、geolocation の **[Attribute type]** (属性タイプ) を `geolocation` に設定します。

1. **[Geoloocation フォーマット]** のドロップダウンで、ロケーションフォーマットを選択します。

![\[Dataset details form with name, frequency, and schema builder for attribute specification.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/schema-builder-geolocation.png)


また、JSON 形式で属性を定義し、**[Geolocation format]** (geolocation の形式) のドロップダウンから場所の形式を選択することもできます。

------
#### [ SDK ]

**時系列データセットに geolocation 属性を追加するには**

[CreateDatasetImportJob](API_CreateDatasetImportJob.md) オペレーションを使用して、`GeolocationFormat` の値を次のいずれかに設定します。
+ **[Latitude & longitude]** (緯度と経度) (すべてのリージョン): `"LAT_LONG"`
+ **郵便番号** (米国のみ): `"CC_POSTALCODE"`

例えば、緯度と経度の形式を指定するには、`CreateDatasetImportJob` リクエストに次の情報を含めます。

```
{
    ...
    "GeolocationFormat": "LAT_LONG"
}
```

------

## タイムゾーンの指定
<a name="specifying-timezones"></a>

Amazon Forecast にタイムゾーン情報を geolocation 属性と自動的に同期させるか、データセット全体に単一のタイムゾーンを手動で割り当てることができます。

**Topics**
+ [タイムゾーンを geolocation と自動的に同期する](#timezones-automatic)
+ [単一のタイムゾーンを手動で選択する](#timezones-manual)

### タイムゾーンを geolocation と自動的に同期する
<a name="timezones-automatic"></a>

このオプションは、複数のタイムゾーンのタイムスタンプを含み、それらのタイムスタンプが現地時間で表されるデータセットに最適です。Forecast は、項目の geolocation 属性に基づいて、ターゲット時系列データセット内のすべての項目にタイムゾーンを割り当てます。

Forecast コンソールまたは Forecast SDK を使用して、タイムスタンプを geolocation 属性と自動的に同期できます。

------
#### [ Console ]

**タイムゾーンを geolocation 属性と同期するには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/) で Amazon Forecast コンソールを開きます。

1. ナビゲーションペインで、**[Create dataset group]** (データセットグループを作成) を選択します。

1. **[Dataset import details]** (データセットのインポートの詳細) で、**[Sync time zone with location]** (タイムゾーンを場所と同期) を選択します。

![\[Dataset import form with fields for name, time zone, S3 data location, and IAM role.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/sync-timezone-with-geolocation.PNG)


------
#### [ SDK ]

**タイムゾーンを geolocation 属性と同期するには**

[CreateDatasetImportJob](API_CreateDatasetImportJob.md) オペレーションを使用して、`"UseGeolocationForTimeZone"` を `"true"` に設定します。

```
{
    ...
    "UseGeolocationForTimeZone": "true"
}
```

------

### 単一のタイムゾーンを手動で選択する
<a name="timezones-manual"></a>

**注記**  
米国リージョン、カナダリージョン、南米リージョン、中米リージョン、アジアパシフィックリージョン、欧州リージョン、アフリカおよび中東リージョン以外のタイムゾーンを手動で選択できます。ただし、すべての geolocation の値は、これらのいずれかのリージョン内にある必要があります。

このオプションは、すべてのタイムスタンプが単一のタイムゾーン内にあるデータセット、またはすべてのタイムスタンプが単一のタイムゾーンに正規化されているデータセットに最適です。このオプションを使用すると、データセット内のすべての項目に同じタイムゾーンが適用されます。

Weather Index では、以下のタイムゾーンを使用できます。

 **米国リージョン** 
+  America/Los\$1Angeles 
+  America/Phoenix 
+  America/Denver 
+  America/Chicago 
+  America/New\$1York 

 **カナダリージョン** 
+ America/Vancouver
+ America/Edmonton
+ America/Regina 
+ America/Winnipeg 
+ America/Toronto
+ America/Halifax
+ America/St\$1Johns

 **欧州リージョン** 
+ Europe/London 
+ Europe/Paris 
+ Europe/Helsinki 

 **南米リージョン** 
+ America/Buenos\$1Aires
+ America/Noronha
+ America/Caracas 

 **アジアパシフィックリージョン** 
+ Asia/Kabul 
+ Asia/Karachi 
+ Asia/Kolkata 
+ Asia/Kathmandu 
+ Asia/Dhaka 
+ Asia/Rangoon 
+ Asia/Bangkok 
+ Asia/Singapore 
+ Asia/Seoul 
+ Australia/Adelaide 
+ Australia/Melbourne 
+ Australia/Lord\$1Howe 
+ Australia/Eucla 
+ Pacific/Norfolk 
+ Pacific/Auckland 

 **中米** 
+ America/Puerto\$1Rico

 **アフリカおよび中東** 
+ Africa/Nairobi 
+ Asia/Tehran 
+ Asia/Dubai

 **その他** 
+ Pacific/Midway 
+ Pacific/Honolulu 
+ Pacific/Marquesas 
+ America/Anchorage 
+ Atlantic/Cape\$1Verde 
+ Asia/Anadyr 
+ Pacific/Chatham 
+ Pacific/Enderbury 
+ Pacific/Kiritimati 

データセット内の項目が受け入れられたリージョン内にあるが、タイムスタンプがそのリージョン外のタイムゾーンに標準化されている場合は、**[その他]** のリストからタイムゾーンを選択します。

有効なタイムゾーン名の完全なリストについては、「[Joda-Time library](http://joda-time.sourceforge.net/timezones.html)」(Joda-Time ライブラリ) を参照してください。

Forecast コンソールまたは Forecast SDK を使用して、データセットのタイムゾーンを手動で設定できます。

------
#### [ Console ]

**データセットの単一のタイムゾーンを選択するには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/) で Amazon Forecast コンソールを開きます。

1. ナビゲーションペインで、**[Create dataset group]** (データセットグループを作成) を選択します。

1. **[Dataset import details]** (データセットのインポートの詳細) で、**[Select time zone]** (タイムゾーンを選択) を選択します。

例えば、以下を使用して、ロサンゼルス時間 (パシフィック標準時) をデータセットに適用します。

![\[Dataset import form with fields for name, time zone, data location, and IAM role.\]](http://docs.aws.amazon.com/ja_jp/forecast/latest/dg/images/select-timezone.PNG)


------
#### [ SDK ]

**データセットの単一のタイムゾーンを選択するには**

[CreateDatasetImportJob](API_CreateDatasetImportJob.md) オペレーションを使用して、`"TimeZone"` を有効なタイムゾーンに設定します。

例えば、以下を使用して、ロサンゼルス時間 (パシフィック標準時) をデータセットに適用します。

```
{
    ...
    "TimeZone": "America/Los_Angeles"
}
```

------

## 条件と制限
<a name="weather-conditions-restrictions"></a>

Weather Index を使用する場合は、次の条件と制約事項が適用されます。
+ **使用可能なアルゴリズム**: レガシー予測子を使用している場合、CNN-QR、DeepAR\$1、および Prophet アルゴリズムを使用して予測子をトレーニングすると、Weather Index を有効にできます。Weather Index は、ARIMA、ETS、および NPTS には適用されません。
+ **予想頻度**: 有効な予想頻度は、`Minutely`、`Hourly`、および `Daily` です。
+ **[Forecast horizon]** (予測期間) : 予測期間は、今後 14 日間を超えて設定することはできません。各予測頻度の予測期間の制限については、以下のリストを参照してください。
  + `1 minute` - 500
  + `5 minutes` - 500
  + `10 minutes` - 500
  + `15 minutes` - 500
  + `Hourly` - 330
  + `Daily` - 14
+ **時系列の長さ**: Weather Index を使用してモデルをトレーニングする場合、Forecast は、Forecast 気象データセットの特徴量化の開始日前のタイムスタンプを持つすべての時系列データセットを切り捨てます。Forecast weather データセットの機能には、次の開始日が含まれています。
  + **米国リージョン**: 2018 年 7 月 2 日
  + **欧州リージョン**: 2018 年 7 月 2 日
  + **アジアパシフィックリージョン**: 2018 年 7 月 2 日
  + **カナダリージョン**: 2019 年 7 月 2 日
  + **南米リージョン**: 2020 年 1 月 2 日
  + **中米リージョン**: 2020 年 9 月 2 日
  + **アフリカおよび中東リージョン**: 2021 年 3 月 25 日

  Weather Index を有効にすると、開始日の前のタイムスタンプを持つデータポイントは、予測子のトレーニング中に使用されません。
+ ****場所の数: ターゲット時系列データセットは、2000 の一意の場所を超えることはできません。
+ **リージョンの境界**: データセット内のすべてのアイテムは 1 つのリージョン内にある必要があります。
+ **[Minimum time series length]** (最小時系列長) : Weather Index をテストする際の追加のデータ要件により、時系列データセットの最小長は次のとおりです: 

  `3 × ForecastHorizon + (BacktestWindows + 1) × BacktestWindowOffset`

  時系列データセットがこの要件を満たしていない場合は、以下を減らすことを検討してください。
  + `ForecastHorizon` - 予測期間を短縮します。
  + `BacktestWindowOffset` - バックテスト中にテストセットの長さを短くします。
  + `BacktestWindows` - バックテストの数を減らします。