Weather - Get Hourly Forecast

Serviço:: Maps

Versão da API:: 1.1

Use para obter uma previsão meteorológica detalhada por hora por até 24 horas ou uma previsão diária por até 10 dias.
A Get Hourly Forecast API é um HTTP GET que solicita previsão do tempo detalhada por hora para os próximos 1, 12, 24 (1 dia), 72 (3 dias), 120 (5 dias) e 240 horas (10 dias) para a localização da coordenada fornecida. A API retorna detalhes como temperatura, umidade, vento, precipitação e índice ultravioleta (UV). Para obter mais informações, consulte Solicitar dados de previsão do tempo por hora.

GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query={query}

Com parâmetros opcionais:

GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string (uri)	O nome de host do serviço Azure Mapas. Use `https://atlas.microsoft.com` para a Azure nuvem pública. Para direcionar uma geografia Azure Mapas específica ou uma nuvem soberana, veja Azure Mapas escopo geográfico.
format	path	True	JsonFormat	Formato desejado da resposta. Há suporte apenas para `json` formato.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.
query	query	True	number[]	A consulta aplicável especificada como uma cadeia de caracteres separada por vírgula composta por latitude seguida por longitude, por exemplo, "47,641268,-122,125679". As informações meteorológicas geralmente estão disponíveis para locais em terra, corpos d'água cercados por terra e áreas do oceano que estão a aproximadamente 50 milhas náuticas de uma costa.
duration	query		integer (int32)	Período de tempo da previsão do tempo retornada. Por padrão, os dados de previsão para a próxima hora serão retornados. Os valores disponíveis são `1` - Retorne os dados de previsão para a próxima hora. Valor padrão. `12` - Previsão de retorno por hora para as próximas 12 horas. `24` - Previsão de retorno de hora em hora para as próximas 24 horas. `72` - Previsão de retorno por hora para as próximas 72 horas (3 dias). `120` - Previsão de retorno por hora para as próximas 120 horas (5 dias). `240` - Previsão de retorno por hora para as próximas 240 horas (10 dias).
language	query		string	Idioma no qual os resultados da pesquisa devem ser retornados. Deve ser uma das marcas de linguagem IETF com suporte, que não diferencia maiúsculas de minúsculas. Quando os dados no idioma especificado não estão disponíveis para um campo específico, o idioma padrão é usado. Consulte de idiomas com suporte para obter detalhes.
unit	query		WeatherDataUnit	Especifica o retorno dos dados em unidades métricas ou unidades imperiais. O valor padrão é métrico.

Cabeçalho da Solicitação

Nome	Obrigatório	Tipo	Description
x-ms-client-id		string	Indica a conta destinada a ser usada com o modelo de segurança do Microsoft Entra ID. Esse ID único para a conta Azure Mapas pode ser obtido a partir da API de Conta Azure Mapas plano de gerenciamento. Para mais informações sobre o uso da segurança Microsoft Entra ID em Azure Mapas, veja Gerencie autenticação em Azure Mapas.

Respostas

Nome	Tipo	Description
200 OK	HourlyForecastResult	A solicitação foi bem-sucedida.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

AadToken

Estes são os fluxos Microsoft Entra OAuth 2.0. Quando combinado com o controle de acesso baseado em funções Azure , pode ser usado para controlar o acesso às APIs REST Azure Mapas. Controles de acesso baseados em função do Azure são usados para designar acesso a uma ou mais contas ou subrecursos de recursos do Azure Mapas. Qualquer usuário, grupo ou entidade de serviço pode receber acesso por meio de uma função interna ou uma função personalizada composta por uma ou mais permissões para APIs REST do Azure Mapas.

Para implementar cenários, recomendamos exibir conceitos de autenticação. Em resumo, essa definição de segurança fornece uma solução para modelar aplicativos por meio de objetos capazes de controlar o acesso em APIs e escopos específicos.

Note

