Weather - Get Current Conditions

Serviço:: Maps

Versão da API:: 1.1

Use para obter as condições climáticas atuais.
A Get Current Conditions API é uma solicitação HTTP GET que retorna condições meteorológicas 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 local específico podem ser recuperadas. As informações básicas retornadas com A resposta inclui detalhes como data e hora da observação, breve descrição das condições meteorológicas, ícone do tempo, 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 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.
details	query		string	Retorne detalhes completos para as condições atuais. Os valores disponíveis são `true` - Retorna detalhes completos. Por padrão, todos os detalhes são retornados. `false` - Retorna uma versão truncada dos dados de condição atual, que inclui data e hora da observação, frase meteorológica, código de í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. Valor padrão é 0. Os valores com suporte são: `0` - Retorne 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 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	CurrentConditionsResult	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 current weather conditions for a given coordinate location

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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	Description
CurrentConditions	Uma única observação meteorológica para o local especificado, retornada pela operação Obter Condições Correntes. Dependendo do pedido `duration`, essa observação pode ser a leitura mais recente (mais recente) ou uma das observações horárias anteriores. Por padrão, um subconjunto simplificado é retornado: data e hora da observação, frase do clima, código de ícone, indicador de precipitação e temperatura. Quando o pedido solicita todos os detalhes, todas as propriedades são incluídas, adicionando medições como RealFeel, ponto de orvalho, vento, visibilidade, cobertura de nuvens, pressão e resumos de precipitação e temperatura rolantes das últimas horas.
CurrentConditionsResult	A resposta retornada pela operação Get Current Conditions contendo uma ou mais observações de condições de corrente para uma localização especificada. Por padrão, uma única observação para o tempo presente é retornada; quando o `duration` parâmetro é definido para 6 ou 24, a resposta também inclui uma observação por última hora nessa janela.
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.
PastHoursTemperature	As temperaturas 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 rolantes que terminam no momento da observação. Cada valor cobre a janela completa medida de volta a partir do "agora" – por exemplo, `past3Hours` é o total em movimento das três horas mais recentes, não apenas da terceira – então as janelas se sobrepõem e janelas mais longas incluem a precipitação reportada para as mais curtas. Neve e gelo contribuem com 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 – seja ela subindo, diminuindo ou estável – retornou tanto como uma frase localizada quanto como um código de uma letra. Útil para antecipar mudanças climáticas de curto prazo; a queda da pressão frequentemente indica deterioração do tempo, enquanto a subida da pressão normalmente indica melhora das condições.
TemperatureSummary	As temperaturas do ar mais altas e mais baixas observadas no local sobre janelas rolantes terminam no momento da observação. Cada valor cobre a janela inteira 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 na décima segunda hora – então as janelas se sobrepõem 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 exibida. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para mais informações, veja Serviços meteorológicos em Azure Mapas.
WeatherDataUnit	Especifica se deve-se devolver dados em unidades métricas ou imperiais, tendo métrica como padrão. Por exemplo: Métrica: milímetro (mm), metro (m), quilômetro (km), Celsius (C) Imperial: polegada (in), pé (pé), milha (mi), Fahrenheit (F)
WeatherValue	Valores para métricas relacionadas ao clima, como temperatura, ponto de orvalho e velocidade do vento, apresentados em unidades métricas ou imperiais, conforme especificado no parâmetro URI unitário. Para mais informações, veja Tipos de Unidades no artigo Serviços meteorológicos no Azure Mapas.
WindDetails	Fornece a velocidade prevista do vento, medida em unidades como quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido. Também indica a direção do vento medida em graus de azimute, começando no norte verdadeiro e movendo-se no sentido horário. O norte corresponde a 0°, leste a 90°, sul a 180° e oeste a 270°. Os valores possíveis variam de 0° a 359°.
WindDirection	Fornece detalhes sobre a direção do vento, incluindo a direção em graus de azimute e uma abreviação localizada da direção do vento.

CurrentConditions

Objeto

Uma única observação meteorológica para o local especificado, retornada pela operação Obter Condições Correntes. Dependendo do pedido duration, essa observação pode ser a leitura mais recente (mais recente) ou uma das observações horárias anteriores. Por padrão, um subconjunto simplificado é retornado: data e hora da observação, frase do clima, código de ícone, indicador de precipitação e temperatura. Quando o pedido solicita todos os detalhes, todas as propriedades são incluídas, adicionando medições como RealFeel, ponto de orvalho, vento, visibilidade, cobertura de nuvens, pressão e resumos de precipitação e temperatura rolantes das últimas horas.

