Weather - Get Daily Forecast

Serviço:: Maps

Versão da API:: 1.1

Use para obter uma previsão do tempo diária detalhada para os próximos 1, 5, 10, 15, 25 ou 45 dias.
A Get Daily Forecast API é uma solicitação HTTP GET que retorna previsões meteorológicas detalhadas, como temperatura e vento por dia, para os próximos 1, 5, 10, 15, 25 ou 45 dias para um determinado local de coordenadas. A resposta inclui detalhes como temperatura, vento, precipitação, qualidade do ar e índice UV. Para obter mais informações, consulte Solicitar dados diários de previsão do tempo.

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

Com parâmetros opcionais:

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

Parâmetros do URI

Nome	Em	Obrigatório	Tipo	Descrição
endpoint	path	True	string (uri)	O nome de host do serviço Azure Maps. Usa `https://atlas.microsoft.com` para a Azure cloud pública. Para direcionar uma geografia Azure Maps específica ou uma nuvem soberana, veja Azure Maps âmbito geográfico.
format	path	True	JsonFormat	Formato desejado da resposta. Apenas `json` formato é suportado.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.
query	query	True	number[]	A consulta aplicável especificada como uma cadeia de caracteres separada por vírgulas composta por latitude seguida de longitude, por exemplo, "47.641268,-122.125679". As informações meteorológicas estão geralmente disponíveis para locais em terra, corpos de água cercados por terra e áreas do oceano que estão a aproximadamente 50 milhas náuticas de uma costa.
duration	query		integer (int32)	Especifica por quantos dias as respostas de previsão diárias são retornadas. Os valores disponíveis são `1` - Dados de previsão de retorno para o dia seguinte. Retornado por padrão. `5` - Devolver dados de previsão para os próximos 5 dias. `10` - Devolver dados de previsão para os próximos 10 dias. `25` - Dados de previsão de retorno para os próximos 25 dias. `45` - Dados de previsão de retorno para os próximos 45 dias.
language	query		string	Idioma em que os resultados da pesquisa devem ser retornados. Deve ser uma das tags de idioma IETF suportadas, sem distinção entre maiúsculas e 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 suportados para obter detalhes.
unit	query		WeatherDataUnit	Especifica para retornar os dados em unidades métricas ou unidades imperiais. O valor padrão é métrico.

Cabeçalho do Pedido

Nome	Obrigatório	Tipo	Descrição
x-ms-client-id		string	Indica a conta destinada a ser utilizada com o modelo de segurança do Microsoft Entra ID. Este ID único para a conta Azure Maps pode ser obtido a partir da API da conta Azure Maps plano de gestão. Para mais informações sobre o uso da segurança Microsoft Entra ID em Azure Maps, consulte Gerir autenticação em Azure Maps.

Respostas

Nome	Tipo	Descrição
200 OK	DailyForecastResult	O pedido foi bem-sucedido.
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 controlo Azure baseado em funções, pode ser usado para controlar o acesso a APIs REST Azure Maps. Os controlos de acesso baseados em papéis do Azure são usados para designar o acesso a uma ou mais contas ou subrecursos de recursos do Azure Maps. 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 Maps.

Para implementar cenários, recomendamos a visualização conceitos de autenticação. Em resumo, essa definição de segurança fornece uma solução para modelar aplicativos(s) por meio de objetos capazes de controle de 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 Maps o aplicativo está solicitando acesso. Isso pode ser adquirido na API de gerenciamento do Maps.
O Authorization URL é específico para a instância de nuvem pública do Azure. As clouds soberanas têm URLs de Autorização e configurações de Microsoft Entra ID únicas.
O controle de acesso baseado em função do Azure é configurado a partir do plano de gerenciamento do Azure por meio do portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.
O uso do SDK da Web do Azure Maps 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
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Nome	Descrição
https://atlas.microsoft.com/.default

subscription-key

Esta é uma chave compartilhada que é provisionada quando você Criar uma conta do Azure Maps no portal do Azure ou usando PowerShell, CLI, SDKs do Azure ou API REST.

Com essa chave, qualquer aplicativo pode acessar todas as APIs REST. Em outras palavras, essa chave pode ser usada como uma chave mestra na conta em que eles são emitidos.

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

