Weather - Get Current Conditions

Serviço:: Maps

Versão da API:: 1.1

Use para obter as condições meteorológicas atuais.
A Get Current Conditions API é uma solicitação HTTP GET que retorna condições climáticas atuais detalhadas, como precipitação, temperatura e vento para um determinado local de coordenadas. Além disso, as observações das últimas 6 ou 24 horas para um determinado local podem ser recuperadas. As informações básicas retornadas com A resposta incluem detalhes como data e hora de observação, breve descrição das condições meteorológicas, ícone meteorológico, sinalizadores indicadores de precipitação e temperatura. Detalhes adicionais, como temperatura RealFeel™ e índice UV também são retornados. Para obter mais informações, consulte Solicitar dados meteorológicos em tempo real

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

Com parâmetros opcionais:

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&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.
details	query		string	Retornar detalhes completos para as condições atuais. Os valores disponíveis são `true` - Devolve todos os detalhes. Por padrão, todos os detalhes são retornados. `false` - Devolve uma versão truncada dos dados da condição atual, que inclui hora da data de observação, frase meteorológica, código do ícone, sinalizador indicador de precipitação e temperatura.
duration	query		integer (int32)	Período de tempo das condições meteorológicas devolvidas. Por padrão, as condições meteorológicas mais atuais serão retornadas. O valor padrão é 0. Os valores suportados são: `0` - Devolver as condições meteorológicas mais atuais. `6` - Condições meteorológicas de retorno das últimas 6 horas. `24` - Condições meteorológicas de retorno das últimas 24 horas.
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	CurrentConditionsResult	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 current weather conditions for a given coordinate location

Pedido de amostra

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Resposta da amostra

Código de estado:: 200

{
  "results": [
    {
      "apparentTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 16.1
      },
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4359
      },
      "cloudCover": 95,
      "dateTime": "2019-11-14T15:08:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "hasPrecipitation": false,
      "iconCode": 7,
      "isDayTime": true,
      "obstructionsToVisibility": "",
      "pastTwentyFourHourTemperatureDeparture": {
        "unit": "C",
        "unitType": 17,
        "value": 1.8
      },
      "phrase": "Cloudy",
      "precipitationSummary": {
        "past12Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past18Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past24Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past3Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past6Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past9Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "pastHour": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.5
        }
      },
      "pressure": {
        "unit": "mb",
        "unitType": 14,
        "value": 1014.9
      },
      "pressureTendency": {
        "code": "S",
        "localizedDescription": "Steady"
      },
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "realFeelTemperatureShade": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "relativeHumidity": 75,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.7
      },
      "temperatureSummary": {
        "past12Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past24Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past6Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 8.3
          }
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 8
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.4
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.6
        }
      },
      "windChillTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.9
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 4.9
        }
      }
    }
  ]
}

Definições

Nome	Descrição
CurrentConditions	Uma única observação meteorológica para o local especificado, devolvida pela operação Get Current Conditions. Dependendo do pedido `duration`, esta observação pode ser a leitura mais recente (mais recente) ou uma das observações horárias anteriores. Por defeito, é devolvido um subconjunto simplificado: data e hora da observação, frase meteorológica, código de ícones, indicador de precipitação e temperatura. Quando o pedido pede todos os detalhes, todas as propriedades são incluídas, acrescentando medições como RealFeel, ponto de orvalho, vento, visibilidade, cobertura de nuvens, pressão e resumos de precipitação e temperatura ondulantes das últimas horas.
CurrentConditionsResult	A resposta devolvida pela operação Obter Condições de Corrente, contendo uma ou mais observações de condições de corrente para uma localização especificada. Por defeito, é devolvida uma única observação para o tempo presente; quando o `duration` parâmetro é definido para 6 ou 24, a resposta inclui também uma observação por última hora nessa janela.
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.
PastHoursTemperature	As temperaturas do ar mais altas e mais baixas observadas durante uma das janelas móveis ( `TemperatureSummary` após 6, 12 ou 24 horas), em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.
PrecipitationSummary	A precipitação líquida equivalente total que caiu no local de observação sobre janelas móveis que terminam na hora da observação. Cada valor cobre a janela completa medida de volta a partir do "agora" – por exemplo, `past3Hours` é o total acumulado das três horas mais recentes, não apenas da terceira hora – por isso as janelas sobrepõem-se e janelas mais longas incluem a precipitação reportada nas mais curtas. A neve e o gelo contribuem para o seu equivalente derretido (líquido). Reportado em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.
PressureTendency	A tendência recente da pressão atmosférica – quer a pressão esteja a subir, a diminuir ou a ser constante – regressou tanto como uma frase localizada como um código de uma letra. Útil para antecipar alterações meteorológicas de curto prazo; a queda da pressão frequentemente indica o agravamento do tempo, enquanto a subida da pressão normalmente indica a melhoria das condições.
TemperatureSummary	As temperaturas do ar mais altas e mais baixas observadas no local sobre janelas móveis terminam na hora da observação. Cada valor cobre a janela completa medida de volta a partir do "agora" – por exemplo, `past12Hours` reporta o máximo e o mínimo nas últimas 12 horas, não apenas a décima segunda – por isso as janelas sobrepõem-se e janelas mais longas incluem as temperaturas reportadas para as mais curtas. Reportado em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.
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.
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.

