Weather - Get Daily Forecast

Use para obter uma previsão meteorológica 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ão do tempo detalhada, 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}
GET {endpoint}/weather/forecast/daily/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)

Especifica por quantos dias as respostas diárias de previsão são retornadas. Os valores disponíveis são

  • 1 - Retornar dados de previsão para o dia seguinte. Devolvido por padrão.
  • 5 - Retorne os dados de previsão para os próximos 5 dias.
  • 10 - Retornar dados de previsão para os próximos 10 dias.
  • 25 - Retornar dados de previsão para os próximos 25 dias.
  • 45 - Retornar dados de previsão para os próximos 45 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

DailyForecastResult

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 daily weather forecast for a given coordinate location

Solicitação de exemplo

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

Resposta de exemplo

{
  "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 Description
AirAndPollen

Uma entrada descrevendo 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, grama, ambrosia ou mofo. value fornece o valor previsto e category / categoryValue avalie de Baixo para Alto.
  • Qualidade do ar: name é a qualidade do ar e type identifica o poluente que está sendo 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 avalie 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 retornou como uma entrada por dia no forecasts array em DailyForecastResult. Inclui a faixa de temperatura alta/baixa do dia, faixas RealFeel (regular e sombreada), horas esperadas de sol, totais de calor/resfriamento por dia de graus, uma variedade de indicadores de qualidade do ar, pólen e índice UV, além de blocos de detalhes separados para as partes diurnas e noturnas (precipitação, vento, cobertura de nuvens e mais). O sources array lista os provedores de dados que contribuem para a previsão.

DailyForecastDetail

Detalhes da previsão para meio dia. A mesma forma é usada tanto DailyForecast.day para (do nascer até o pôr do sol) e DailyForecast.night (do pôr do sol até o próximo nascer do sol), então todas as referências a "este período" abaixo se referem àquela parte específica do dia ou da noite – nunca o 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 retornada pela operação Get Daily Forecast, fornecendo uma previsão do tempo dia a dia para um local específico. Inclui um nível summary superior descrevendo as condições dominantes e a gravidade da janela solicitada, além de um forecasts array com uma DailyForecast entrada por dia. O número de inscrições corresponde ao solicitado duration (1, 5, 10, 15, 25 ou 45 dias; 25 e 45 exigem um SKU S1).

DailyForecastSummary

Um resumo em alto nível das condições climáticas dominantes em parte ou toda a janela de previsão diária solicitada. A janela resumida pode ser mais estreita que a solicitação completa – por exemplo, quando se espera tempo significativo (como um sistema de tempestade) durante apenas 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 .

DegreeDaySummary

Os totais de grau-dia de aquecimento e resfriamento para um único dia, usados para estimar a demanda de energia para aquecimento ou resfriamento 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

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.).

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.

LocalSource

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

PrecipitationType

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

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.

WeatherValueRange

Fornece as temperaturas mais altas e mais baixas previstas para o período 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 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.

AirAndPollen

Uma entrada descrevendo 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, grama, ambrosia ou mofo. value fornece o valor previsto e category / categoryValue avalie de Baixo para Alto.
  • Qualidade do ar: name é a qualidade do ar e type identifica o poluente que está sendo 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 avalie 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 Description
category

string

Um breve rótulo qualitativo para o indicador, retornado na linguagem especificada no pedido. Os valores possíveis dependem de name:

  • Pólen: baixo, moderado, alto ou muito alto.
  • Qualidade do ar: Boa, Moderada, Pouco saudável para grupos sensíveis, Pouco saudável, Muito Insalubre 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 combina com category, onde 1 indica as condições mais seguras e 6 as mais perigosas. Use isso 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 indicador essa entrada representa. Seja o nome de uma fonte de pólen (Árvore, Capim, Ambrosia ou Mofo), Qualidade do Ar (nesse type caso identifica o poluente) ou UVIndex.

type

string

Quando name é a Qualidade do Ar, o poluente específico que está sendo medido

  • um de PM2.5, PM10, O3 (ozônio), NO2 (dióxido de nitrogênio), SO2 (dióxido de enxofre) ou CO (monóxido de carbono). Não retornaram para entradas de pólen ou índice UV.
value

integer (int32)

A medição numérica para esse indicador. A unidade depende de name:

  • Para pólen, a previsão de contagem de pólen.
  • Para a qualidade do ar, a concentração de poluente em unidades apropriadas ao poluente – tipicamente microgramas por metro cúbico (μg/m³) para partículas e partes por bilhão (ppb) para gases como ozônio.
  • Para o índice UV, um valor de índice de 0 a 11+.