Essa definição de segurança requer o uso do cabeçalho x-ms-client-id para indicar a qual recurso do Azure Mapas o aplicativo está solicitando acesso. Isso pode ser adquirido da API de gerenciamento do Mapas.
O Authorization URL é específico para a instância de nuvem pública do Azure. As nuvens soberanas possuem URLs de Autorização e configurações de Microsoft Entra ID únicas.
O controle de acesso baseado em função do Azure é configurado do plano de gerenciamento do Azure por meio do portal do Azure, do PowerShell, da CLI, dos SDKs do Azure ou das APIs REST.
O uso do SDK da Web do do Azure Mapas permite a configuração baseada em configuração de um aplicativo para vários casos de uso.
Para obter mais informações sobre a plataforma de identidade da Microsoft, consulte visão geral da plataforma de identidade da Microsoft.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
https://atlas.microsoft.com/.default

subscription-key

Essa é uma chave compartilhada provisionada quando você Criar uma conta do Azure Mapas no portal do Azure ou usando o PowerShell, a CLI, os SDKs do Azure ou a API REST.

Com essa chave, qualquer aplicativo pode acessar toda a API REST. Em outras palavras, essa chave pode ser usada como uma chave mestra na conta em que elas são emitidas.

Para aplicativos expostos publicamente, nossa recomendação é usar o aplicativos cliente confidenciais abordagem para acessar AS APIs REST do Azure Mapas para que sua chave possa ser armazenada com segurança.

Tipo: apiKey
Em: header

SAS Token

Esse é um token de assinatura de acesso compartilhado criado a partir da operação LISTA SAS no recurso do Azure Mapas por meio do plano de gerenciamento do Azure por meio do portal do Azure, do PowerShell, da CLI, dos SDKs do Azure ou das APIs REST.

Com esse token, qualquer aplicativo está autorizado a acessar com controles de acesso baseados em função do Azure e controle refinado para expiração, taxa e região(s) de uso para o token específico. Em outras palavras, o Token SAS pode ser usado para permitir que os aplicativos controlem o acesso de forma mais protegida do que a chave compartilhada.

Para aplicativos expostos publicamente, nossa recomendação é configurar uma lista específica de origens permitidas no de recursos da conta de mapa de para limitar o abuso de renderização e renovar regularmente o Token SAS.

Tipo: apiKey
Em: header

Exemplos

Successfully retrieve detailed weather forecast by the hour

Solicitação de exemplo

HTTP

GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12

Resposta de exemplo

Código de status:: 200

{
  "forecasts": [
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 3901
      },
      "cloudCover": 100,
      "date": "2019-11-14T16:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": true,
      "precipitationProbability": 39,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 39,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 14.1
      },
      "relativeHumidity": 72,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.4
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.9
      },
      "wind": {
        "direction": {
          "degrees": 311,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.7
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 5.6
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4054
      },
      "cloudCover": 94,
      "date": "2019-11-14T17:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 34,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 34,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 12.8
      },
      "relativeHumidity": 73,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 12.5
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.2
      },
      "wind": {
        "direction": {
          "degrees": 281,
          "localizedDescription": "W"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 5.6
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4176
      },
      "cloudCover": 94,
      "date": "2019-11-14T18:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.4
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 29,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 29,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.3
      },
      "relativeHumidity": 77,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.3
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.5
      },
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4542
      },
      "cloudCover": 93,
      "date": "2019-11-14T19:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "relativeHumidity": 79,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.4
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "wind": {
        "direction": {
          "degrees": 169,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 11.1
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4389
      },
      "cloudCover": 92,
      "date": "2019-11-14T20:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "relativeHumidity": 80,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 11.1
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4481
      },
      "cloudCover": 91,
      "date": "2019-11-14T21:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.1
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4481
      },
      "cloudCover": 92,
      "date": "2019-11-14T22:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.2
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 84,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 3688
      },
      "cloudCover": 94,
      "date": "2019-11-14T23:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "wind": {
        "direction": {
          "degrees": 175,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 2926
      },
      "cloudCover": 97,
      "date": "2019-11-15T00:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "relativeHumidity": 81,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 176,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 2164
      },
      "cloudCover": 99,
      "date": "2019-11-15T01:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 21,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 21,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 81,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.9
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "wind": {
        "direction": {
          "degrees": 177,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 1737
      },
      "cloudCover": 100,
      "date": "2019-11-15T02:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 21,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 21,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 1311
      },
      "cloudCover": 100,
      "date": "2019-11-15T03:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 26,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 26,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "relativeHumidity": 83,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.7
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "wind": {
        "direction": {
          "degrees": 161,
          "localizedDescription": "SSE"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    }
  ]
}