CurrentConditions

Object

Uma única observação meteorológica para o local especificado, devolvida pela operação Get Current Conditions. Dependendo do pedido duration, esta observação pode ser a leitura mais recente (mais recente) ou uma das observações horárias anteriores. Por defeito, é devolvido um subconjunto simplificado: data e hora da observação, frase meteorológica, código de ícones, indicador de precipitação e temperatura. Quando o pedido pede todos os detalhes, todas as propriedades são incluídas, acrescentando medições como RealFeel, ponto de orvalho, vento, visibilidade, cobertura de nuvens, pressão e resumos de precipitação e temperatura ondulantes das últimas horas.

Nome	Tipo	Descrição
apparentTemperature	WeatherValue	A temperatura aparente no momento da observação – como o ar realmente se sente para os humanos, tendo em conta a temperatura do ar, humidade relativa e velocidade do vento. Medido em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.
ceiling	WeatherValue	O teto das nuvens no momento da observação - a altura acima do solo da camada de nuvens mais baixa - em pés (pés) ou metros (m), dependendo da unidade especificada no pedido. É importante para a aviação, pois afeta a visibilidade e operações dos voos.
cloudCover	integer (int32)	A percentagem do céu coberto por nuvens no momento da observação, de 0 (limpo) a 100 (nublado). Pode ser NULL.
dateTime	string (date-time)	A data e hora desta observação, no formato RFC 3339 (yyy-mm-ddThh:mm:ss-hh:mm). Por exemplo, 2025-04-29T07:00:00-07:00.
dewPoint	WeatherValue	O ponto de orvalho no momento da observação – a temperatura à qual o ar tem de arrefecer para ficar saturado (100% humidade relativa). Medido em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Um ponto de orvalho mais alto indica mais humidade no ar.
hasPrecipitation	boolean	`true` se houver precipitação (chuva, neve, granizo ou granizo) no momento da observação; caso contrário `false`.
iconCode	IconCode	O ícone meteorológico representativo para esta observação, emparelhado com a `phrase` 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.
isDayTime	boolean	`true` se for de dia no local especificado à hora de observação; `false` se for de noite.
obstructionsToVisibility	string	Um código que identifica o fator dominante que reduz a visibilidade no momento da observação, como nevoeiro, fumo, nevoeiro ou precipitação. Útil para atividades que dependem de visibilidade clara, como condução e aviação. Valores possíveis: A = trovoada forte/granizo BD = pó soprado BN = areia soprante BS = neve soprada D = pó F = nevoeiro GF = nevoeiro do solo HZ = névoa I = gelo IC = cristais de gelo SE = nevoeiro de gelo IP = pellets de gelo IPW = chuva de pellets de gelo K = fumo L = garoa R = chuva RS = chuva/neve RW = aguaceiro S = neve SG = grânulos de neve SP = bolas de neve SW = aguaceiro de neve T = trovoada UP = precipitação indefinida ZL = garoa gelada ZR = chuva gelada + = pesado - = luz
pastTwentyFourHourTemperatureDeparture	WeatherValue	A variação da temperatura do ar em comparação com há 24 horas, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Valores positivos indicam que o ar está mais quente do que ontem ao mesmo tempo; valores negativos indicam que está mais fresco.
phrase	string	Um termo descritivo curto para as condições meteorológicas na altura da observação – por exemplo, Ensolarado ou Parcialmente Nublado. Emparelha-se com `iconCode`, que identifica o ícone meteorológico correspondente. Para mais informações, consulte Serviços meteorológicos em Azure Maps.
precipitationSummary	PrecipitationSummary	Um resumo das quantidades de precipitação líquida equivalente no local de observação durante janelas móveis das últimas 1, 3, 6, 9, 12, 18 e 24 horas, em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.
pressure	WeatherValue	A pressão atmosférica (do ar) ao nível do solo no momento da observação, em milibares (mb) ou polegadas de mercúrio (inHg), dependendo da unidade especificada no pedido.
pressureTendency	PressureTendency	A tendência recente da pressão atmosférica - a subir, a descer ou a ser constante. Útil para antecipar alterações meteorológicas de curto prazo; a queda da pressão frequentemente indica o agravamento do tempo, enquanto a subida da pressão normalmente indica a melhoria das condições.
realFeelTemperature	WeatherValue	A Temperatura RealFeel™ no momento da observação, 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	WeatherValue	A Temperatura RealFeel™ no momento da observação 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.
relativeHumidity	integer (int32)	A humidade relativa no momento da observação, expressa como uma percentagem de 0 a 100 da quantidade máxima de vapor de água que o ar pode conter à mesma temperatura.
temperature	WeatherValue	A temperatura do ar no momento da observação, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.
temperatureSummary	TemperatureSummary	Um resumo das temperaturas do ar mais altas e mais baixas observadas neste local ao longo das janelas móveis das últimas 6, 12 e 24 horas, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.
uvIndex	integer (int32)	O índice ultravioleta (UV) no momento da observação, indicando o risco de dano devido à exposição solar não protegida. Os valores suportados são: 0-2: Baixo perigo dos raios UV do sol para a pessoa média. 3-5: Risco moderado de danos devido à exposição solar desprotegida. 6-7: Alto risco de danos devido à exposição solar não protegida. 8-10: Risco muito elevado de danos devido à exposição solar desprotegida. 11+: Risco extremo de danos devido à exposição solar desprotegida.
uvIndexPhrase	string	Um pequeno rótulo descritivo para `uvIndex` - por exemplo, Baixo, Moderado, Alto, Muito Alto ou Extremo.
visibility	WeatherValue	A visibilidade horizontal no momento da observação – a distância a que um objeto ou luz pode ser claramente discernido – em quilómetros (km) ou milhas (mi), dependendo da unidade especificada no pedido.
wetBulbTemperature	WeatherValue	A temperatura do bulbo húmido no momento da observação – a temperatura que o ar atingiria se arrefecesse até à saturação (100% humidade relativa) evaporando água para dentro a pressão constante. Medido em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Útil para avaliar stress térmico e arrefecimento por evaporação.
wind	WindDetails	A velocidade e direção do vento no momento da observação. A velocidade está em quilómetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido; a direção está em graus de azimute, medidos no sentido dos ponteiros do relógio a partir do verdadeiro Norte (0° = N, 90° = E, 180° = S, 270° = W).
windChillTemperature	WeatherValue	A temperatura de sensação térmica no momento da observação – o quão frio o ar se sente na pele exposta devido ao efeito combinado do vento e da baixa temperatura. Normalmente mais baixa do que a temperatura real do ar. Medido em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.
windGust	WindDetails	A velocidade e direção máxima de rajada curta entre vento e rajada no momento de observação, usando as mesmas unidades e convenção de azimute que `wind`. Rajadas de vento são picos breves na velocidade do vento que podem afetar atividades como aviação, vela, voo de papagaios e outros eventos ao ar livre.