Tanto a qualidade do ar quanto o índice UV são índices, então são reportados como números sem unidades.

DailyForecast

A previsão para um dia civil no local especificado retornou como uma entrada por dia no forecasts array em DailyForecastResult. Inclui a faixa de temperatura alta/baixa do dia, faixas RealFeel (regular e sombreada), horas esperadas de sol, totais de calor/resfriamento por dia de graus, uma variedade de indicadores de qualidade do ar, pólen e índice UV, além de blocos de detalhes separados para as partes diurnas e noturnas (precipitação, vento, cobertura de nuvens e mais). O sources array lista os provedores de dados que contribuem para a previsão.

Nome Tipo Description
airAndPollen

AirAndPollen[]

Previsão de indicadores de qualidade do ar, pólen e índice UV para o dia. Cada entrada reporta um nome (como Árvore, Capim, Ambrosia, Mofo, 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 riscos potenciais à 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

Os totais de graus por dia de aquecimento e refrigeração para o dia, usados para estimar a demanda de energia para controle climático de edifícios.

hoursOfSun

number (float)

O número esperado de horas de sol durante o dia, útil para planejar 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™ mais altos 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 umidade, vento, cobertura de nuvens, intensidade solar e outros fatores para indicar como o clima realmente se sente. Para mais informações, veja Qual é a temperatura AccuWeather RealFeel?

realFeelTemperatureShade

WeatherValueRange

Os valores altos e baixos de temperatura RealFeel™ para o dia em áreas sombreadas, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Como realFeelTemperature, mas exclui o efeito de aquecimento da luz solar direta, dando uma noção mais precisa de como o clima se sente na sombra.

sources

string[]

Os provedores de dados que contribuíram para a previsão deste dia.

temperature

WeatherValueRange

As temperaturas altas e baixas previstas para o dia, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.

DailyForecastDetail

Detalhes da previsão para meio dia. A mesma forma é usada tanto DailyForecast.day para (do nascer até o pôr do sol) e DailyForecast.night (do pôr do sol até o próximo nascer do sol), então todas as referências a "este período" abaixo se referem àquela parte específica do dia ou da noite – nunca o 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 Description
cloudCover

integer (int32)

A porcentagem do céu coberto por nuvens durante esse período foi de 0 (céu limpo) a 100 (completamente nublado). Pode ser NULL.

hasPrecipitation

boolean

true se houver precipitação (chuva, neve, granizo ou granizo) durante esse período; false caso contrário.

hoursOfIce

number (float)

O número total de horas durante esse período em que se espera formação de gelo.

hoursOfPrecipitation

number (float)

O número total de horas durante esse período em que se espera qualquer precipitação (chuva, neve, granizo ou granizo).

hoursOfRain

number (float)

O número total de horas durante esse período em que se espera chuva.

hoursOfSnow

number (float)

O número total de horas durante esse período em que a neve é esperada.

ice

WeatherValue

A quantidade de acúmulo de gelo esperada durante esse 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 esse período, expressa como porcentagem de 0 a 100, onde 0 significa que não há chance de gelo e 100 significa que condições de gelo são certas.

iconCode

IconCode

Valor numérico representando uma imagem que corresponde à condição climática prevista para esse período, descrita pela iconPhrase propriedade. O valor numérico corresponde a um ícone de clima do Azure Mapas – para a lista completa, veja Serviços de Clima no Azure Mapas. Pode ser NULL.

iconPhrase

string

Uma frase curta que descreve o ícone, retornada no idioma especificado na solicitação. Por exemplo, Sunny.

localSource

LocalSource

Informações sobre o provedor local de dados meteorológicos cujo código de ícones e código de clima foram usados nesse período, quando um foi selecionado.

longPhrase

string

Uma frase mais longa e descritiva para esse período, retornada no idioma especificado no pedido. O Azure Mapas tenta manter essa frase abaixo de 100 caracteres, mas alguns idiomas ou eventos climáticos podem produzir uma sequência mais longa.

precipitationIntensity

string

Uma breve descrição qualitativa da intensidade da precipitação para esse período - por exemplo, Leve, Moderada ou Intensa. Retornado na linguagem especificada na solicitação, e somente quando hasPrecipitation é true.

precipitationProbability

integer (int32)

A probabilidade de qualquer precipitação durante esse período, expressa como uma porcentagem de 0 a 100, onde 0 significa que não há chance de precipitação e 100 significa que precipitação é certa.

precipitationType

PrecipitationType

O tipo dominante de precipitação esperado nesse período é de chuva, neve, gelo ou mistura. Retornado somente quando hasPrecipitation é true.

rain

WeatherValue

A quantidade de chuva esperada durante esse período, em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.

rainProbability

integer (int32)

A probabilidade de chuva durante esse período, expressa como porcentagem de 0 a 100, onde 0 significa que não há chance de chuva e 100 significa que chuva é certa.

shortPhrase

string

Uma frase curta que descreve a previsão para esse período, retornada no idioma especificado no pedido. O Azure Mapas tenta manter essa frase abaixo de 30 caracteres, mas alguns idiomas ou eventos climáticos podem produzir uma sequência mais longa.

snow

WeatherValue

A quantidade de acúmulo de neve prevista durante esse período, em centímetros (cm) ou polegadas (in), dependendo da unidade especificada no pedido.

snowProbability

integer (int32)

A probabilidade de neve durante esse período, expressa como uma porcentagem de 0 a 100, onde 0 significa que não há chance de neve e 100 significa que neve é certa.

thunderstormProbability

integer (int32)

A probabilidade de uma tempestade durante esse período, expressa como porcentagem de 0 a 100, onde 0 significa nenhuma chance de tempestade e 100 significa que uma tempestade é 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 esse 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 esse 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 horário - leste está a 90°, sul a 180°, oeste a 270°.

windGust

WindDetails

A velocidade e direção máxima esperada de vento de rajada curta durante esse 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

A resposta foi retornada pela operação Get Daily Forecast, fornecendo uma previsão do tempo dia a dia para um local específico. Inclui um nível summary superior descrevendo as condições dominantes e a gravidade da janela solicitada, além de um forecasts array com uma DailyForecast entrada por dia. O número de inscrições corresponde ao solicitado duration (1, 5, 10, 15, 25 ou 45 dias; 25 e 45 exigem um SKU S1).

Nome Tipo Description
forecasts

DailyForecast[]

As previsões por dia, em ordem cronológica, com uma entrada por dia no solicitado duration. Cada entrada reporta DailyForecast a temperatura alta/mínima do dia, faixa de RealFeel, horas de sol, totais de calor/resfriamento por dia, índices de ar e pólen, blocos de detalhes separados de dia e noite (precipitação, vento, cobertura de nuvens e mais) e as fontes de dados que contribuem para a previsão.

summary

DailyForecastSummary

Um resumo em alto nível das condições climáticas 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 tempestade) durante uma parte dele – e não durante todo o período.