Definições

Nome	Description
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta comum de erro para todas as APIs do Azure Resource Manager devolver detalhes de erro em operações falhadas. (Isso também segue o formato de resposta de erro OData.).
HourlyForecast	O `HourlyForecast` objeto fornece detalhes meteorológicos por hora, incluindo data e hora, temperaturas esperadas e percebidas, e ponto de orvalho. Ele cobre a velocidade e direção do vento, rajadas de vento, umidade relativa, visibilidade e probabilidade de precipitação. Ele indica se a precipitação é esperada e especifica seu tipo. Propriedades adicionais incluem índice UV, porcentagem de cobertura de nuvens e altura do teto de nuvens. Também possui um ícone de código e frase que descrevem as condições climáticas.
HourlyForecastResult	A resposta retornava pela operação Get Hourly Forecast, contendo previsões meteorológicas hora a hora para um local específico. O número de `HourlyForecast` inscrições retornadas corresponde à duração prevista solicitada - uma de 1, 12, 24, 48, 72 ou 96 horas (veja a `HourlyDuration` união).
IconCode	O código numérico de condição climática que identifica qual ícone exibir. Cada valor nessa enumeração corresponde a um ícone meteorológico do Azure Mapas (como Sunny, Cloudy ou Thunderstorms) e é pareado com um ícone `iconPhrase` humano retornado junto com ele. O mesmo código pode aparecer em respostas atuais, horárias, diárias, trimestrais e minuto a minuto, permitindo que aplicações exibam um conjunto de ícones consistente em todos os serviços meteorológicos. Para a lista completa de códigos, os ícones para os quais eles se mapeiam e imagens de exemplo, veja Serviços de Clima no Azure Mapas.
JsonFormat	Formato desejado da resposta. Há suporte apenas para `json` formato.
UnitType	Um valor inteiro associado ao tipo de unidade exibida. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para mais informações, veja Serviços meteorológicos em Azure Mapas.
WeatherDataUnit	Especifica se deve-se devolver dados em unidades métricas ou imperiais, tendo métrica como padrão. Por exemplo: Métrica: milímetro (mm), metro (m), quilômetro (km), Celsius (C) Imperial: polegada (in), pé (pé), milha (mi), Fahrenheit (F)
WeatherValue	Valores para métricas relacionadas ao clima, como temperatura, ponto de orvalho e velocidade do vento, apresentados em unidades métricas ou imperiais, conforme especificado no parâmetro URI unitário. Para mais informações, veja Tipos de Unidades no artigo Serviços meteorológicos no Azure Mapas.
WindDetails	Fornece a velocidade prevista do vento, medida em unidades como quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido. Também indica a direção do vento medida em graus de azimute, começando no norte verdadeiro e movendo-se no sentido horário. O norte corresponde a 0°, leste a 90°, sul a 180° e oeste a 270°. Os valores possíveis variam de 0° a 359°.
WindDirection	Fornece detalhes sobre a direção do vento, incluindo a direção em graus de azimute e uma abreviação localizada da direção do vento.

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info		As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta comum de erro para todas as APIs do Azure Resource Manager devolver detalhes de erro em operações falhadas. (Isso também segue o formato de resposta de erro OData.).

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

HourlyForecast

Objeto

O HourlyForecast objeto fornece detalhes meteorológicos por hora, incluindo data e hora, temperaturas esperadas e percebidas, e ponto de orvalho. Ele cobre a velocidade e direção do vento, rajadas de vento, umidade relativa, visibilidade e probabilidade de precipitação. Ele indica se a precipitação é esperada e especifica seu tipo. Propriedades adicionais incluem índice UV, porcentagem de cobertura de nuvens e altura do teto de nuvens. Também possui um ícone de código e frase que descrevem as condições climáticas.