Tipo: apiKey
Em: header

SAS Token

Este é um token de assinatura de acesso compartilhado criado a partir da operação Listar SAS no de recursos do Azure Maps por meio do plano de gerenciamento do Azure por meio do portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.

Com esse token, qualquer aplicativo é autorizado a acessar com controles de acesso baseados em função do Azure e controle de grão fino para a expiração, taxa e região(ões) 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 segura 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 do Map para limitar o abuso de renderização e renovar regularmente o Token SAS.

Tipo: apiKey
Em: header

Exemplos

Successfully retrieve detailed daily weather forecast for a given coordinate location

Pedido de amostra

HTTP

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Resposta da amostra

Código de estado:: 200

{
  "forecasts": [
    {
      "airAndPollen": [
        {
          "name": "AirQuality",
          "type": "Ozone",
          "category": "Good",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Grass",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Mold",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Ragweed",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Tree",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "UVIndex",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        }
      ],
      "date": "2019-11-13T21:00:00-08:00",
      "day": {
        "cloudCover": 100,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationIntensity": "Light",
        "precipitationProbability": 75,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "rainProbability": 75,
        "shortPhrase": "Cloudy with a few showers",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 20,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 16.7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 48.2
          }
        }
      },
      "degreeDaySummary": {
        "cooling": {
          "unit": "C",
          "unitType": 17,
          "value": 0
        },
        "heating": {
          "unit": "C",
          "unitType": 17,
          "value": 15
        }
      },
      "hoursOfSun": 1.1,
      "night": {
        "cloudCover": 98,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationIntensity": "Light",
        "precipitationProbability": 65,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "rainProbability": 64,
        "shortPhrase": "Breezy early; cloudy",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 0,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 20.4
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 42.6
          }
        }
      },
      "realFeelTemperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "realFeelTemperatureShade": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.6
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "sources": [
        "AccuWeather"
      ],
      "temperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 5.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": 0.8
        }
      }
    }
  ],
  "summary": {
    "category": "rain",
    "endDate": "2019-11-17T15:00:00-08:00",
    "phrase": "Rain Sunday evening",
    "severity": 5,
    "startDate": "2019-11-17T09:00:00-08:00"
  }
}

Definições

