Weather - Get Current Conditions

Referência

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 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 local específico 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 climáticas, ícone do clima, sinalizadores de indicador 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 o formato `json`.
api-version	query	True	string	Número de versão da API de Mapas Azure.
query	query	True	number[]	A consulta aplicável especificada como uma cadeia de caracteres separada por vírgulas composta por latitude seguida por longitude, por exemplo, "47.641268,-122.125679".
details	query		string	Retornar detalhes completos das 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 da condição atual, que inclui data e hora da observação, frase do clima, código de ícone, sinalizador de indicador de precipitação e temperatura.
duration	query		integer	Período de tempo das condições climáticas retornadas. Por padrão, as condições climáticas mais atuais serão retornadas. O valor padrão é 0. Os valores com suporte são: `0` - Retornar as condições climáticas mais atuais. `6` - Retornar condições climáticas das últimas 6 horas. `24` - Retornar condições climáticas das últimas 24 horas.
language	query		string	Idioma no qual os resultados da pesquisa devem ser retornados. Deve ser uma das marcas de idioma 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 Idiomas com suporte para obter detalhes.
unit	query		WeatherDataUnit	Especifica para retornar os dados em unidades de métrica ou em unidades imperiais. O valor padrão é métrica.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
x-ms-client-id		string	Especifica qual conta destina-se ao uso em conjunto com o modelo de segurança de ID do Microsoft Entra. Ele representa uma ID exclusiva para a conta do Azure Mapas e pode ser recuperado da API de Conta do plano de gerenciamento do Azure Mapas. Para usar a segurança de ID do Microsoft Entra no Azure Mapas, consulte os artigos a seguir para obter diretrizes .

Respostas

Nome	Tipo	Description
200 OK	CurrentConditionsResult	OK
Other Status Codes	ErrorResponse	Erro inesperado.

Segurança

AADToken

Estes são os Fluxos do Microsoft Entra OAuth 2.0 . Quando emparelhado com o controle de acesso baseado em função do Azure , 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 contas de recursos ou sub-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 acessar o controle em APIs e escopos específicos.

Observações

Essa definição de segurança requer o uso do x-ms-client-id cabeçalho para indicar a qual recurso do Azure Mapas o aplicativo está solicitando acesso. Isso pode ser adquirido da API de gerenciamento de Mapas .

O Authorization URL é específico para a instância de nuvem pública do Azure. As 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 no 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ê cria uma conta do Azure Mapas no portal do Azure ou usa 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 a abordagem de aplicativos cliente confidenciais 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 Listar 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 a expiração, a taxa e as regiõ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 maneira mais segura do que a chave compartilhada.

Para aplicativos expostos publicamente, nossa recomendação é configurar uma lista específica de origens permitidas no recurso de conta de mapa 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
        },
        "pastThreeHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastSixHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastNineHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwelveHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastEighteenHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwentyFourHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "pastSixHours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwelveHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwentyFourHours": {
          "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 exibe o `iconPhrase`. Consulte Serviços meteorológicos no Azure Mapas para obter detalhes.
JsonFormat	Formato desejado da resposta. Há suporte apenas para o formato `json`.
PastHoursTemperature	Resumo das flutuações de temperatura em relação ao número de horas passadas.
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	Valor de ID numérica associado ao tipo de unidade que está sendo exibida. Pode ser usado para tradução de unidade. Consulte Serviços meteorológicos no Azure Mapas para obter detalhes.
WeatherDataUnit	Especifica para retornar os dados em unidades de métrica ou em unidades imperiais. O valor padrão é métrica.
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