Nome	Tipo	Description
ceiling	WeatherValue	A altura da camada mais baixa de nuvens acima do solo, medida em pés ou metros com base na unidade especificada no pedido. Essa medição é crucial para a previsão de aviação e meteorologia.
cloudCover	integer (int32)	A porcentagem do céu coberta por nuvens na hora especificada. Esse valor varia de 0% (céu limpo) a 100% (completamente nublado). Pode ser NULL.
date	string (date-time)	Data e hora da previsão no formato RFC 3339 (yyy-mm-ddThh:mm:ss±hh:mm). Por exemplo, 2019-11-14T16:00:00-08:00.
dewPoint	WeatherValue	A temperatura na qual o ar fica saturado de umidade e orvalho começa a se formar. É medida em graus Fahrenheit (°F) ou Celsius (°C), dependendo da unidade especificada. Esse valor é crucial para entender os níveis de umidade, pois um ponto de orvalho mais alto indica mais umidade no ar, fazendo com que pareça mais úmido.
hasPrecipitation	boolean	Um valor booleano que indica se precipitação (chuva, neve, granizo ou granizo) é esperada durante o período especificado. Retorna verdadeiro se a precipitação for esperada, caso contrário falso.
ice	WeatherValue	Retorna o acúmulo estimado de gelo para cada hora na previsão, medido em milímetros (mm) ou polegadas (pol), dependendo da unidade especificada no pedido.
iceProbability	integer (int32)	Mostra a probabilidade de formação de gelo durante a hora especificada, expressa como porcentagem de 0 a 100. Um valor de 0 significa que não há chance de formação de gelo, enquanto 100 significa que a formação de gelo é certa. Essas informações ajudam os usuários a avaliar o potencial de condições de gelo.
iconCode	IconCode	Um valor numérico que corresponde a uma imagem exibindo o `iconPhrase`. Para mais informações, veja Serviços meteorológicos em Azure Mapas.
iconPhrase	string	Um termo descritivo que corresponde a uma condição climática específica, como Ensolarado. Ele é pareado com um `iconCode`, que é um valor numérico que representa uma imagem que representa visualmente as condições climáticas descritas pelo `iconPhrase`. Para mais informações, veja Serviços meteorológicos em Azure Mapas.
isDaylight	boolean	Um valor booleano que indica se é luz do dia durante a hora especificada. Retorna verdadeiro se for luz do dia, caso contrário falso.
precipitationProbability	integer (int32)	Mostra a probabilidade de precipitação durante a hora especificada, expressa como porcentagem de 0 a 100. Um valor 0 significa que não há chance de precipitação, enquanto 100 significa que a precipitação é certa. Isso ajuda os usuários a avaliar a probabilidade de chuva, neve ou outras formas de precipitação.
rain	WeatherValue	Retorna a quantidade de chuva esperada a cada hora na previsão, medida em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.
rainProbability	integer (int32)	Mostra a probabilidade de chuva durante o período especificado, expressa como porcentagem de 0 a 100. Um valor de 0 significa que não há chance de chuva, enquanto 100 significa que chuva é certa.
realFeelTemperature	WeatherValue	Fornece valores de temperatura RealFeel™ para a hora especificada, medidos em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Essa métrica, desenvolvida pela AccuWeather, incorpora mais de uma dúzia de fatores, incluindo umidade, velocidade do vento, cobertura de nuvens e intensidade solar, para oferecer uma medida abrangente de como o clima realmente se sente. Para mais informações, veja Qual é a temperatura AccuWeather RealFeel?
relativeHumidity	integer (int32)	A quantidade de vapor d'água presente no ar, expressa como uma porcentagem da quantidade máxima que o ar pode conter na mesma temperatura. Esse valor indica quão próximo o ar está de estar saturado de umidade, afetando o quão confortável ou úmido o ambiente se sente.
snow	WeatherValue	Retorna a quantidade de acúmulo de neve esperada durante a hora especificada, medida em milímetros (mm) ou polegadas (pol), dependendo da unidade especificada no pedido.
snowProbability	integer (int32)	Mostra a probabilidade de neve durante a hora especificada, expressa como porcentagem de 0 a 100. Um valor de 0 significa que não há chance de neve, enquanto 100 significa que a neve é certa.
temperature	WeatherValue	A temperatura esperada para a hora especificada, medida em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.
totalLiquid	WeatherValue	Retorna a quantidade total de precipitação líquida (como chuva) esperada a cada hora do período de previsão, medida em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.
uvIndex	integer (int32)	Fornece o índice ultravioleta (UV) para cada hora do período de previsão. Este índice indica o nível de radiação ultravioleta esperado, ajudando os usuários a entender o risco potencial de exposição ao sol em diferentes horários do dia. Os valores com suporte são: 0-2: Baixo perigo dos raios UV do sol ou da pessoa comum. 3-5: Risco moderado de danos por exposição solar desprotegida. 6-7: Alto risco de danos por exposição solar desprotegida. 8-10: Risco muito alto de danos por exposição solar desprotegida. 11+: Risco extremo de danos por exposição solar desprotegida.
uvIndexPhrase	string	Fornece uma frase descritiva que indica o nível de radiação UV, como Baixo, Moderado, Alto ou Muito Alto.
visibility	WeatherValue	Retorna a distância na qual um objeto ou luz pode ser claramente discernida para cada hora do período de previsão, medida em quilômetros (km) ou milhas (mi), dependendo da unidade especificada no pedido. Isso indica até onde se pode enxergar claramente, o que é crucial para atividades como dirigir e aviação.
wetBulbTemperature	WeatherValue	Devolve a temperatura que um pacote de ar teria se fosse resfriado até a saturação (100% da umidade relativa) pela evaporação da água para dentro dele. Essa propriedade é importante para entender o estresse térmico e o efeito de resfriamento da evaporação.
wind	WindDetails	Fornece a velocidade e direção esperadas do vento. A velocidade do vento é medida em quilômetros por hora (km/h) ou milhas por hora (mph), com base na unidade especificada. A direção do vento é medida em graus de azimute, variando de 0° (norte verdadeiro) a 359°, movendo-se no sentido horário (leste é 90°, sul está a 180°, oeste a 270°).
windGust	WindDetails	Retorna a velocidade máxima esperada de rajada de vento durante cada hora do período de previsão, medida em quilômetros por hora (km/h) ou milhas por hora (mph), com base na unidade especificada. A direção do vento é dada em graus de azimute, variando de 0° (norte verdadeiro) a 359°, movendo-se no sentido horário. Rajadas de vento são aumentos breves na velocidade do vento, importantes para entender variações de curto prazo que podem impactar atividades como aviação, vela e eventos ao ar livre.