Nome	Descrição
AirAndPollen	Uma entrada descreve `DailyForecast.airAndPollen` um único indicador de pólen, qualidade do ar ou índice UV para o dia. A `name` propriedade determina que tipo de indicador a entrada representa: Pólen: `name` é Árvore, Relva, Ambrosia ou Bolor. `value` indica o valor previsto e `category` / `categoryValue` avalia-o de Baixo para Alto. Qualidade do ar: `name` é qualidade do ar e `type` identifica o poluente a ser medido (um dos PM2.5, PM10, O3, NO2, SO2 ou CO). `category` / `categoryValue` avalie a qualidade do ar de Boa para Perigosa. Índice UV: `name` é UVIndex. `value` é o índice UV (0 a 11+), e `category` / `categoryValue` avalia o risco de exposição de Baixo a Extremo. `category` é o rótulo qualitativo do indicador e `categoryValue` é a classificação correspondente de 1 a 6, onde 1 indica as condições mais seguras e 6 as mais perigosas.
DailyForecast	A previsão para um dia civil no local especificado devolveu como uma entrada por dia no `forecasts` array em `DailyForecastResult`. Inclui a gama de temperaturas altas/baixas do dia, intervalos RealFeel (regulares e sombreados), horas esperadas de sol, totais de graus por dia de aquecimento/arrefecimento, uma variedade de indicadores de qualidade do ar, pólen e índice UV, e blocos de detalhe separados para as partes diurnas e noturnas do dia (precipitação, vento, cobertura de nuvens e mais). O `sources` array lista os fornecedores de dados que contribuem para a previsão.
DailyForecastDetail	Previsão detalhada para meio dia. A mesma forma é usada para ambos `DailyForecast.day` (do nascer ao pôr do sol) e `DailyForecast.night` (do pôr do sol ao nascer seguinte), por isso todas as referências a "este período" abaixo referem-se àquela parte específica do dia ou da noite – nunca ao dia completo de 24 horas. Inclui um ícone de previsão e frases, tipo / intensidade / probabilidade de precipitação, totais de acumulação, horas de precipitação, vento e cobertura de nuvens.
DailyForecastResult	A resposta foi dada pela operação Get Daily Forecast, fornecendo uma previsão meteorológica diária para um local específico. Inclui um nível `summary` superior que descreve as condições dominantes e a gravidade para a janela solicitada, além de um `forecasts` array com uma `DailyForecast` entrada por dia. O número de inscrições corresponde ao pedido `duration` (1, 5, 10, 15, 25 ou 45 dias; 25 e 45 requerem um SKU S1).
DailyForecastSummary	Um resumo geral das condições meteorológicas dominantes em parte ou na totalidade da janela de previsão diária solicitada. A janela resumida pode ser mais estreita do que o pedido completo – por exemplo, quando se espera tempo significativo (como um sistema de tempestade) apenas durante uma parte do período – e é delimitada por `startDate` e `endDate`. As próprias condições são descritas tanto como uma forma `phrase`livre, um rótulo de uma ou duas palavras `category` e uma classificação numérica `severity` .
DegreeDaySummary	Os totais de grau-dia de aquecimento e arrefecimento para um único dia, usados para estimar a procura de energia para aquecimento ou arrefecimento de um edifício. Cada valor é o número de graus em que a temperatura média do dia difere da linha de base de 65°F (18°C ), na unidade de temperatura especificada no pedido - graus abaixo da linha de base contribuem para `heating`, graus acima dela contribuem para `cooling`.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro comum para todas as APIs do Azure Resource Manager devolver detalhes de erro para operações falhadas. (Isso também segue o formato de resposta de erro OData.)
IconCode	O código numérico de condição meteorológica que identifica qual ícone a exibir. Cada valor nesta enumeração corresponde a um ícone meteorológico do Azure Maps (como Sunny, Cloudy ou Thunderstorms) e é emparelhado com um ícone `iconPhrase` legível para humanos devolvido ao lado. O mesmo código pode aparecer em respostas atuais, horárias, diárias, trimestrais e minuto a minuto, permitindo que as aplicações exibam um conjunto de ícones consistente em todos os serviços meteorológicos. Para a lista completa de códigos, os ícones a que correspondem e imagens de exemplo, consulte Serviços meteorológicos no Azure Maps.
JsonFormat	Formato desejado da resposta. Apenas `json` formato é suportado.
LocalSource	Informação sobre um fornecedor local de dados meteorológicos utilizada para obter a previsão em `DailyForecastDetail.localSource`. Identifica o fornecedor (`id`, `name`) e expõe o perfil nativo `weatherCode` do fornecedor para que as aplicações possam renderizar o próprio conjunto de ícones do fornecedor em vez dos ícones padrão do Azure Maps.
PrecipitationType	Especifica o tipo de precipitação. Os valores válidos são Chuva, Neve, Gelo ou Mistura. Esta propriedade é incluída na resposta quando dBZ é maior que zero.
UnitType	Um valor inteiro associado ao tipo de unidade que está a ser apresentada. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para mais informações, consulte Serviços meteorológicos em Azure Maps.
WeatherDataUnit	Especifica se deve 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 (polegada), pé (pé), milha (mi), Fahrenheit (F)
WeatherValue	Valores para métricas relacionadas com o clima, como temperatura, ponto de orvalho e velocidade do vento, apresentados em unidades métricas ou imperiais, conforme especificado no parâmetro unitário URI. Para mais informações, veja Tipos de Unidades no artigo Serviços meteorológicos no Azure Maps.
WeatherValueRange	Fornece as temperaturas mais altas e mais baixas previstas para o período de tempo especificado, medidas em graus Celsius (°C) ou Fahrenheit (°F), com base na unidade especificada no pedido.
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 dos ponteiros do relógio. Norte corresponde a 0°, a leste a 90°, a sul a 180° e a 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 abreviatura localizada da direção do vento.

AirAndPollen

Object