CurrentConditionsResult

Object

A resposta devolvida pela operação Obter Condições de Corrente, contendo uma ou mais observações de condições de corrente para uma localização especificada. Por defeito, é devolvida uma única observação para o tempo presente; quando o duration parâmetro é definido para 6 ou 24, a resposta inclui também uma observação por última hora nessa janela.

Nome	Tipo	Descrição
results	CurrentConditions[]	As observações das condições atuais, por ordem cronológica, sendo a mais recente a primeira. Por defeito, uma única entrada - a observação mais recente é devolvido; a resposta pode também conter uma entrada por hora durante uma janela recente (normalmente as últimas 6 ou 24 horas), dependendo do pedido.

Nome

Tipo

Descrição

results

CurrentConditions[]

As observações das condições atuais, por ordem cronológica, sendo a mais recente a primeira. Por defeito, uma única entrada - a observação mais recente

é devolvido; a resposta pode também conter uma entrada por hora durante uma janela recente (normalmente as últimas 6 ou 24 horas), dependendo do 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

PastHoursTemperature

Object

As temperaturas do ar mais altas e mais baixas observadas durante uma das janelas móveis ( TemperatureSummary após 6, 12 ou 24 horas), em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.

Nome	Tipo	Descrição
maximum	WeatherValue	A temperatura mais alta observada durante a janela.
minimum	WeatherValue	A temperatura mais baixa observada durante a janela.