HourlyForecastResult

Objeto

A resposta retornava pela operação Get Hourly Forecast, contendo previsões meteorológicas hora a hora para um local específico. O número de HourlyForecast inscrições retornadas corresponde à duração prevista solicitada - uma de 1, 12, 24, 48, 72 ou 96 horas (veja a HourlyDuration união).

Nome	Tipo	Description
forecasts	HourlyForecast[]	As entradas de previsão hora a hora, uma por hora na janela solicitada, em ordem cronológica. Cada entrada traz a temperatura esperada, RealFeel, ponto de orvalho, vento, previsão de precipitação (probabilidade e quantidades de chuva, neve e gelo), cobertura de nuvens, visibilidade, índice UV, teto e outras observações para aquela hora. Por exemplo, uma duração de 12 retorna 12 entradas a partir de 2019-11-14T16:00:00-08:00 e avançando uma hora de cada vez.

IconCode

Enumeração

O código numérico de condição climática que identifica qual ícone exibir. Cada valor nessa enumeração corresponde a um ícone meteorológico do Azure Mapas (como Sunny, Cloudy ou Thunderstorms) e é pareado com um ícone iconPhrase humano retornado junto com ele. O mesmo código pode aparecer em respostas atuais, horárias, diárias, trimestrais e minuto a minuto, permitindo que aplicações exibam um conjunto de ícones consistente em todos os serviços meteorológicos.

Para a lista completa de códigos, os ícones para os quais eles se mapeiam e imagens de exemplo, veja Serviços de Clima no Azure Mapas.