Uma entrada descreve DailyForecast.airAndPollen um único indicador de pólen, qualidade do ar ou índice UV para o dia. A name propriedade determina que tipo de indicador a entrada representa:

Pólen: name é Árvore, Relva, Ambrosia ou Bolor. value indica o valor previsto e category / categoryValue avalia-o de Baixo para Alto.
Qualidade do ar: name é qualidade do ar e type identifica o poluente a ser medido (um dos PM2.5, PM10, O3, NO2, SO2 ou CO). category / categoryValue avalie a qualidade do ar de Boa para Perigosa.
Índice UV: name é UVIndex. value é o índice UV (0 a 11+), e category / categoryValue avalia o risco de exposição de Baixo a Extremo.

category é o rótulo qualitativo do indicador e categoryValue é a classificação correspondente de 1 a 6, onde 1 indica as condições mais seguras e 6 as mais perigosas.

Nome	Tipo	Descrição
category	string	Um breve rótulo qualitativo para o indicador, devolvido na linguagem especificada no pedido. Os valores possíveis dependem de `name`: Pólen: Baixo, Moderado, Alto ou Muito Alto. Qualidade do ar: Bom, Moderada, Pouco saudável para grupos sensíveis, Pouco saudável, Muito Pouco saudável ou Perigosa. Índice UV: Baixo, Moderado, Alto, Muito Alto ou Extremo.
categoryValue	integer (int32)	Uma classificação numérica de 1 a 6 que se emparelha com `category`, onde 1 indica as condições mais seguras e 6 as mais perigosas. Use isto quando for necessário um valor numérico estável e independente da língua em vez do rótulo localizado `category` .
name	string	Identifica qual o indicador que esta entrada representa. Seja o nome de uma fonte de pólen (Árvore, Relva, Ambrosia ou Bolor), Qualidade do Ar (nesse caso `type` identifica o poluente) ou UVIndex.
type	string	Quando `name` é a Qualidade do Ar, o poluente específico que está a ser medido um de PM2.5, PM10, O3 (ozono), NO2 (dióxido de azoto), SO2 (dióxido de enxofre) ou CO (monóxido de carbono). Não devolvido para entradas de pólen ou índice UV.
value	integer (int32)	A medição numérica para este indicador. A unidade depende de `name`: Para o pólen, a previsão do pólen. Para a qualidade do ar, a concentração do poluente em unidades apropriadas ao poluente – tipicamente microgramas por metro cúbico (μg/m³) para partículas e partes por bilião (ppb) para gases como o ozono. Para o índice UV, um valor de índice de 0 a 11+. Tanto a qualidade do ar como o índice UV são índices, por isso são reportados como números sem unidades.

DailyForecast

Object

A previsão para um dia civil no local especificado devolveu como uma entrada por dia no forecasts array em DailyForecastResult. Inclui a gama de temperaturas altas/baixas do dia, intervalos RealFeel (regulares e sombreados), horas esperadas de sol, totais de graus por dia de aquecimento/arrefecimento, uma variedade de indicadores de qualidade do ar, pólen e índice UV, e blocos de detalhe separados para as partes diurnas e noturnas do dia (precipitação, vento, cobertura de nuvens e mais). O sources array lista os fornecedores de dados que contribuem para a previsão.