Nome	Tipo	Description
apparentTemperature	WeatherUnit	Temperatura ao ar livre percebida causada pela combinação de temperatura do ar, umidade relativa e velocidade do vento na unidade especificada.
ceiling	WeatherUnit	Teto de nuvem na unidade especificada. O teto é uma medida da altura da base das nuvens mais baixas.
cloudCover	integer	Porcentagem que representa a cobertura de nuvem.
dateTime	string	Data e hora da observação atual exibida 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 para a qual o ar deve ser resfriado para atingir a saturação.
hasPrecipitation	boolean	Indica a presença ou ausência de precipitação. True indica a presença de precipitação, false indica a ausência de precipitação.
iconCode	IconCode	Valor numérico que representa uma imagem que exibe o `iconPhrase`. Consulte Serviços meteorológicos no Azure Mapas para obter detalhes.
isDayTime	boolean	Indica a hora do dia. True indica 'day',', false indica 'night.
obstructionsToVisibility	string	Causa da visibilidade limitada. Valores possíveis: A = tempestade forte/granizo BD = soprando poeira BN = areia soprando BS = soprando neve D = poeira F = neblina GF = neblina terrestre HZ = neblina I = gelo IC = cristais de gelo IF = neblina de gelo IP = pelotas de gelo IPW = chuveiro de pelotas de gelo K = fumaça L = garoa R = chuva RS = chuva/neve RW = chuva S = neve SG = granules de neve SP = pelotas de neve SW = chuva de neve T = tempestade UP = precipitação indefinida ZL = garoa congelante ZR = chuva congelante + = pesado - = luz
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Saída 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	A pressão atmosférica muda.
realFeelTemperature	WeatherUnit	Temperatura realfeel™ sendo retornada.
realFeelTemperatureShade	WeatherUnit	Temperatura realfeel™ sendo retornada. Descreve como a temperatura realmente se sente na sombra.
relativeHumidity	integer	A umidade relativa é a quantidade de vapor de água presente no ar expressa como uma porcentagem da quantidade necessária para 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	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 solar 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 em que um objeto ou luz pode ser claramente discernido.
wetBulbTemperature	WeatherUnit	A temperatura para a qual o ar pode ser resfriado evaporando água nela 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 repentino e breve na velocidade do vento.

CurrentConditionsResult

Nome	Tipo	Description
results	CurrentConditions[]	Condições climáticas atuais detalhadas.

ErrorAdditionalInfo

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

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 de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

IconCode

Valor numérico que representa uma imagem que exibe o iconPhrase. Consulte Serviços meteorológicos no Azure Mapas para obter detalhes.

Nome	Tipo	Description
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

JsonFormat

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

Nome	Tipo	Description
json	string	O formato de intercâmbio de dados de notação de objeto JavaScript

PastHoursTemperature

Resumo das flutuações de temperatura em relação ao número de horas passadas.

Nome	Tipo	Description
maximum	WeatherUnit	máximo
minimum	WeatherUnit	mínimo

PrecipitationSummary

Nome	Tipo	Description
pastEighteenHours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas 18 horas.
pastHour	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu na última hora.
pastNineHours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas nove horas.
pastSixHours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas seis horas. Contém valores métricos e imperiais.
pastThreeHours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas três horas.
pastTwelveHours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas 12 horas.
pastTwentyFourHours	WeatherUnit	A quantidade de precipitação (equivalente líquido) que caiu nas últimas 24 horas.

PressureTendency

Nome	Tipo	Description
code	string	Código de tendência de pressão, independentemente da linguagem. Um de F=Falling, S=Steady, R=Rising.
localizedDescription	string	Descrição da tendência de pressão no idioma especificado

TemperatureSummary

Nome	Tipo	Description
pastSixHours	PastHoursTemperature	Resumo das flutuações de temperatura nas últimas 6 horas.
pastTwelveHours	PastHoursTemperature	Resumo das flutuações de temperatura nas últimas 12 horas.
pastTwentyFourHours	PastHoursTemperature	Resumo das flutuações de temperatura nas últimas 24 horas.

UnitType

Valor de ID numérica associado ao tipo de unidade que está sendo exibida. Pode ser usado para tradução de unidade. Consulte Serviços meteorológicos no Azure Mapas para obter detalhes.

Nome	Tipo	Description
0	Integer
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
3	Integer
31	Integer
4	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

WeatherDataUnit

Especifica para retornar os dados em unidades de métrica ou em unidades imperiais. O valor padrão é métrica.

Nome	Tipo	Description
imperial	string	Retornar dados em unidades imperiais. Algumas unidades de exemplo do sistema imperial são Fahrenheit e mile.
metric	string	Retornar dados em unidades de métrica. Algumas unidades de exemplo do sistema de métrica são Celsius e km.

WeatherUnit

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

Nome	Tipo	Description
unit	string	Tipo de unidade para o valor retornado.
unitType	UnitType	Valor de ID numérica associado ao tipo de unidade que está sendo exibida. Pode ser usado para tradução de unidade. Consulte Serviços meteorológicos no Azure Mapas para obter detalhes.
value	number	Valor arredondado.

WindDetails

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

Direção do vento

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

Compartilhar via