Compartilhar via

Weather - Get Quarter Day Forecast

  • Referência
Serviço:
Maps
Versão da API:
1.1

Use para obter uma previsão de Quarter-Day para os próximos 1, 5, 10 ou 15 dias.

A Get Quarter-Day Forecast API é uma solicitação HTTP GET que retorna uma previsão meteorológica detalhada por trimestre do dia para os próximos 1, 5, 10 ou 15 dias para um determinado local. Os dados de resposta são apresentados por trimestres do dia - manhã, tarde, noite e noite. Detalhes como temperatura, umidade, vento, precipitação e índice UV são retornados.

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query={query}
Com parâmetros opcionais: 
GET https://atlas.microsoft.com/weather/forecast/quarterDay/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 quantos dias as respostas de previsão do dia do quester são retornadas. Os valores com suporte 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.
  • 15 – Retornar dados de previsão para os próximos 15 dias.
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 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

QuarterDayForecastResult

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.

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

Tipo: apiKey
Em: header

Exemplos

Successfully retrieve detailed weather forecast by a given location

Solicitação de exemplo

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query=47.632346,-122.138874&duration=1

Resposta de exemplo

Código de status:
200 
{
  "forecasts": [
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T07:00:00-08:00",
      "quarter": 0,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 6.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.1,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 7.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.2,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7.5,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 90,
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 192,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 2,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 55,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T13:00:00-08:00",
      "quarter": 1,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 13.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 14.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 76,
      "wind": {
        "direction": {
          "degrees": 296,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 96,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 50,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T19:00:00-08:00",
      "quarter": 2,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "phrase": "Cloudy",
      "temperature": {
        "minimum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 10.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 8.5,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 81,
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 10,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 93,
      "hasPrecipitation": false,
      "precipitationProbability": 25,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-15T01:00:00-08:00",
      "quarter": 3,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Cloudy with a little rain",
      "temperature": {
        "minimum": {
          "value": 8.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.9,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 6.2,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 8.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 84,
      "wind": {
        "direction": {
          "degrees": 164,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 165,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 14.8,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 9,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 59,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

Definições

Nome Description
DayQuarter

Quarto do dia.
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 no Azure Mapas para obter detalhes.
JsonFormat

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

Especifica o tipo de precipitação ("Chuva" "Neve" "Gelo" ou "Mistura"). Se dbz for zero, precipitationType não estará presente na resposta.
QuarterDayForecast
QuarterDayForecastResult
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.
WeatherUnitRange

Valores de temperatura retornados.
WindDetails

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

Direção do vento

DayQuarter

Quarto do dia.

Nome Tipo Description
0

Integer

1

Integer

2

Integer

3

Integer

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

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

QuarterDayForecast

Nome Tipo Description
cloudCover

integer

Porcentagem que representa a cobertura de nuvem.
date

string

Data da previsão como exemplo, 2019-10-27T00:00: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 alcançar a saturação.
effectiveDate

string

Data e hora do início do trimestre de previsão exibidos no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00.
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.
ice

WeatherUnit

Gelo
iconCode

IconCode

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

string

Descrição da frase do ícone. Exibido no idioma especificado. Por exemplo, "Sunny".
phrase

string

Resumo de frase resumida para trimestre.
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.
quarter

DayQuarter

Quarto do dia.
rain

WeatherUnit

Chuva
realFeelTemperature

WeatherUnitRange

Valores de Temperatura RealFeel™ para o trimestre.
relativeHumidity

integer

Umidade relativa é a quantidade de vapor de água presente no ar expressa como um percentual da quantidade necessária para saturação na mesma temperatura.
snow

WeatherUnit

Neve
temperature

WeatherUnitRange

Valores de temperatura para o trimestre.
thunderstormProbability

integer

Porcentagem que representa a probabilidade de uma tempestade. Por exemplo, '10'.
totalLiquid

WeatherUnit

Equivalente total líquido de precipitação durante o período de previsão.
visibility

WeatherUnit

Visibilidade na unidade especificada. Uma medida da distância em que um objeto ou luz pode ser claramente discernido.
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.

QuarterDayForecastResult

Nome Tipo Description
forecasts

QuarterDayForecast[]

Prever dados para cada trimestre 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 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é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 no 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 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.