Nome	Tipo	Descrição
airAndPollen	AirAndPollen[]	Previsão de qualidade do ar, pólen e indicadores de índice UV para o dia. Cada entrada reporta um nome (como Árvore, Relva, Ambrosia, Bolor, Qualidade do Ar ou UVIndex), um valor numérico e um valor qualitativo `category` (como Baixo, Moderado, Alto, Bom, Insalubre ou Perigoso) para que as aplicações possam sinalizar potenciais riscos para a saúde.
date	string (date-time)	A data do calendário que esta previsão cobre, no formato ISO 8601 (`yyyy-mm-ddThh:mm:ss-hh:mm`). Por exemplo, 2025-04-29T07:00:00-07:00.
day	DailyForecastDetail	A previsão detalhada para a parte diurna do dia – incluindo temperatura, precipitação, vento, cobertura de nuvens e outros atributos chave.
degreeDaySummary	DegreeDaySummary	Totais de graus por dia de aquecimento e arrefecimento para o dia, usados para estimar a procura energética para controlo climático de edifícios.
hoursOfSun	number (float)	O número esperado de horas de sol durante o dia, útil para planear atividades ao ar livre e avaliar as condições gerais durante o dia.
night	DailyForecastDetail	A previsão detalhada para a parte noturna do dia - incluindo temperatura, precipitação, vento, cobertura de nuvens e outros atributos chave.
realFeelTemperature	WeatherValueRange	Os valores de temperatura RealFeel™ elevados e baixos para o dia, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Desenvolvido pela AccuWeather, o RealFeel combina a temperatura do ar com humidade, vento, cobertura de nuvens, intensidade solar e outros fatores para indicar como o tempo realmente se sente. Para mais informações, veja Qual é a temperatura AccuWeather RealFeel?
realFeelTemperatureShade	WeatherValueRange	Os valores de temperatura RealFeel™ altos e baixos para o dia em áreas sombreadas, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Tal como `realFeelTemperature`, mas exclui o efeito de aquecimento da luz solar direta, dando uma noção mais precisa de como o tempo se sente à sombra.
sources	string[]	Os fornecedores de dados que contribuíram para a previsão deste dia.
temperature	WeatherValueRange	As temperaturas máximas e mínimas previstas para o dia, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.

DailyForecastDetail

Object

Previsão detalhada para meio dia. A mesma forma é usada para ambos DailyForecast.day (do nascer ao pôr do sol) e DailyForecast.night (do pôr do sol ao nascer seguinte), por isso todas as referências a "este período" abaixo referem-se àquela parte específica do dia ou da noite – nunca ao dia completo de 24 horas. Inclui um ícone de previsão e frases, tipo / intensidade / probabilidade de precipitação, totais de acumulação, horas de precipitação, vento e cobertura de nuvens.

Nome	Tipo	Descrição
cloudCover	integer (int32)	A percentagem do céu coberta por nuvens durante este período, de 0 (céu limpo) a 100 (completamente nublado). Pode ser NULL.
hasPrecipitation	boolean	`true` se for esperada precipitação (chuva, neve, granizo ou granizo) durante este período; `false` caso contrário.
hoursOfIce	number (float)	O número total de horas durante este período em que se espera a formação de gelo.
hoursOfPrecipitation	number (float)	O número total de horas durante este período em que se espera qualquer precipitação (chuva, neve, granizo ou granizo).
hoursOfRain	number (float)	O número total de horas durante este período em que se espera chuva.
hoursOfSnow	number (float)	O número total de horas durante este período em que se espera neve.
ice	WeatherValue	A quantidade de acumulação de gelo prevista durante este período, em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.
iceProbability	integer (int32)	A probabilidade de formação de gelo durante este período, expressa como percentagem de 0 a 100, onde 0 significa que não há hipótese de gelo e 100 significa que condições de gelo são certas.
iconCode	IconCode	Valor numérico que representa uma imagem que corresponde à condição meteorológica prevista para este período, descrita pela `iconPhrase` propriedade. O valor numérico corresponde a um ícone meteorológico do Azure Maps – para a lista completa, veja Serviços meteorológicos no Azure Maps. Pode ser NULL.
iconPhrase	string	Uma frase curta que descreve o ícone, devolvida na língua especificada no pedido. Por exemplo, Sunny.
localSource	LocalSource	Informação sobre o fornecedor local de dados meteorológicos cujo código de ícones e código meteorológico foram usados para este período, quando um foi selecionado.
longPhrase	string	Uma frase mais longa e descritiva para este período, devolvida na língua especificada no pedido. O Azure Maps tenta manter esta frase abaixo dos 100 caracteres, mas algumas línguas ou eventos meteorológicos podem produzir uma sequência mais longa.
precipitationIntensity	string	Uma breve descrição qualitativa da intensidade da precipitação para este período – por exemplo, Leve, Moderada ou Intensa. Devolvido na linguagem especificada no pedido, e só quando `hasPrecipitation` é `true`.
precipitationProbability	integer (int32)	A probabilidade de qualquer precipitação durante este período, expressa como percentagem de 0 a 100, onde 0 significa que não há hipótese de precipitação e 100 significa que a precipitação é certa.
precipitationType	PrecipitationType	O tipo dominante de precipitação esperado neste período é de chuva, neve, gelo ou mistura. Retornado apenas quando `hasPrecipitation` é `true`.
rain	WeatherValue	A quantidade de precipitação prevista durante este período, em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.
rainProbability	integer (int32)	A probabilidade de chuva durante este período, expressa como percentagem de 0 a 100, onde 0 significa que não há hipótese de chuva e 100 significa que chuva é certa.
shortPhrase	string	Uma frase curta que descreve a previsão para este período, devolvida na linguagem especificada no pedido. O Azure Maps tenta manter esta frase abaixo dos 30 caracteres, mas algumas línguas ou eventos meteorológicos podem produzir uma sequência mais longa.
snow	WeatherValue	A quantidade de acumulação de neve prevista durante este período, em centímetros (cm) ou polegadas (in), dependendo da unidade especificada no pedido.
snowProbability	integer (int32)	A probabilidade de neve durante este período, expressa como percentagem de 0 a 100, onde 0 significa que não há hipótese de neve e 100 significa que neve é certa.
thunderstormProbability	integer (int32)	A probabilidade de uma trovoada durante este período, expressa como percentagem de 0 a 100, onde 0 significa que não há hipótese de trovoada e 100 significa que uma trovoada é certa.
totalLiquid	WeatherValue	A quantidade total de precipitação líquida (como chuva, mais o equivalente líquido de qualquer neve ou gelo) esperada durante este período, em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.
wind	WindDetails	A velocidade e direção do vento previstas para este período. A velocidade do vento está em quilómetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido. A direção do vento é medida em graus de azimute, de 0° (norte verdadeiro) a 359°, movendo-se no sentido dos ponteiros do relógio - a leste a 90°, sul a 180°, oeste a 270°.
windGust	WindDetails	A velocidade e direção máxima esperada de vento de rajada curta durante este período. Rajadas de vento são aumentos súbitos e breves na velocidade do vento que são importantes para atividades como aviação, vela e voo de pipas. A velocidade está em quilómetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido, e a direção usa a mesma convenção de azimute que `wind`.

