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 https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}

Com parâmetros opcionais:

GET https://atlas.microsoft.com/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
format	path	True	JsonFormat	Formato desejado da resposta. Há suporte apenas para `json` formato.
api-version	query	True	string	Número de versão da API do Azure Mapas.
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	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 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 ao uso com o modelo de segurança de ID do Microsoft Entra. Essa ID exclusiva para a conta do Azure Mapas pode ser obtida na API da conta do plano de gerenciamento do Azure Mapas. Para obter mais informações sobre como usar a segurança de ID do Microsoft Entra no Azure Mapas, consulte Gerenciar autenticação no Azure Mapas.

Respostas

Nome	Tipo	Description
200 OK	CurrentConditionsResult	OK
Other Status Codes	ErrorResponse	Ocorreu um erro inesperado.

Segurança

AADToken

Estas são as Fluxos de do Microsoft Entra OAuth 2.0. Quando emparelhado com acesso baseado em função do Azure controle, ele pode ser usado para controlar o acesso às APIs REST do Azure Mapas. Os controles de acesso baseados em função do Azure são usados para designar o acesso a uma ou mais sub-recursos ou conta de recurso 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.

Notes

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. Nuvens soberanas têm URLs de autorização exclusivas e configurações de ID do Microsoft Entra. * 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 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	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: query

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

Definições

Nome	Description
CurrentConditions
CurrentConditionsResult
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
IconCode	Valor numérico que representa uma imagem que corresponde à condição climática atual descrita pela `Phrase` propriedade. Para obter mais informações, consulte Serviços meteorológicos no Azure Mapas. Pode ser NULL.
JsonFormat	Formato desejado da resposta. Há suporte apenas para `json` formato.
PastHoursTemperature	Resumo das flutuações de temperatura ao longo do número de horas anteriores.
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	Um número inteiro que representa o tipo de unidade. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para obter uma lista completa, consulte Serviços meteorológicos no Azure Mapas.
WeatherDataUnit	Especifica o retorno dos dados em unidades métricas ou unidades imperiais. O valor padrão é métrico.
WeatherUnit	Valor específico de uma determinada unidade relacionada ao clima.
WindDetails	Detalhes do vento sendo retornados, incluindo velocidade e direção.
WindDirection	Direção do vento

CurrentConditions

Objeto

Nome	Tipo	Description
apparentTemperature	WeatherUnit	Temperatura externa percebida causada pela combinação de temperatura do ar, umidade relativa e velocidade do vento na unidade especificada.
ceiling	WeatherUnit	Teto de nuvens na unidade especificada. O teto é uma medida da altura da base das nuvens mais baixas.
cloudCover	integer (int32)	Porcentagem que representa a cobertura de nuvens.
dateTime	string (date-time)	Data e hora da observação atual exibidos no formato ISO 8601 , por exemplo, 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	A temperatura do ponto de orvalho na unidade especificada. A temperatura do ponto de orvalho é a temperatura à qual o ar deve ser resfriado para atingir a saturação.
hasPrecipitation	boolean	Um valor booleano que indica se precipitação (chuva, neve, granizo ou granizo) é esperada durante o período especificado. Retorna verdadeiro se a precipitação for esperada, caso contrário falso.
iconCode	IconCode (int32)	Valor numérico que representa uma imagem que corresponde à condição climática atual descrita pela `Phrase` propriedade. Para obter mais informações, consulte Serviços meteorológicos no Azure Mapas. Pode ser NULL.
isDayTime	boolean	Indica a hora do dia. True indica 'dia', false indica 'noite'.
obstructionsToVisibility	string	Causa da visibilidade limitada. Valores possíveis: A = forte trovoada / granizo BD = soprando poeira BN = areia soprada BS = soprando neve D = poeira F = nevoeiro GF = nevoeiro do solo HZ = neblina I = gelo IC = cristais de gelo IF = névoa de gelo IP = pellets de gelo IPW = chuveiro de pellets de gelo K = fumaça L = garoa R = chuva RS = chuva/neve RW = chuveiro de efeito chuva S = neve SG = grânulos de neve SP = pellets de neve SW = chuva de neve T = trovoada UP = precipitação indefinida ZL = garoa congelante ZR = chuva congelante + = pesado - = luz
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Partida da temperatura observada há 24 horas na unidade especificada.
phrase	string	Descrição da frase da condição meteorológica atual. Exibido no idioma especificado.
precipitationSummary	PrecipitationSummary	Resumo das quantidades de precipitação nas últimas 24 horas.
pressure	WeatherUnit	Pressão atmosférica na unidade especificada.
pressureTendency	PressureTendency	Mudança de pressão atmosférica.
realFeelTemperature	WeatherUnit	RealFeel™ Temperature sendo retornado.
realFeelTemperatureShade	WeatherUnit	RealFeel™ Temperature sendo retornado. Descreve como é a temperatura real na sombra.
relativeHumidity	integer (int32)	A umidade relativa é a quantidade de vapor d'água presente no ar expressa como uma porcentagem da quantidade necessária para a saturação na mesma temperatura.
temperature	WeatherUnit	Temperatura sendo retornada.
temperatureSummary	TemperatureSummary	Resumo das flutuações de temperatura nas últimas 6, 12 e 24 horas.
uvIndex	integer (int32)	Medida da força da radiação ultravioleta do sol. Os valores com suporte são: `0-2` - Baixo perigo dos raios UV do sol ou da pessoa comum. `3-5` - Risco moderado de danos causados pela exposição ao sol desprotegida. `6-7` - Alto risco de danos causados pela exposição solar desprotegida. `8-10` - Risco muito alto de danos causados pela exposição solar desprotegida. `11+` - Risco extremo de danos causados pela exposição solar desprotegida.
uvIndexPhrase	string	Frase associada ao `uvIndex`.
visibility	WeatherUnit	Visibilidade na unidade especificada. Uma medida da distância na qual um objeto ou luz pode ser claramente discernido.
wetBulbTemperature	WeatherUnit	A temperatura à qual o ar pode ser resfriado pela evaporação da água nele a pressão constante até atingir a saturação.
wind	WindDetails	Detalhes do vento sendo retornados, incluindo velocidade e direção.
windChillTemperature	WeatherUnit	Temperatura do ar percebida na pele exposta devido ao vento.
windGust	WindDetails	Rajada de vento. A rajada de vento é um aumento súbito e breve na velocidade do vento.

