Weather - Get Daily Forecast

Referência

Service:: Maps

API Version:: 1.1

Use 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 é uma solicitação HTTP GET que retorna previsão meteorológica detalhada, como temperatura e vento por dia para os próximos 1, 5, 10, 15, 25 ou 45 dias para um determinado local de coordenadas. A resposta inclui detalhes como temperatura, vento, precipitação, qualidade do ar e índice UV. Para obter mais informações, consulte Solicitar dados de previsão do tempo diários.

Se você estiver usando o tipo de preço Gen1 S0, poderá solicitar a previsão diária para os próximos 1, 5, 10 e 15 dias. Se você estiver usando o tipo de preço Gen1 S1 ou Gen2, também poderá solicitar a 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}

With optional parameters:

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&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".
duration	query		integer	Especifica por quantos dias as respostas de previsão diária são retornadas. Os valores disponíveis são `1` – Retornar dados de previsão para o dia seguinte. Retornado por padrão. `5` – Retornar dados de previsão para os próximos 5 dias. `10` – Retornar dados de previsão para os próximos 10 dias. `25` – Retornar dados de previsão para os próximos 25 dias. Disponível apenas no SKU S1. `45` – Retornar dados de previsão para os próximos 45 dias. Disponível apenas no SKU S1.
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 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 Microsoft Entra ID. Ele representa uma ID exclusiva para a conta Azure Mapas e pode ser recuperado da API de Conta do plano de gerenciamento Azure Mapas. Para usar Microsoft Entra ID segurança no Azure Mapas consulte os artigos a seguir para obter diretrizes.

Respostas

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

Segurança

AADToken

Esses são os fluxos 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 Azure Mapas. Os controles de acesso baseados em função do Azure são usados para designar o acesso a uma ou mais Azure Mapas conta de recurso ou sub-recursos. 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 Azure Mapas APIs REST.

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 Azure Mapas recurso ao qual 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 Microsoft Entra ID. * O controle de acesso baseado em função do Azure é configurado no plano de gerenciamento do Azure por meio de portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST. * O uso do SDK da Web 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 plataforma de identidade da Microsoft, consulte visão geral plataforma de identidade da Microsoft.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Essa é uma chave compartilhada provisionada quando você Create uma conta 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 master na conta em que elas são emitidas.

Para aplicativos expostos publicamente, nossa recomendação é usar a abordagem de aplicativos cliente confidenciais para acessar Azure Mapas APIs REST para que sua chave possa ser armazenada com segurança.

Type: apiKey
In: query

SAS Token

Esse é um token de assinatura de acesso compartilhado criado a partir da operação Listar SAS no recurso Azure Mapas por meio do plano de gerenciamento do Azure por meio de portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST.

Com esse token, qualquer aplicativo está autorizado a acessar com controles de acesso baseados em função do Azure e controle refinado à expiração, taxa e 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 do Mapa para limitar o abuso de renderização e renovar regularmente o Token SAS.

Type: apiKey
In: header

Exemplos

Successfully retrieve detailed daily weather forecast for a given coordinate location

Sample Request

HTTP

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Sample Response

Status code:: 200