DailyForecastResult

Object

A resposta foi dada pela operação Get Daily Forecast, fornecendo uma previsão meteorológica diária para um local específico. Inclui um nível summary superior que descreve as condições dominantes e a gravidade para a janela solicitada, além de um forecasts array com uma DailyForecast entrada por dia. O número de inscrições corresponde ao pedido duration (1, 5, 10, 15, 25 ou 45 dias; 25 e 45 requerem um SKU S1).

Nome Tipo Descrição

forecasts

Nome	Tipo	Descrição
forecasts	DailyForecast[]	As previsões por dia, por ordem cronológica, com uma entrada por dia no pedido `duration`. Cada entrada reporta `DailyForecast` as temperaturas máximas/mínimas do dia, intervalo RealFeel, horas de sol, totais de graus por dia de aquecimento/arrefecimento, índices de ar e pólen, blocos de detalhe separados de dia e noite (precipitação, vento, cobertura de nuvens, entre outros), e as fontes de dados que contribuem para a previsão.
summary	DailyForecastSummary	Um resumo geral das condições meteorológicas dominantes ao longo da janela de previsão solicitada. O resumo pode cobrir apenas parte da janela por exemplo, quando se espera tempo significativo (como um sistema de tempestades) durante uma parte do período – em vez de durante todo o período.

DailyForecast[]

As previsões por dia, por ordem cronológica, com uma entrada por dia no pedido duration. Cada entrada reporta DailyForecast as temperaturas máximas/mínimas do dia, intervalo RealFeel, horas de sol, totais de graus por dia de aquecimento/arrefecimento, índices de ar e pólen, blocos de detalhe separados de dia e noite (precipitação, vento, cobertura de nuvens, entre outros), e as fontes de dados que contribuem para a previsão.

summary

DailyForecastSummary

Um resumo geral das condições meteorológicas dominantes ao longo da janela de previsão solicitada. O resumo pode cobrir apenas parte da janela