Nome	Tipo	Description
apparentTemperature	WeatherValue	A temperatura aparente no momento da observação - como o ar realmente se sente para os humanos, levando em conta a temperatura do ar, a umidade relativa e a 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 as operações dos voos.
cloudCover	integer (int32)	A porcentagem do céu coberta por nuvens no momento da observação vai de 0 (claro) a 100 (nublado). Pode ser NULL.
dateTime	string (date-time)	A data e hora dessa 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 precisa esfriar para se saturar (100% da umidade relativa). Medido em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Um ponto de orvalho mais alto indica mais umidade no ar.
hasPrecipitation	boolean	`true` se a precipitação (chuva, neve, granizo ou granizo) estiver ocorrendo no momento da observação; caso contrário `false`.
iconCode	IconCode	O ícone meteorológico representativo para essa observação, combinado com a `phrase` 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.
isDayTime	boolean	`true` se for de dia no local especificado no momento de observação; `false` se for noite.
obstructionsToVisibility	string	Um código identificando o fator dominante que reduz a visibilidade no momento da observação, como neblina, fumaça, neblina ou precipitação. Útil para atividades que dependem de visibilidade clara, como dirigir e aviação. Valores possíveis: A = tempestade forte/granizo BD = poeira soprada BN = areia soprando BS = neve soprando D = poeira F = neblina GF = neblina do solo HZ = névoa I = gelo IC = cristais de gelo SE = névoa de gelo IP = pellets de gelo IPW = chuva de pellets de gelo K = fumaça L = garoa R = chuva RS = chuva/neve RW = chuva S = neve SG = grânulos de neve SP = bolas de neve SW = chuva de neve T = tempestade UP = precipitação indefinida ZL = garoa congelante ZR = chuva congelante + = pesado - = luz
pastTwentyFourHourTemperatureDeparture	WeatherValue	A mudança na temperatura do ar em comparação com 24 horas atrás, 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 frio.
phrase	string	Um termo descritivo curto para as condições climáticas no momento da observação – por exemplo, Ensolarado ou Parcialmente Nublado. Emparelha-se com `iconCode`, que identifica o ícone do clima correspondente. Para mais informações, veja Serviços meteorológicos em Azure Mapas.
precipitationSummary	PrecipitationSummary	Um resumo das quantidades de precipitação equivalente em líquido no local de observação sobre janelas rolantes 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 - subindo, descendo ou se mantendo estável. Útil para antecipar mudanças climáticas de curto prazo; a queda da pressão frequentemente indica deterioração do tempo, enquanto a subida da pressão normalmente indica melhora 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 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	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. 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.
relativeHumidity	integer (int32)	A umidade relativa no momento da observação, expressa como uma porcentagem de 0 a 100 da quantidade máxima de vapor d'água que o ar pode conter na 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 durante 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 danos causados pela exposição solar desprotegida. Os valores com suporte são: 0-2: Baixo perigo dos raios UV do sol para a pessoa comum. 3-5: Risco moderado de danos por exposição solar desprotegida. 6-7: Alto risco de danos por exposição solar desprotegida. 8-10: Risco muito alto de danos por exposição solar desprotegida. 11+: Risco extremo de danos por exposição solar desprotegida.
uvIndexPhrase	string	Um rótulo descritivo curto para `uvIndex` - por exemplo, Baixo, Moderado, Alto, Muito Alto ou Extremo.
visibility	WeatherValue	A visibilidade horizontal no momento da observação – a distância na qual 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 úmido no momento da observação – a temperatura que o ar atingiria se esfriada até a saturação (100% umidade relativa) evaporando água nela a pressão constante. Medido em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Útil para avaliar o estresse térmico e o resfriamento 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 horário a partir do norte verdadeiro (0° = N, 90° = E, 180° = S, 270° = W).
windChillTemperature	WeatherValue	A temperatura térmica no momento da observação - o quão frio o ar parece na pele exposta devido ao efeito combinado do vento e da baixa temperatura. Normalmente é menor 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 de vento 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, pipa e outros eventos ao ar livre.

CurrentConditionsResult

Objeto

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

Nome	Tipo	Description
results	CurrentConditions[]	As observações das condições atuais, em ordem cronológica, com a mais recente primeiro. Por padrão, uma única entrada - a observação mais recente é devolvido; a resposta também pode conter uma entrada por hora em uma janela móvel recente (tipicamente nas últimas 6 ou 24 horas), dependendo do pedido.

Nome

Tipo

Description

results

CurrentConditions[]

As observações das condições atuais, em ordem cronológica, com a mais recente primeiro. Por padrão, uma única entrada - a observação mais recente

é devolvido; a resposta também pode conter uma entrada por hora em uma janela móvel recente (tipicamente nas últimas 6 ou 24 horas), dependendo do pedido.

ErrorAdditionalInfo

Objeto

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

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

ErrorDetail

Objeto

O detalhe do erro.

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

ErrorResponse

Objeto

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

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

IconCode

Enumeração

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

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

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

JsonFormat

Enumeração

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

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

PastHoursTemperature

Objeto

As temperaturas 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	Description
maximum	WeatherValue	A temperatura mais alta observada durante a janela.
minimum	WeatherValue	A temperatura mais baixa observada durante a janela.

PrecipitationSummary

Objeto

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

Nome	Tipo	Description
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 equivalente líquida 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

Objeto

A tendência recente da pressão atmosférica – seja ela subindo, diminuindo ou estável – retornou tanto como uma frase localizada quanto como um código de uma letra. Útil para antecipar mudanças climáticas de curto prazo; a queda da pressão frequentemente indica deterioração do tempo, enquanto a subida da pressão normalmente indica melhora das condições.

Nome	Tipo	Description
code	string	Um código independente da língua de uma letra para a tendência de pressão: F = Descendo, S = Estável, R = Ascendente.
localizedDescription	string	Uma frase curta descrevendo a tendência à pressão – por exemplo, Queda, Estável ou Subida – retornava na linguagem especificada no pedido.

TemperatureSummary

Objeto

As temperaturas do ar mais altas e mais baixas observadas no local sobre janelas rolantes terminam no momento da observação. Cada valor cobre a janela inteira 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 na décima segunda hora – então as janelas se sobrepõem 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	Description
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 observadas nas últimas 6 horas.

UnitType

Enumeração

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

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

WeatherDataUnit

Enumeração

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

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

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

WeatherValue

Objeto

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

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

WindDetails

Objeto

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

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

WindDirection

Objeto

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

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