

 O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

O Weather Index do Amazon Forecast é uma caracterização integrada que inclui informações meteorológicas passadas e projetadas em seu modelo. É especialmente útil para casos de uso no varejo, em que a temperatura e a precipitação podem afetar significativamente a demanda de produtos.

Quando o Weather Index está ativado, o Forecast aplica a caracterização do clima somente às séries temporais em que encontra melhorias na precisão durante o treinamento do preditor. Se complementar uma série temporal com informações meteorológicas não melhorar sua precisão preditiva durante o backtesting, o Forecast não aplicará o Weather Index a essa série temporal específica.

Para aplicar o Weather Index, você deve incluir um [atributo de geolocalização](#adding-geolocation) em seu conjunto de dados de séries temporais de destino e em qualquer conjunto de dados de séries temporais relacionado. Você também precisa especificar [fusos horários](#specifying-timezones) para os carimbos de data/hora das séries temporais de destino. Para obter mais informações sobre os requisitos do conjunto de dados, consulte [Condições e restrições](#weather-conditions-restrictions).

**Cadernos Python**  
Para obter um step-by-step guia sobre como usar o Weather Index, consulte [NY Taxi: Amazon Forecast with Weather Index](https://github.com/aws-samples/amazon-forecast-samples/tree/master/notebooks/advanced/Weather_index).

**Topics**
+ [Como ativar o Weather Index](#enabling-weather)
+ [Como adicionar informações de geolocalização aos conjuntos de dados](#adding-geolocation)
+ [Como especificar o fuso horário](#specifying-timezones)
+ [Condições e restrições](#weather-conditions-restrictions)

## Como ativar o Weather Index
<a name="enabling-weather"></a>

O Weather Index é ativado durante a fase de treinamento do preditor. Ao usar a [`CreateAutoPredictor`](API_CreateAutoPredictor.md)operação, o Índice Meteorológico é incluído no tipo de [AdditionalDataset](API_AdditionalDataset.md)dados.

Antes de ativar o Weather Index, você deve incluir um atributo de geolocalização na série temporal de destino e nos conjuntos de dados de séries temporais relacionadas e definir os fusos horários para seus carimbos de data e hora. Para obter mais informações, consulte [Adicionando informações de geolocalização](#adding-geolocation) e [Especificando fusos horários](#specifying-timezones).

Você pode ativar o Weather Index usando o console Forecast ou o kit de desenvolvimento de software (SDK) do Forecast.

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

**Para habilitar o Weather Index**

1. Faça login Console de gerenciamento da AWS e abra o console do Amazon Forecast em [https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/).

1. Na página **Grupos de conjuntos de dados**, escolha seu grupo de conjuntos de dados.

1. No painel de navegação, selecione **Preditores**.

1. Escolha **Treinar novo preditor**.

1. Escolha **Habilitar o Weather Index**.

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

**Para habilitar o Weather Index**

Usando a [`CreateAutoPredictor`](API_CreateAutoPredictor.md)operação, ative o Índice Meteorológico adicionando `"Name": "weather"` e `"Value": "true"` inserindo o tipo de [AdditionalDataset](API_AdditionalDataset.md)dados.

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

------

## Como adicionar informações de geolocalização aos conjuntos de dados
<a name="adding-geolocation"></a>

Para usar o Weather Index, você deve incluir um atributo de geolocalização para cada item em sua série temporal de destino e conjuntos de dados de séries temporais relacionados. O atributo é definido com o tipo de atributo `geolocation` nos esquemas do conjunto de dados.

Todos os valores de geolocalização em um conjunto de dados devem estar exclusivamente em uma única região. As regiões são: EUA (exceto Havaí e Alasca), Canadá, América do Sul, América Central, Ásia-Pacífico, Europa e África e Oriente Médio.

Especifique o atributo de geolocalização em um de dois formatos:
+ **Latitude e longitude** (todas as regiões): especifique a latitude e a longitude no formato decimal (exemplo: 47,61\$1-122,33)
+ **Código postal** (somente EUA): especifique o código do país (EUA), seguido pelo código postal de 5 dígitos (exemplo: US\$198121)

O formato Latitude e Longitude é compatível com todas as regiões. O formato de código postal só é compatível com a região dos EUA.

**Topics**
+ [Limites de latitude e longitude](#geolocation-bounds)
+ [Incluindo geolocalização no esquema do conjunto de dados](#geolocation-schema)
+ [Como definir o formato da geolocalização](#geolocation-format)

### Limites de latitude e longitude
<a name="geolocation-bounds"></a>

Veja os limites de latitude e longitude para as regiões aceitas:

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

**Limites**: latitude (24,6, 50,0), longitude (-126,0, -66,4).

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


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

**Limites**: latitude (41,0, 75,0), longitude (-142,0, -52,0).

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


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

**Limites**: latitude (34,8, 71,8), longitude (-12,6, 44,8).

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


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

**Limites**: latitude (-56,6, 14,0), longitude (-82,4, -33,00).

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


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

**Limites**: latitude (-47,8, 55,0), longitude (67,0, 180,60).

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


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

**Limites**: latitude (6,80, 33,20), longitude (-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/pt_br/forecast/latest/dg/images/weather-ca-bounds.png)


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

**Limites**: latitude (-35,60, 43,40), longitude (-18,80, -58,20).

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


------

### Incluindo geolocalização no esquema do conjunto de dados
<a name="geolocation-schema"></a>

Usando o console ou a [CreateDataset](API_CreateDataset.md)operação, defina o tipo de atributo de localização como “geolocalização” dentro do esquema JSON para a série temporal de destino e qualquer série temporal relacionada. Os atributos no esquema devem ser ordenados conforme aparecem nos conjuntos de dados.

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

### Como definir o formato da geolocalização
<a name="geolocation-format"></a>

O formato do atributo de geolocalização pode estar no formato **Código postal** ou **Latitude e longitude**. Você pode definir o formato de geolocalização usando o console Forecast ou o kit de desenvolvimento de software (SDK) do Forecast.

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

**Para adicionar um atributo de geolocalização a um conjunto de dados de séries temporais**

1. Faça login Console de gerenciamento da AWS e abra o console do Amazon Forecast em [https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/).

1. Escolha **Criar grupo de conjuntos de dados**.

1. No **Criador de esquemas**, defina o **tipo de atributo** de geolocalização como `geolocation`.

1. No menu suspenso **Formato de geolocalização**, escolha seu formato de localização.

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


Você também pode definir seus atributos no formato JSON e selecionar um formato de localização no menu suspenso **Formato de geolocalização**.

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

**Para adicionar um atributo de geolocalização a um conjunto de dados de séries temporais**

Usando a [ CreateDatasetImportJob](API_CreateDatasetImportJob.md)operação, defina o valor `GeolocationFormat` de como um dos seguintes: 
+ **Latitude e longitude** (todas as regiões): `"LAT_LONG"`
+ **Código postal** (somente EUA): `"CC_POSTALCODE"`

Por exemplo, para especificar o formato de latitude e longitude, inclua o seguinte na solicitação `CreateDatasetImportJob`:

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

------

## Como especificar o fuso horário
<a name="specifying-timezones"></a>

Você pode permitir que o Amazon Forecast sincronize automaticamente suas informações de fuso horário com seu atributo de geolocalização ou pode atribuir manualmente um único fuso horário a todo o seu conjunto de dados. 

**Topics**
+ [Sincronizar automaticamente os fusos horários com a geolocalização](#timezones-automatic)
+ [Selecione manualmente um único fuso horário](#timezones-manual)

### Sincronizar automaticamente os fusos horários com a geolocalização
<a name="timezones-automatic"></a>

Essa opção é ideal para conjuntos de dados que contêm carimbos de data/hora em vários fusos horários. Esses carimbos de data/hora são expressos no horário local. O Forecast atribui um fuso horário para cada item no conjunto de dados da série temporal de destino com base no atributo de geolocalização do item.

Você pode sincronizar automaticamente seus carimbos de data e hora com seu atributo de geolocalização usando o console Forecast ou o SDK do Forecast.

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

**Para sincronizar fusos horários com o atributo de geolocalização**

1. Faça login Console de gerenciamento da AWS e abra o console do Amazon Forecast em [https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/).

1. No painel de navegação, selecione **Criar grupo de conjunto de dados**.

1. Em **Detalhes da importação do conjunto de dados**, escolha **Sincronizar fuso horário com localização**.

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


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

**Para sincronizar fusos horários com o atributo de geolocalização**

Usando a [ CreateDatasetImportJob](API_CreateDatasetImportJob.md)operação, `"UseGeolocationForTimeZone"` defina como`"true"`.

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

------

### Selecione manualmente um único fuso horário
<a name="timezones-manual"></a>

**nota**  
Você pode selecionar manualmente um fuso horário fora da *região dos EUA*, *Canadá*, *América do Sul*, *América Central*, *Ásia-Pacífico*, *Europa* e *África e Oriente Médio*. No entanto, todos os valores de geolocalização ainda deverão estar dentro de uma dessas regiões.

Essa opção é ideal para conjuntos de dados com todos os carimbos de data/hora em um único fuso horário ou se todos os carimbos de data/hora estiverem normalizados para um único fuso horário. O uso dessa opção aplica o mesmo fuso horário a todos os itens no conjunto de dados.

O Weather Index aceita os seguintes fusos horários:

 **Região dos EUA** 
+  America/Los\$1Angeles 
+  America/Phoenix 
+  America/Denver 
+  America/Chicago 
+  America/New\$1York 

 **Região do Canadá** 
+ America/Vancouver
+ America/Edmonton
+ America/Regina 
+ America/Winnipeg 
+ America/Toronto
+ America/Halifax
+ America/St\$1Johns

 **Região da Europa** 
+ Europe/London 
+ Europe/Paris 
+ Europe/Helsinki 

 **Região da América do Sul** 
+ America/Buenos\$1Aires
+ America/Noronha
+ America/Caracas 

 **Região Ásia-Pacífico** 
+ 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 

 **América Central** 
+ America/Puerto\$1Rico

 **África e Oriente Médio** 
+ Africa/Nairobi 
+ Asia/Tehran 
+ Asia/Dubai

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

Selecione um fuso horário na lista **Outros** se os itens do seu conjunto de dados estiverem em uma das regiões aceitas, mas seus carimbos de data/hora estiverem padronizados para um fuso horário fora dessa região. 

Para ver uma lista completa de nomes de fuso horário válidos, consulte a [biblioteca Joda-Time](http://joda-time.sourceforge.net/timezones.html).

Você pode definir manualmente um fuso horário para seus conjuntos de dados usando o console Forecast ou o SDK do Forecast.

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

**Para selecionar um único fuso horário para seu conjunto de dados**

1. Faça login Console de gerenciamento da AWS e abra o console do Amazon Forecast em [https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/).

1. No painel de navegação, selecione **Criar grupo de conjunto de dados**.

1. Em **Detalhes da importação do conjunto de dados**, escolha **Selecionar fuso horário**.

Por exemplo, use o seguinte para aplicar o horário de Los Angeles (Horário Padrão do Pacífico) aos seus conjuntos de dados.

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


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

**Para selecionar um único fuso horário para seu conjunto de dados**

Usando a [ CreateDatasetImportJob](API_CreateDatasetImportJob.md)operação, `"TimeZone"` defina para um fuso horário válido.

Por exemplo, use o seguinte para aplicar o horário de Los Angeles (Horário Padrão do Pacífico) aos seus conjuntos de dados. 

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

------

## Condições e restrições
<a name="weather-conditions-restrictions"></a>

As seguintes condições e restrições se aplicam ao usar o Weather Index:
+ **Algoritmos disponíveis**: se estiver usando um preditor antigo, o Weather Index poderá ser habilitado ao treinar um preditor com os algoritmos CNN-QR, DeepAR\$1 e Prophet. O Weather Index não é aplicado ao ARIMA, ao ETS nem ao NPTS.
+ **Frequência de previsão**: as frequências de previsão válidas são `Minutely`, `Hourly` e `Daily`.
+ **Horizonte de previsão**: o horizonte de previsão não pode ultrapassar 14 dias no futuro. Para ver os limites do horizonte de cada frequência de previsão, consulte a lista abaixo:
  + `1 minute` - 500
  + `5 minutes` - 500
  + `10 minutes` - 500
  + `15 minutes` - 500
  + `Hourly` - 330
  + `Daily` - 14
+ **Duração da série temporal**: ao treinar um modelo com o Weather Index, o Forecast trunca todos os conjuntos de dados de séries temporais com carimbos de data e hora antes da data de início da caracterização do conjunto de dados meteorológicos do Forecast. A caracterização do conjunto de dados meteorológicos do Forecast contém as seguintes datas de início:
  + **Região dos EUA**: 2 de julho de 2018
  + **Região da Europa**: 2 de julho de 2018
  + **Região Ásia-Pacífico**: 2 de julho de 2018
  + **Região do Canadá**: 2 de julho de 2019
  + **Região da América do Sul**: 2 de janeiro de 2020
  + **Região da América Central**: 2 de setembro de 2020
  + **Região da África e Oriente Médio**: 25 de março de 2021

  Com o Weather Index habilitado, os pontos de dados com carimbos de data e hora antes da data de início não serão usados durante o treinamento do preditor.
+ **Número de locais**: o conjunto de dados de séries temporais de destino não pode exceder 2 mil locais exclusivos.
+ **Limites da região**: todos os itens nos conjuntos de dados devem estar localizados em uma única região.
+ **Duração mínima da série temporal**: devido aos requisitos adicionais de dados ao testar o Weather Index, a duração mínima para um conjunto de dados de séries temporais é: 

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

  Se os conjuntos de dados de séries temporais não atenderem a esse requisito, pense em diminuir os seguintes itens:
  + `ForecastHorizon`: reduza o horizonte de previsão.
  + `BacktestWindowOffset`: reduza o tamanho do conjunto de testes durante o backtesting.
  + `BacktestWindows`: reduza o número de backtests.