por exemplo, quando se espera tempo significativo (como um sistema de tempestades) durante uma parte do período – em vez de durante todo o período.

DailyForecastSummary

Object

Um resumo geral das condições meteorológicas dominantes em parte ou na totalidade da janela de previsão diária solicitada. A janela resumida pode ser mais estreita do que o pedido completo – por exemplo, quando se espera tempo significativo (como um sistema de tempestade) apenas durante uma parte do período – e é delimitada por startDate e endDate. As próprias condições são descritas tanto como uma forma phraselivre, um rótulo de uma ou duas palavras category e uma classificação numérica severity .

Nome	Tipo	Descrição
category	string	Uma etiqueta de uma ou duas palavras que categoriza as condições meteorológicas dominantes para a janela resumida – por exemplo, Ensolarado, Parcialmente Nublado, Chuva ou Neve.
endDate	string (date-time)	O fim da janela coberto por este resumo, no formato RFC 3339 - por exemplo, 2019-10-29T07:00:00-08:00. Pode ser anterior ao fim da janela de previsão solicitada se o evento resumido terminar antes dela.
phrase	string	Um breve resumo textual livre das condições meteorológicas dominantes para a janela resumida, devolvido na linguagem especificada no pedido. Por exemplo, espera-se aguaceiros de terça a quinta-feira.
severity	integer (int32)	Uma classificação numérica de gravidade para o evento meteorológico resumido. Números mais baixos ( excluindo 0) indicam maior gravidade: 0: Desconhecido 1: Significativo 2: Major 3: Moderado 4: Menor 5: Mínimo 6: Insignificante 7: Informativo
startDate	string (date-time)	O início da janela abordada por este resumo, no formato RFC 3339 - por exemplo, 2019-10-27T19:39:57-08:00. Pode ser mais tarde do que o início da janela de previsão solicitada se o evento resumido começar a meio dela.

DegreeDaySummary

Object

Os totais de grau-dia de aquecimento e arrefecimento para um único dia, usados para estimar a procura de energia para aquecimento ou arrefecimento de um edifício. Cada valor é o número de graus em que a temperatura média do dia difere da linha de base de 65°F (18°C ), na unidade de temperatura especificada no pedido - graus abaixo da linha de base contribuem para heating, graus acima dela contribuem para cooling.

Nome	Tipo	Descrição
cooling	WeatherValue	Dias de Arrefecimento (CDD) - o número de graus em que a temperatura média do dia sobe acima da linha base de 65°F (18°C). Valores mais elevados indicam uma maior procura de arrefecimento. Reportado em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.
heating	WeatherValue	Dias de Aquecimento (HDD) - o número de graus em que a temperatura média do dia fica abaixo da linha base de 65°F (18°C). Valores mais elevados indicam uma maior procura de aquecimento. Reportado em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

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

ErrorDetail

Object

O detalhe do erro.

Nome	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
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

Object

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

Nome	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

IconCode

Enumeração

O código numérico de condição meteorológica que identifica qual ícone a exibir. Cada valor nesta enumeração corresponde a um ícone meteorológico do Azure Maps (como Sunny, Cloudy ou Thunderstorms) e é emparelhado com um ícone iconPhrase legível para humanos devolvido ao lado. O mesmo código pode aparecer em respostas atuais, horárias, diárias, trimestrais e minuto a minuto, permitindo que as aplicações exibam um conjunto de ícones consistente em todos os serviços meteorológicos.

Para a lista completa de códigos, os ícones a que correspondem e imagens de exemplo, consulte Serviços meteorológicos no Azure Maps.

Valor	Descrição
1	Sunny
2	Principalmente ensolarado
3	Parcialmente ensolarado
4	Nuvens intermitentes
5	Sol nebuloso
6	Principalmente nublado
7	Cloudy
8	Sombrio (nublado)
11	Fog
12	Showers
13	Principalmente nublado com chuveiros
14	Parcialmente ensolarado com chuva
15	Thunderstorms
16	Principalmente nublado com trovoadas
17	Parcialmente ensolarado com trovoadas
18	Rain
19	Flurries
20	Principalmente nublado com neve fraca
21	Parcialmente ensolarado com neve fraca
22	Snow
23	Principalmente nublado com neve
24	Ice
25	Sleet
26	Chuva congelada
29	Chuva e neve
30	Hot
31	Cold
32	Windy
33	Limpar
34	Maioritariamente limpo
35	Parcialmente Nublado
36	Nuvens intermitentes
37	Luar nebuloso
38	Principalmente nublado
39	Parcialmente nublado com chuveiros
40	Principalmente nublado com chuveiros
41	Parcialmente nublado com trovoadas
42	Principalmente nublado com trovoadas
43	Principalmente nublado com neve fraca
44	Principalmente nublado com neve