DailyForecastSummary

Um resumo em alto nível das condições climáticas dominantes em parte ou toda a janela de previsão diária solicitada. A janela resumida pode ser mais estreita que a solicitação completa – por exemplo, quando se espera tempo significativo (como um sistema de tempestade) durante apenas 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 Description
category

string

Um rótulo de uma ou duas palavras categorizando as condições climáticas dominantes para a janela resumida – por exemplo, Ensolarado, Parcialmente Nublado, Chuva ou Neve.

endDate

string (date-time)

O final 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 climáticas dominantes para a janela resumida, retornado na linguagem especificada no pedido. Por exemplo, espere chuvas de terça a quinta.

severity

integer (int32)

Uma classificação numérica de severidade 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 coberta por este resumo, no formato RFC 3339 - por exemplo, 2019-10-27T19:39:57-08:00. Pode ser posterior ao início da janela de previsão solicitada se o evento resumido começar no meio dela.

DegreeDaySummary

Os totais de grau-dia de aquecimento e resfriamento para um único dia, usados para estimar a demanda de energia para aquecimento ou resfriamento 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 Description
cooling

WeatherValue

Dias de Resfriamento (CDD) - o número de graus em que a temperatura média do dia sobe acima da linha de base de 65°F (18°C). Valores mais altos indicam maior demanda de resfriamento. 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 de base de 65°F (18°C). Valores mais altos indicam maior demanda de aquecimento. Reportado em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.

ErrorAdditionalInfo

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

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

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.

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.

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

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

LocalSource

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

Nome Tipo Description
id

integer (int32)

Um identificador numérico que identifica de forma única o provedor local de dados.

name

string

O nome do provedor de dados local, retornado no idioma especificado na solicitação quando disponível; caso contrário, devolvido em inglês ou no idioma em que o provedor o forneceu.

weatherCode

string

O código meteorológico nativo do provedor para essa previsão, adequado para mapear no conjunto de ícones do próprio provedor em vez do Azure Mapas iconCodepadrão.

PrecipitationType

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

Valor Description
Ice

Gelo

Mix

Mix

Rain

Rain

Snow

Snow

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.

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

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

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.

WeatherValueRange

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

Nome Tipo Description
maximum

WeatherValue

Fornece a temperatura máxima para o período 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

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

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.