CurrentConditionsResult

Objeto

Nome	Tipo	Description
results	CurrentConditions[]	Condições meteorológicas atuais detalhadas.

ErrorAdditionalInfo

Objeto

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

Nome	Tipo	Description
info	object	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 de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

IconCode

Enumeração

Valor numérico que representa uma imagem que corresponde à condição climática atual descrita pela Phrase propriedade. Para obter mais informações, consulte Serviços meteorológicos no Azure Mapas. Pode ser NULL.

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)
9
10
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	Ice
25	Sleet
26	Chuva congelante
27
28
29	Chuva e neve
30	Hot
31	Cold
32	Windy
33	Clear
34	Predominantemente limpo
35	Períodos de céu nublado
36	Nuvens intermitentes (noite)
37	Luar enevoado
38	Muito nublado (noite)
39	Parcialmente nublado com pancadas de chuva
40	Muito nublado com aguaceiros (noite)
41	Parcialmente nublado com tempestades de trovão
42	Principalmente nublado com trovoadas (noite)
43	Principalmente nublado com rajadas (noite)
44	Principalmente nublado com neve (noite)

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

Resumo das flutuações de temperatura ao longo do número de horas anteriores.

Nome	Tipo	Description
maximum	WeatherUnit	maximum
minimum	WeatherUnit	minimum

PrecipitationSummary

Objeto

Nome	Tipo	Description
past12Hours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas 12 horas.
past18Hours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas 18 horas.
past24Hours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas 24 horas.
past3Hours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas três horas.
past6Hours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas seis horas. Contém valores métricos e imperiais.
past9Hours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas nove horas.
pastHour	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu na última hora.

PressureTendency

Objeto

Nome	Tipo	Description
code	string	Código de tendência de pressão independentemente do idioma. Um de F = Queda, S = Estável, R = Ascendente.
localizedDescription	string	Descrição da tendência de pressão em linguagem especificada

TemperatureSummary

Objeto

Nome	Tipo	Description
past12Hours	PastHoursTemperature	Resumo das flutuações de temperatura nas últimas 12 horas.
past24Hours	PastHoursTemperature	Resumo das flutuações de temperatura nas últimas 24 horas.
past6Hours	PastHoursTemperature	Resumo das flutuações de temperatura nas últimas 6 horas.

UnitType

Enumeração

Um número inteiro que representa o tipo de unidade. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para obter uma lista completa, consulte Serviços meteorológicos no 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 o retorno dos dados em unidades métricas ou unidades imperiais. O valor padrão é métrico.

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

WeatherUnit

Objeto

Valor específico de uma determinada unidade relacionada ao clima.

Nome	Tipo	Description
unit	string	Tipo de unidade para o valor retornado.
unitType	UnitType (int32)	Um número inteiro que representa o tipo de unidade. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para obter uma lista completa, consulte Serviços meteorológicos no Azure Mapas.
value	number (float)	Valor arredondado.

WindDetails

Objeto

Detalhes do vento sendo retornados, incluindo velocidade e direção.

Nome	Tipo	Description
direction	WindDirection	Direção do vento
speed	WeatherUnit	Velocidade do vento na unidade especificada.

WindDirection

Objeto

Direção do vento

Nome	Tipo	Description
degrees	integer (int32)	Direção do vento em graus de azimute, começando no norte verdadeiro e continuando no sentido horário. Norte é 0 graus, leste é 90 graus, sul é 180 graus, oeste é 270 graus. Valores possíveis 0-359.
localizedDescription	string	Abreviatura de direção no idioma especificado.

Compartilhar via

Weather - Get Current Conditions

Parâmetros de URI

Cabeçalho da solicitação

Respostas

Segurança

AADToken

Notes

Escopos

subscription-key

SAS Token

Exemplos

Successfully retrieve detailed current weather conditions for a given coordinate location

Solicitação de exemplo

Resposta de exemplo

Definições

CurrentConditions

CurrentConditionsResult

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

PastHoursTemperature

PrecipitationSummary

PressureTendency

TemperatureSummary

UnitType

WeatherDataUnit

WeatherUnit

WindDetails

WindDirection