Valor	Description
1	Sunny
2	Sol e poucas nuvens
3	Parcialmente ensolarado
4	Nuvens intermitentes
5	Sol entre nuvens
6	Parcialmente nublado
7	Cloudy
8	Cinzento (Nublado)
11	Fog
12	Showers
13	Parcialmente nublado com pancadas de chuva
14	Parcialmente ensolarado com pancadas de chuva
15	Thunderstorms
16	Parcialmente nublado com trovoadas
17	Parcialmente nublado com possibilidade de trovoadas
18	Rain
19	Flurries
20	Parcialmente nublado com chuva rápida
21	Parcialmente ensolarado com chuva rápida
22	Snow
23	Parcialmente nublado com neve
24	Gelo
25	Sleet
26	Chuva congelante
29	Chuva e neve
30	Hot
31	Cold
32	Windy
33	Limpar
34	Predominantemente limpo
35	Períodos de céu nublado
36	Nuvens intermitentes
37	Luar enevoado
38	Parcialmente nublado
39	Parcialmente nublado com pancadas de chuva
40	Parcialmente nublado com pancadas de chuva
41	Parcialmente nublado com tempestades de trovão
42	Parcialmente nublado com trovoadas
43	Parcialmente nublado com chuva rápida
44	Parcialmente nublado com neve

JsonFormat

Enumeração

Formato desejado da resposta. Há suporte apenas para json formato.

Valor	Description
json	o formato de intercâmbio de dados de notação de objeto JavaScript

UnitType

Enumeração

Um valor inteiro associado ao tipo de unidade exibida. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para mais informações, veja Serviços meteorológicos em Azure Mapas.

Valor	Description
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	medidor
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	Celsius
18	Fahrenheit
19	kelvin
20	percent
21	derivar
22	inteiro
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeração

Especifica se deve-se devolver dados em unidades métricas ou imperiais, tendo métrica como padrão. Por exemplo:

Métrica: milímetro (mm), metro (m), quilômetro (km), Celsius (C)
Imperial: polegada (in), pé (pé), milha (mi), Fahrenheit (F)

Valor	Description
imperial	Retorne dados usando unidades imperiais como Fahrenheit (F) para temperatura e milhas (mi) para distância.
metric	Retorne dados usando unidades métricas como Celsius (C) para temperatura e quilômetro (km) para distância.

WeatherValue

Objeto

Valores para métricas relacionadas ao clima, como temperatura, ponto de orvalho e velocidade do vento, apresentados em unidades métricas ou imperiais, conforme especificado no parâmetro URI unitário. Para mais informações, veja Tipos de Unidades no artigo Serviços meteorológicos no Azure Mapas.

Nome	Tipo	Description
unit	string	A unidade de medida usada no valor de retorno, como "C" para Celsius, "F" para Fahrenheit.
unitType	UnitType	Um inteiro representando o tipo de unidade. Por exemplo, 0 para pés, 1 para polegadas, 2 para milhas. Para uma lista completa, veja Tipos de Unidades no artigo Serviços meteorológicos no Azure Mapas.
value	number (float)	O valor medido expresso na unidade especificada.

WindDetails

Objeto

Fornece a velocidade prevista do vento, medida em unidades como quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido. Também indica a direção do vento medida em graus de azimute, começando no norte verdadeiro e movendo-se no sentido horário. O norte corresponde a 0°, leste a 90°, sul a 180° e oeste a 270°. Os valores possíveis variam de 0° a 359°.

Nome	Tipo	Description
direction	WindDirection	A direção do vento é medida em graus de azimute, começando no verdadeiro Norte (0°) e movendo-se no sentido horário. Leste corresponde a 90°, sul a 180° e oeste a 270°. Os valores possíveis variam de 0° a 359°. Essa propriedade retorna um inteiro representando a direção do vento.
speed	WeatherValue	A velocidade esperada do vento, medida em quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido.

WindDirection

Objeto

Fornece detalhes sobre a direção do vento, incluindo a direção em graus de azimute e uma abreviação localizada da direção do vento.

Nome	Tipo	Description
degrees	integer (int32)	A direção do vento é medida em graus de azimute, começando no norte verdadeiro e movendo-se no sentido horário. Norte corresponde a 0 graus, leste a 90 graus, sul a 180 graus e oeste a 270 graus. Os valores possíveis variam de 0 a 359 graus.
localizedDescription	string	Uma abreviação localizada da direção do vento, retornada no idioma especificado no pedido. Por exemplo, `N` para Norte, `E` para Leste, `S` para Sul e `W` para Oeste.