Weather - Get Daily Forecast
Utilize para obter uma previsão meteorológica detalhada diária para os próximos 1, 5, 10, 15, 25 ou 45 dias.
A Get Daily Forecast
API é um pedido HTTP GET
que devolve previsões meteorológicas detalhadas, como temperatura e vento por dia para os próximos 1, 5, 10, 15, 25 ou 45 dias para uma determinada localização coordenada. A resposta inclui detalhes como temperatura, vento, precipitação, qualidade do ar e índice UV. Para obter mais informações, veja Pedir dados diários de previsão meteorológica.
Se estiver a utilizar o escalão de preço Gen1 S0, pode pedir previsão diária para os próximos 1, 5, 10 e 15 dias. Se estiver a utilizar o escalão de preço Gen1 S1 ou Gen2, também pode pedir previsão diária para os próximos 25 dias e 45 dias.
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
format
|
path | True |
Formato pretendido da resposta. Apenas |
|
api-version
|
query | True |
string |
Número da versão da API Azure Maps. |
query
|
query | True |
number[] |
A consulta aplicável especificada como uma cadeia separada por vírgulas composta pela latitude seguida de longitude, por exemplo, "47.641268,-122.125679". |
duration
|
query |
integer |
Especifica o número de dias em que as respostas diárias de previsão são devolvidas. Os valores disponíveis são
|
|
language
|
query |
string |
Idioma no qual os resultados da pesquisa devem ser devolvidos. Deve ser uma das etiquetas de idioma IETF suportadas, não sensíveis a maiúsculas e minúsculas. Quando os dados no idioma especificado não estão disponíveis para um campo específico, é utilizado o idioma predefinido. Consulte idiomas suportados para obter detalhes. |
|
unit
|
query |
Especifica para devolver os dados em unidades de métricas ou unidades imperiais. O valor predefinido é métrica. |
Cabeçalho do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
x-ms-client-id |
string |
Especifica a conta que se destina à utilização em conjunto com o modelo de segurança Microsoft Entra ID. Representa um ID exclusivo para a conta Azure Maps e pode ser obtido a partir da API de Conta do plano de gestão Azure Maps. Para utilizar Microsoft Entra ID segurança no Azure Maps veja os seguintes artigos para obter orientações. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Ocorreu um erro inesperado. |
Segurança
AADToken
Estes são os fluxos Microsoft Entra OAuth 2.0. Quando emparelhado com o controlo de acesso baseado em funções do Azure, pode ser utilizado para controlar o acesso às APIs REST Azure Maps. Os controlos de acesso baseados em funções do Azure são utilizados para designar o acesso a uma ou mais Azure Maps conta de recursos ou sub-recursos. Qualquer utilizador, grupo ou principal de serviço pode ter acesso através de uma função incorporada ou de uma função personalizada composta por uma ou mais permissões para Azure Maps APIs REST.
Para implementar cenários, recomendamos que veja os conceitos de autenticação. Em resumo, esta definição de segurança fornece uma solução para modelar aplicações através de objetos com capacidade de controlo de acesso em APIs e âmbitos específicos.
Notas
- Esta definição de segurança requer a utilização do
x-ms-client-id
cabeçalho para indicar a que Azure Maps recurso a que a aplicação está a pedir acesso. Isto pode ser adquirido na API de gestão de Mapas .
O Authorization URL
é específico da instância da cloud pública do Azure. As clouds soberanas têm URLs de Autorização exclusivos e configurações de Microsoft Entra ID.
* O controlo de acesso baseado em funções do Azure está configurado a partir do plano de gestão do Azure através de portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.
* A utilização do SDK Web Azure Maps permite a configuração baseada na configuração de uma aplicação para vários casos de utilização.
- Para obter mais informações sobre plataforma de identidades da Microsoft, consulte plataforma de identidades da Microsoft descrição geral.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Esta é uma chave partilhada que é aprovisionada quando Create uma conta Azure Maps no portal do Azure ou com o PowerShell, a CLI, os SDKs do Azure ou a API REST.
Com esta chave, qualquer aplicação pode aceder a toda a API REST. Por outras palavras, esta chave pode ser utilizada como uma chave mestra na conta na qual são emitidas.
Para aplicações expostas publicamente, a nossa recomendação é utilizar a abordagem de aplicações cliente confidenciais para aceder Azure Maps APIs REST para que a sua chave possa ser armazenada de forma segura.
Type:
apiKey
In:
query
SAS Token
Este é um token de assinatura de acesso partilhado criado a partir da operação List SAS no recurso de Azure Maps através do plano de gestão do Azure através de portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.
Com este token, qualquer aplicação está autorizada a aceder com controlos de acesso baseados em funções do Azure e controlo detalhado para a expiração, taxa e regiões de utilização para o token específico. Por outras palavras, o Token de SAS pode ser utilizado para permitir que as aplicações controlem o acesso de uma forma mais segura do que a chave partilhada.
Para aplicações expostas publicamente, a nossa recomendação é configurar uma lista específica de origens permitidas no recurso da conta de Mapa para limitar o abuso de composição e renovar regularmente o Token de SAS.
Type:
apiKey
In:
header
Exemplos
Successfully retrieve detailed daily weather forecast for a given coordinate location
Sample Request
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5
Sample Response
{
"summary": {
"startDate": "2019-11-17T09:00:00-08:00",
"endDate": "2019-11-17T15:00:00-08:00",
"severity": 5,
"phrase": "Rain Sunday evening",
"category": "rain"
},
"forecasts": [
{
"date": "2019-11-13T21:00:00-08:00",
"temperature": {
"minimum": {
"value": 0.8,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 5.3,
"unit": "C",
"unitType": 17
}
},
"realFeelTemperature": {
"minimum": {
"value": -3.4,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 1.3,
"unit": "C",
"unitType": 17
}
},
"realFeelTemperatureShade": {
"minimum": {
"value": -3.4,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 1.6,
"unit": "C",
"unitType": 17
}
},
"hoursOfSun": 1.1,
"degreeDaySummary": {
"heating": {
"value": 15,
"unit": "C",
"unitType": 17
},
"cooling": {
"value": 0,
"unit": "C",
"unitType": 17
}
},
"airAndPollen": [
{
"name": "AirQuality",
"value": 0,
"category": "Good",
"categoryValue": 1,
"type": "Ozone"
},
{
"name": "Grass",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Mold",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Ragweed",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Tree",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "UVIndex",
"value": 0,
"category": "Low",
"categoryValue": 1
}
],
"day": {
"iconCode": 12,
"iconPhrase": "Showers",
"hasPrecipitation": true,
"precipitationType": "Rain",
"precipitationIntensity": "Light",
"shortPhrase": "Cloudy with a few showers",
"longPhrase": "Cloudy with a couple of showers, mainly later",
"precipitationProbability": 75,
"thunderstormProbability": 20,
"rainProbability": 75,
"snowProbability": 40,
"iceProbability": 0,
"wind": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"value": 16.7,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"value": 48.2,
"unit": "km/h",
"unitType": 7
}
},
"totalLiquid": {
"value": 6.1,
"unit": "mm",
"unitType": 3
},
"rain": {
"value": 6.1,
"unit": "mm",
"unitType": 3
},
"snow": {
"value": 0,
"unit": "cm",
"unitType": 4
},
"ice": {
"value": 0,
"unit": "mm",
"unitType": 3
},
"hoursOfPrecipitation": 3.5,
"hoursOfRain": 3.5,
"hoursOfSnow": 0,
"hoursOfIce": 0,
"cloudCover": 100
},
"night": {
"iconCode": 12,
"iconPhrase": "Showers",
"hasPrecipitation": true,
"precipitationType": "Rain",
"precipitationIntensity": "Light",
"shortPhrase": "Breezy early; cloudy",
"longPhrase": "Breezy this evening; otherwise, low clouds",
"precipitationProbability": 65,
"thunderstormProbability": 0,
"rainProbability": 64,
"snowProbability": 40,
"iceProbability": 0,
"wind": {
"direction": {
"degrees": 181,
"localizedDescription": "S"
},
"speed": {
"value": 20.4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"value": 42.6,
"unit": "km/h",
"unitType": 7
}
},
"totalLiquid": {
"value": 4,
"unit": "mm",
"unitType": 3
},
"rain": {
"value": 4,
"unit": "mm",
"unitType": 3
},
"snow": {
"value": 0,
"unit": "cm",
"unitType": 4
},
"ice": {
"value": 0,
"unit": "mm",
"unitType": 3
},
"hoursOfPrecipitation": 2.5,
"hoursOfRain": 2.5,
"hoursOfSnow": 0,
"hoursOfIce": 0,
"cloudCover": 98
},
"sources": [
"AccuWeather"
]
}
]
}
Definições
Name | Description |
---|---|
Air |
|
Daily |
|
Daily |
|
Daily |
Resumo das condições principais para o período de tempo pedido. Repare que o resumo só pode abranger parte do período de tempo. |
Day |
|
Degree |
|
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta a erros |
Icon |
Valor numérico que representa uma imagem que apresenta o |
Json |
Formato pretendido da resposta. Apenas |
Local |
Informações do fornecedor de dados meteorológicos local. |
Precipitation |
Especifica o tipo de precipitação ("Chuva" "Neve" "Gelo" ou "Mix"). Se dbz for zero, precipitationType não está presente na resposta. |
Unit |
Valor de ID numérico associado ao tipo de unidade que está a ser apresentada. Pode ser utilizado para tradução de unidades. Veja Serviços de meteorologia no Azure Maps para obter detalhes. |
Weather |
Especifica para devolver os dados em unidades métricas ou unidades imperiais. O valor predefinido é métrica. |
Weather |
Valor específico de uma determinada unidade relacionada com a meteorologia. |
Weather |
Valores de temperatura devolvidos. |
Wind |
Detalhes do vento a serem devolvidos, incluindo velocidade e direção. |
Wind |
Direção do vento |
AirAndPollen
Name | Tipo | Description |
---|---|---|
category |
string |
Categoria do tipo de qualidade do ar ou poluição. Por exemplo, baixo, alto, bom, moderado, mau estado de funcionamento, perigoso. |
categoryValue |
integer |
Valor associado à categoria de qualidade do ar ou poluição. Estes valores variam entre 1 e 6. 1 implicando boas condições, 6 implicando condições perigosas. |
name |
string |
Nome do pólen ou poluente. Por exemplo, erva, bolor, erva daninha, qualidade do ar, árvore e índice UV. |
type |
string |
Só existe para a qualidade do ar. Os exemplos incluem o ozono e a poluição por partículas. |
value |
integer |
Valor do tipo especificado acima. Os valores associados ao molde, à relva, à erva e à árvore estão em unidades de partes por metro cúbico. Tanto a qualidade do ar como os UV são índices, por isso são unitários. |
DailyForecast
Name | Tipo | Description |
---|---|---|
airAndPollen |
Qualidade do ar |
|
date |
string |
Data e hora da observação atual apresentada no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00. |
day |
Detalhes da previsão do dia |
|
degreeDaySummary |
Resumo da temperatura média das informações do Dia do Grau de Aquecimento ou do Dia do Grau de Arrefecimento |
|
hoursOfSun |
number |
Horas de sol. |
night |
Detalhes da previsão noturna |
|
realFeelTemperature |
RealFeel™ Temperatura a ser devolvida. |
|
realFeelTemperatureShade |
RealFeel™ Temperatura a ser devolvida. Descreve como é a temperatura na sombra. |
|
sources |
string[] |
Origem(s) dos dados de previsão. |
temperature |
Valores de temperatura do dia. |
DailyForecastResult
Name | Tipo | Description |
---|---|---|
forecasts |
Previsão de dados para cada dia pedido. |
|
summary |
Resumo das condições principais para o período de tempo pedido. Repare que o resumo só pode abranger parte do período de tempo. |
DailyForecastSummary
Resumo das condições principais para o período de tempo pedido. Repare que o resumo só pode abranger parte do período de tempo.
Name | Tipo | Description |
---|---|---|
category |
string |
uma ou 2 palavras para resumir a expressão. |
endDate |
string |
Data e hora em que o período de resumo termina, apresentado no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00. |
phrase |
string |
Expressão de resumo da previsão diária. Apresentado no idioma especificado. |
severity |
integer |
gravidade |
startDate |
string |
Data e hora em que o resumo está em vigor, apresentado no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00. |
DayOrNight
Name | Tipo | Description |
---|---|---|
cloudCover |
integer |
Percentagem que representa a cobertura da cloud. |
hasPrecipitation |
boolean |
Indica a presença ou ausência de precipitação. True indica a presença de precipitação, falso indica a ausência de precipitação. |
hoursOfIce |
number |
Horas de gelo. |
hoursOfPrecipitation |
number |
Horas de precipitação |
hoursOfRain |
number |
Horas de chuva. |
hoursOfSnow |
number |
Horas de neve. |
ice |
Ferreira |
|
iceProbability |
integer |
Percentagem que representa a probabilidade de gelo. Por exemplo, "30". |
iconCode |
Valor numérico que representa uma imagem que apresenta o |
|
iconPhrase |
string |
Descrição da expressão do ícone. Apresentado no idioma especificado. Por exemplo, "Ensolarado". |
localSource |
Informações do fornecedor de dados meteorológicos locais. |
|
longPhrase |
string |
Descrição da expressão da previsão no idioma especificado. Azure Maps tenta manter esta expressão com menos de 100 carateres de comprimento, mas alguns idiomas/eventos meteorológicos podem resultar num comprimento de expressão superior a 100 carateres. |
precipitationIntensity |
string |
Descrição da intensidade. |
precipitationProbability |
integer |
Percentagem que representa a probabilidade de precipitação. Por exemplo, "20". |
precipitationType |
Especifica o tipo de precipitação ("Chuva" "Neve" "Gelo" ou "Mistura"). Se dbz for zero, precipitationType não está presente na resposta. |
|
rain |
Chuva |
|
rainProbability |
integer |
Percentagem que representa a probabilidade de chuva. Por exemplo, "40". |
shortPhrase |
string |
Descrição da expressão da previsão no idioma especificado. Azure Maps tenta manter esta expressão com menos de 30 carateres de comprimento, mas alguns idiomas/eventos meteorológicos podem resultar num comprimento de expressão superior a 30 carateres. |
snow |
Neve |
|
snowProbability |
integer |
Percentagem que representa a probabilidade de neve. Por exemplo, "30". |
thunderstormProbability |
integer |
Percentagem que representa a probabilidade de uma trovoada. Por exemplo, "80". |
totalLiquid |
Equivalente líquido total de precipitação durante o período previsto. |
|
wind |
Detalhes do vento a serem devolvidos, incluindo velocidade e direção. |
|
windGust |
Rajada de vento. A rajada de vento é um aumento repentino e breve da velocidade do vento. |
DegreeDaySummary
Name | Tipo | Description |
---|---|---|
cooling |
Número de graus que a temperatura média é superior a 65 graus F/ 18 graus C. |
|
heating |
Número de graus que a temperatura média é inferior a 65 graus F/ 18 graus C. |
ErrorAdditionalInfo
Informações adicionais sobre o erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informações adicionais. |
ErrorDetail
O detalhe do erro.
Name | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta a erros
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
IconCode
Valor numérico que representa uma imagem que apresenta o iconPhrase
. Veja Serviços de meteorologia no Azure Maps para obter detalhes.
Name | 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 pretendido da resposta. Apenas json
o formato é suportado.
Name | Tipo | Description |
---|---|---|
json |
string |
LocalSource
Informações do fornecedor de dados meteorológicos local.
Name | Tipo | Description |
---|---|---|
id |
integer |
Identificador numérico exclusivo do fornecedor de dados local. |
name |
string |
Nome do fornecedor de dados local. O nome é apresentado no idioma especificado pelo código de idioma no URL, se disponível. Caso contrário, o Nome é apresentado em inglês ou o idioma no qual o nome foi fornecido. |
weatherCode |
string |
Código meteorológico fornecido pelo fornecedor de dados local. Este código meteorológico permite que a previsão seja correspondida aos ícones fornecidos pelo fornecedor de dados local em vez de Azure Maps ícones. |
PrecipitationType
Especifica o tipo de precipitação ("Chuva" "Neve" "Gelo" ou "Mix"). Se dbz for zero, precipitationType não está presente na resposta.
Name | Tipo | Description |
---|---|---|
Ice |
string |
Ferreira |
Mix |
string |
Mix |
Rain |
string |
Chuva |
Snow |
string |
Neve |
UnitType
Valor de ID numérico associado ao tipo de unidade que está a ser apresentada. Pode ser utilizado para tradução de unidades. Veja Serviços de meteorologia no Azure Maps para obter detalhes.
Name | 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 devolver os dados em unidades métricas ou unidades imperiais. O valor predefinido é métrica.
Name | Tipo | Description |
---|---|---|
imperial |
string |
Devolver dados em unidades imperiais. Algumas unidades de exemplo do sistema imperial são Fahrenheit e mile. |
metric |
string |
Devolver dados em unidades métricas. Algumas unidades de exemplo do sistema de métricas são Celsius e km. |
WeatherUnit
Valor específico de uma determinada unidade relacionada com a meteorologia.
Name | Tipo | Description |
---|---|---|
unit |
string |
Tipo de unidade para o valor devolvido. |
unitType |
Valor de ID numérico associado ao tipo de unidade que está a ser apresentada. Pode ser utilizado para tradução de unidades. Veja Serviços de meteorologia no Azure Maps para obter detalhes. |
|
value |
number |
Valor arredondado. |
WeatherUnitRange
Valores de temperatura devolvidos.
Name | Tipo | Description |
---|---|---|
maximum |
Temperatura máxima para o período de tempo |
|
minimum |
Temperatura mínima para o período de tempo. |
WindDetails
Detalhes do vento a serem devolvidos, incluindo velocidade e direção.
Name | Tipo | Description |
---|---|---|
direction |
Direção do vento |
|
speed |
Velocidade do vento na unidade especificada. |
WindDirection
Direção do vento
Name | Tipo | Description |
---|---|---|
degrees |
integer |
Direção do vento em graus de Azimuto, começando no verdadeiro Norte e continuando na direção dos ponteiros do relógio. 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. |