JsonFormat

Enumeração

Formato desejado da resposta. Apenas json formato é suportado.

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

LocalSource

Object

Informação sobre um fornecedor local de dados meteorológicos utilizada para obter a previsão em DailyForecastDetail.localSource. Identifica o fornecedor (id, name) e expõe o perfil nativo weatherCode do fornecedor para que as aplicações possam renderizar o próprio conjunto de ícones do fornecedor em vez dos ícones padrão do Azure Maps.

Nome	Tipo	Descrição
id	integer (int32)	Um identificador numérico que identifica de forma única o fornecedor local de dados.
name	string	O nome do fornecedor local de dados, devolvido na língua especificada no pedido quando disponível; caso contrário, devolvido em inglês ou na língua em que o fornecedor o forneceu.
weatherCode	string	O código meteorológico nativo do fornecedor para esta previsão, adequado para mapear para o conjunto de ícones do próprio fornecedor em vez do Azure Maps `iconCode`padrão.

PrecipitationType

Enumeração

Especifica o tipo de precipitação. Os valores válidos são Chuva, Neve, Gelo ou Mistura. Esta propriedade é incluída na resposta quando dBZ é maior que zero.

Valor	Descrição
Ice	Ice
Mix	Mix
Rain	Rain
Snow	Snow

UnitType

Enumeração

Um valor inteiro associado ao tipo de unidade que está a ser apresentada. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para mais informações, consulte Serviços meteorológicos em Azure Maps.

Valor	Descrição
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	float
22	número inteiro
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeração

Especifica se deve 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 (polegada), pé (pé), milha (mi), Fahrenheit (F)

Valor	Descrição
imperial	Devolve os 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

Object

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

Nome	Tipo	Descrição
unit	string	A unidade de medida usada no valor de retorno, como "C" para Celsius, "F" para Fahrenheit.
unitType	UnitType	Um inteiro que representa 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 Maps.
value	number (float)	O valor medido expresso na unidade especificada.

WeatherValueRange

Object

Fornece as temperaturas mais altas e mais baixas previstas para o período de tempo especificado, medidas em graus Celsius (°C) ou Fahrenheit (°F), com base na unidade especificada no pedido.

Nome	Tipo	Descrição
maximum	WeatherValue	Fornece a temperatura máxima para o período de tempo especificado, medida em graus Celsius (°C) ou Fahrenheit (°F), com base na unidade especificada no pedido.
minimum	WeatherValue	Fornece a temperatura mínima para o período de tempo especificado, medida em graus Celsius (°C) ou Fahrenheit (°F), com base na unidade especificada no pedido.

WindDetails

Object

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 dos ponteiros do relógio. Norte corresponde a 0°, a leste a 90°, a sul a 180° e a oeste a 270°. Os valores possíveis variam de 0° a 359°.

Nome	Tipo	Descrição
direction	WindDirection	A direção do vento é medida em graus de azimute, começando no verdadeiro Norte (0°) e movendo-se no sentido dos ponteiros do relógio. Este corresponde a 90°, a sul a 180°, e a oeste a 270°. Os valores possíveis variam de 0° a 359°. Esta propriedade devolve um inteiro que representa 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

Object

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

Nome	Tipo	Descrição
degrees	integer (int32)	A direção do vento é medida em graus de azimute, começando no norte verdadeiro e movendo-se no sentido dos ponteiros do relógio. Norte corresponde a 0 graus, este 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 abreviatura localizada da direção do vento, devolvida na língua especificada no pedido. Por exemplo, `N` para Norte, `E` para Este, `S` para Sul e `W` para Oeste.