{
  "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

Nome	Description
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary	Resumo das condições de main para o período de tempo solicitado. Observe que o resumo pode abranger apenas parte do período de tempo.
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	Os detalhes do erro.
ErrorResponse	Resposta de erro
IconCode	Valor numérico que representa uma imagem que exibe o `iconPhrase`. Consulte Serviços meteorológicos em Azure Mapas para obter detalhes.
JsonFormat	Formato desejado da resposta. Há suporte apenas para o formato `json`.
LocalSource	Informações do provedor de dados meteorológicos local.
PrecipitationType	Especifica o tipo de precipitação ("Chuva" "Neve" "Gelo" ou "Mistura"). Se dbz for zero, precipitationType não estará presente na resposta.
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 em 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.
WeatherUnitRange	Valores de temperatura retornados.
WindDetails	Detalhes do vento sendo retornados, incluindo velocidade e direção.
WindDirection	Direção do vento

AirAndPollen

Nome	Tipo	Description
category	string	Categoria do tipo de poluição ou qualidade do ar. Por exemplo, baixo, alto, bom, moderado, não íntegro, perigoso.
categoryValue	integer	Valor associado à qualidade do ar ou à categoria de poluição. Esses valores variam de 1 a 6. 1 implicando boas condições, 6 implicando condições perigosas.
name	string	Nome do pólen ou poluente. Por exemplo, grama, mofo, maconha, qualidade do ar, árvore e índice UV.
type	string	Só existe para a qualidade do ar. Exemplos incluem poluição de ozônio e partícula.
value	integer	Valor do tipo especificado acima. Os valores associados a mofo, grama, maconha e árvore estão em unidades de partes por metro cúbico. Tanto a qualidade do ar quanto os UV são índices, por isso são unitários.

DailyForecast

Nome	Tipo	Description
airAndPollen	AirAndPollen[]	Qualidade do ar
date	string	Data e hora da observação atual exibida no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00.
day	DayOrNight	Detalhes da previsão do dia
degreeDaySummary	DegreeDaySummary	Resumo da temperatura média das informações do Dia do Grau de Aquecimento ou do Dia do Grau de Resfriamento
hoursOfSun	number	Horas de sol.
night	DayOrNight	Detalhes da previsão noturna
realFeelTemperature	WeatherUnitRange	Temperatura RealFeel™ sendo retornada.
realFeelTemperatureShade	WeatherUnitRange	Temperatura RealFeel™ sendo retornada. Descreve como a temperatura realmente se sente na sombra.
sources	string[]	Fontes dos dados de previsão.
temperature	WeatherUnitRange	Valores de temperatura para o dia.

DailyForecastResult

Nome	Tipo	Description
forecasts	DailyForecast[]	Prever dados para cada dia solicitado.
summary	DailyForecastSummary	Resumo das condições de main para o período de tempo solicitado. Observe que o resumo pode abranger apenas parte do período de tempo.

DailyForecastSummary

Resumo das condições de main para o período de tempo solicitado. Observe que o resumo pode abranger apenas parte do período de tempo.

Nome	Tipo	Description
category	string	uma ou duas palavras para resumir a frase.
endDate	string	Data e hora em que o período de resumo termina, exibido no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00.
phrase	string	Frase resumida da previsão diária. Exibido no idioma especificado.
severity	integer	severidade
startDate	string	Data e hora em que o resumo está em vigor, exibido no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00.

DayOrNight

Nome	Tipo	Description
cloudCover	integer	Porcentagem que representa a cobertura de nuvem.
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.
hoursOfIce	number	Horas de gelo.
hoursOfPrecipitation	number	Horas de precipitação
hoursOfRain	number	Horas de chuva.
hoursOfSnow	number	Horas de neve.
ice	WeatherUnit	Gelo
iceProbability	integer	Porcentagem que representa a probabilidade de gelo. Por exemplo, '30'.
iconCode	IconCode	Valor numérico que representa uma imagem que exibe o `iconPhrase`. Consulte Serviços meteorológicos em Azure Mapas para obter detalhes.
iconPhrase	string	Descrição da frase do ícone. Exibido no idioma especificado. Por exemplo, "Sunny".
localSource	LocalSource	Informações do provedor de dados meteorológicos local.
longPhrase	string	Descrição da frase da previsão no idioma especificado. Azure Mapas tenta manter essa frase com menos de 100 caracteres, mas alguns idiomas/eventos meteorológicos podem resultar em um comprimento de frase mais longo, excedendo 100 caracteres.
precipitationIntensity	string	Descrição da intensidade.
precipitationProbability	integer	Porcentagem que representa a probabilidade de precipitação. Por exemplo, '20'.
precipitationType	PrecipitationType	Especifica o tipo de precipitação ("Chuva" "Neve" "Gelo" ou "Mistura"). Se dbz for zero, precipitationType não estará presente na resposta.
rain	WeatherUnit	Chuva
rainProbability	integer	Porcentagem que representa a probabilidade de chuva. Por exemplo, '40'.
shortPhrase	string	Descrição da frase da previsão no idioma especificado. Azure Mapas tenta manter essa frase com menos de 30 caracteres, mas alguns idiomas/eventos meteorológicos podem resultar em um comprimento de frase mais longo, excedendo 30 caracteres.
snow	WeatherUnit	Neve
snowProbability	integer	Porcentagem que representa a probabilidade de neve. Por exemplo, '30'.
thunderstormProbability	integer	Porcentagem que representa a probabilidade de uma tempestade. Por exemplo, '80'.
totalLiquid	WeatherUnit	Equivalente total líquido de precipitação durante o período de previsão.
wind	WindDetails	Detalhes do vento sendo retornados, incluindo velocidade e direção.
windGust	WindDetails	Rajada de vento. A rajada de vento é um aumento repentino e breve na velocidade do vento.

DegreeDaySummary

Nome	Tipo	Description
cooling	WeatherUnit	Número de graus em que a temperatura média está acima de 65 graus F/ 18 graus C.
heating	WeatherUnit	Número de graus em que a temperatura média está abaixo de 65 graus F/ 18 graus C.

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

Os detalhes 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 em 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

LocalSource

Informações do provedor de dados meteorológicos local.

Nome	Tipo	Description
id	integer	Identificador numérico, exclusivo para o provedor de dados local.
name	string	Nome do provedor de dados local. O nome é exibido no idioma especificado pelo código de idioma na URL, se disponível. Caso contrário, Name será exibido em inglês ou no idioma no qual o nome foi fornecido.
weatherCode	string	Código meteorológico fornecido pelo provedor de dados local. Esse código meteorológico permite que a previsão seja correspondida aos ícones fornecidos pelo provedor de dados local em vez de ícones de Azure Mapas.

PrecipitationType

Especifica o tipo de precipitação ("Chuva" "Neve" "Gelo" ou "Mistura"). Se dbz for zero, precipitationType não estará presente na resposta.

Nome	Tipo	Description
Ice	string	Gelo
Mix	string	Combinação
Rain	string	Chuva
Snow	string	Neve

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 em 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étricas 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 em Azure Mapas para obter detalhes.
value	number	Valor arredondado.

WeatherUnitRange

Valores de temperatura retornados.

Nome	Tipo	Description
maximum	WeatherUnit	Temperatura máxima para o período de tempo
minimum	WeatherUnit	Temperatura mínima para o período de tempo.

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