PrecipitationSummary

Object

A precipitação líquida equivalente total que caiu no local de observação sobre janelas móveis que terminam na hora da observação. Cada valor cobre a janela completa medida de volta a partir do "agora" – por exemplo, past3Hours é o total acumulado das três horas mais recentes, não apenas da terceira hora – por isso as janelas sobrepõem-se e janelas mais longas incluem a precipitação reportada nas mais curtas. A neve e o gelo contribuem para o seu equivalente derretido (líquido). Reportado em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido.

Nome	Tipo	Descrição
past12Hours	WeatherValue	Precipitação líquida equivalente que caiu nas últimas 12 horas.
past18Hours	WeatherValue	Precipitação líquida equivalente que caiu nas últimas 18 horas.
past24Hours	WeatherValue	Precipitação líquida equivalente que caiu nas últimas 24 horas.
past3Hours	WeatherValue	Precipitação líquida equivalente que caiu nas últimas 3 horas.
past6Hours	WeatherValue	Precipitação líquida equivalente que caiu nas últimas 6 horas.
past9Hours	WeatherValue	Precipitação líquida equivalente que caiu nas últimas 9 horas.
pastHour	WeatherValue	Precipitação líquida equivalente que caiu na última hora.

PressureTendency

Object

A tendência recente da pressão atmosférica – quer a pressão esteja a subir, a diminuir ou a ser constante – regressou tanto como uma frase localizada como um código de uma letra. Útil para antecipar alterações meteorológicas de curto prazo; a queda da pressão frequentemente indica o agravamento do tempo, enquanto a subida da pressão normalmente indica a melhoria das condições.

Nome	Tipo	Descrição
code	string	Um código de uma letra independente da língua para a tendência de pressão: F = A descer, S = Estável, R = a subir.
localizedDescription	string	Uma frase curta que descreve a tendência de pressão – por exemplo, Queda, Estável ou Subida – foi devolvida na linguagem especificada no pedido.

TemperatureSummary

Object

As temperaturas do ar mais altas e mais baixas observadas no local sobre janelas móveis terminam na hora da observação. Cada valor cobre a janela completa medida de volta a partir do "agora" – por exemplo, past12Hours reporta o máximo e o mínimo nas últimas 12 horas, não apenas a décima segunda – por isso as janelas sobrepõem-se e janelas mais longas incluem as temperaturas reportadas para as mais curtas. Reportado em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido.

Nome	Tipo	Descrição
past12Hours	PastHoursTemperature	Temperaturas mais altas e mais baixas observadas nas últimas 12 horas.
past24Hours	PastHoursTemperature	Temperaturas mais altas e mais baixas observadas nas últimas 24 horas.
past6Hours	PastHoursTemperature	Temperaturas mais altas e mais baixas registadas nas últimas 6 horas.

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.

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.