Weather - Get Daily Forecast
Use para obter uma previsão meteorológica diária detalhada 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 do tempo 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 diários de previsão do tempo.
GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}
GET {endpoint}/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 |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
O nome de host do serviço Azure Mapas. Use |
|
format
|
path | True |
Formato desejado da resposta. Há suporte apenas para |
|
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
|
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. |
|
duration
|
query |
integer (int32) |
Especifica por quantos dias as respostas diárias de previsão são retornadas. Os valores disponíveis são
|
|
|
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. |
|
|
unit
|
query |
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 a ser usada com o modelo de segurança do Microsoft Entra ID. Esse ID único para a conta Azure Mapas pode ser obtido a partir da API de Conta Azure Mapas plano de gerenciamento. Para mais informações sobre o uso da segurança Microsoft Entra ID em Azure Mapas, veja Gerencie autenticação em Azure Mapas. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
A solicitação foi bem-sucedida. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
AadToken
Estes são os fluxos Microsoft Entra OAuth 2.0. Quando combinado com o controle de acesso baseado em funções Azure , pode ser usado para controlar o acesso às APIs REST Azure Mapas. Controles de acesso baseados em função do Azure são usados para designar acesso a uma ou mais contas ou subrecursos de 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 controlar o acesso em APIs e escopos específicos.
Note
- Essa definição de segurança requer o uso do cabeçalho
x-ms-client-idpara 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. As nuvens soberanas possuem URLs de Autorização e configurações de Microsoft Entra ID únicas. - 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 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 |
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:
header
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
Tipo:
apiKey
Em:
header
Exemplos
Successfully retrieve detailed daily weather forecast for a given coordinate location
Solicitação de exemplo
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5
Resposta de exemplo
{
"forecasts": [
{
"airAndPollen": [
{
"name": "AirQuality",
"type": "Ozone",
"category": "Good",
"categoryValue": 1,
"value": 0
},
{
"name": "Grass",
"category": "Low",
"categoryValue": 1,
"value": 0
},
{
"name": "Mold",
"category": "Low",
"categoryValue": 1,
"value": 0
},
{
"name": "Ragweed",
"category": "Low",
"categoryValue": 1,
"value": 0
},
{
"name": "Tree",
"category": "Low",
"categoryValue": 1,
"value": 0
},
{
"name": "UVIndex",
"category": "Low",
"categoryValue": 1,
"value": 0
}
],
"date": "2019-11-13T21:00:00-08:00",
"day": {
"cloudCover": 100,
"hasPrecipitation": true,
"hoursOfIce": 0,
"hoursOfPrecipitation": 3.5,
"hoursOfRain": 3.5,
"hoursOfSnow": 0,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 12,
"iconPhrase": "Showers",
"longPhrase": "Cloudy with a couple of showers, mainly later",
"precipitationIntensity": "Light",
"precipitationProbability": 75,
"precipitationType": "Rain",
"rain": {
"unit": "mm",
"unitType": 3,
"value": 6.1
},
"rainProbability": 75,
"shortPhrase": "Cloudy with a few showers",
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 40,
"thunderstormProbability": 20,
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 6.1
},
"wind": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 16.7
}
},
"windGust": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 48.2
}
}
},
"degreeDaySummary": {
"cooling": {
"unit": "C",
"unitType": 17,
"value": 0
},
"heating": {
"unit": "C",
"unitType": 17,
"value": 15
}
},
"hoursOfSun": 1.1,
"night": {
"cloudCover": 98,
"hasPrecipitation": true,
"hoursOfIce": 0,
"hoursOfPrecipitation": 2.5,
"hoursOfRain": 2.5,
"hoursOfSnow": 0,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 12,
"iconPhrase": "Showers",
"longPhrase": "Breezy this evening; otherwise, low clouds",
"precipitationIntensity": "Light",
"precipitationProbability": 65,
"precipitationType": "Rain",
"rain": {
"unit": "mm",
"unitType": 3,
"value": 4
},
"rainProbability": 64,
"shortPhrase": "Breezy early; cloudy",
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 40,
"thunderstormProbability": 0,
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 4
},
"wind": {
"direction": {
"degrees": 181,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 20.4
}
},
"windGust": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 42.6
}
}
},
"realFeelTemperature": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 1.3
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": -3.4
}
},
"realFeelTemperatureShade": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 1.6
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": -3.4
}
},
"sources": [
"AccuWeather"
],
"temperature": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 5.3
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": 0.8
}
}
}
],
"summary": {
"category": "rain",
"endDate": "2019-11-17T15:00:00-08:00",
"phrase": "Rain Sunday evening",
"severity": 5,
"startDate": "2019-11-17T09:00:00-08:00"
}
}
Definições
| Nome | Description |
|---|---|
|
Air |
Uma entrada descrevendo
|
|
Daily |
A previsão para um dia civil no local especificado retornou como uma entrada por dia no |
|
Daily |
Detalhes da previsão para meio dia. A mesma forma é usada tanto |
|
Daily |
A resposta foi retornada pela operação Get Daily Forecast, fornecendo uma previsão do tempo dia a dia para um local específico. Inclui um nível |
|
Daily |
Um resumo em alto nível das condições climáticas dominantes em parte ou toda a janela de previsão diária solicitada. A janela resumida pode ser mais estreita que a solicitação completa – por exemplo, quando se espera tempo significativo (como um sistema de tempestade) durante apenas uma parte do período – e é delimitada por |
|
Degree |
Os totais de grau-dia de aquecimento e resfriamento para um único dia, usados para estimar a demanda de energia para aquecimento ou resfriamento de um edifício. Cada valor é o número de graus em que a temperatura média do dia difere da linha de base de 65°F (18°C ), na unidade de temperatura especificada no pedido - graus abaixo da linha de base contribuem para |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta comum de erro para todas as APIs do Azure Resource Manager devolver detalhes de erro em operações falhadas. (Isso também segue o formato de resposta de erro OData.). |
|
Icon |
O código numérico de condição climática que identifica qual ícone exibir.
Cada valor nessa enumeração corresponde a um ícone meteorológico do Azure Mapas (como Sunny, Cloudy ou Thunderstorms) e é pareado com um ícone Para a lista completa de códigos, os ícones para os quais eles se mapeiam e imagens de exemplo, veja Serviços de Clima no Azure Mapas. |
|
Json |
Formato desejado da resposta. Há suporte apenas para |
|
Local |
Informações sobre um provedor local de dados meteorológicos usado para obter a previsão em |
|
Precipitation |
Especifica o tipo de precipitação. Valores válidos são Chuva, Neve, Gelo ou Mistura. Essa propriedade é incluída na resposta quando dBZ é maior que zero. |
|
Unit |
Um valor inteiro associado ao tipo de unidade exibida. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para mais informações, veja Serviços meteorológicos em Azure Mapas. |
|
Weather |
Especifica se deve-se devolver dados em unidades métricas ou imperiais, tendo métrica como padrão. Por exemplo:
|
|
Weather |
Valores para métricas relacionadas ao clima, como temperatura, ponto de orvalho e velocidade do vento, apresentados em unidades métricas ou imperiais, conforme especificado no parâmetro URI unitário. Para mais informações, veja Tipos de Unidades no artigo Serviços meteorológicos no Azure Mapas. |
|
Weather |
Fornece as temperaturas mais altas e mais baixas previstas para o período especificado, medidas em graus Celsius (°C) ou Fahrenheit (°F), com base na unidade especificada no pedido. |
|
Wind |
Fornece a velocidade prevista do vento, medida em unidades como quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido. Também indica a direção do vento medida em graus de azimute, começando no norte verdadeiro e movendo-se no sentido horário. O norte corresponde a 0°, leste a 90°, sul a 180° e oeste a 270°. Os valores possíveis variam de 0° a 359°. |
|
Wind |
Fornece detalhes sobre a direção do vento, incluindo a direção em graus de azimute e uma abreviação localizada da direção do vento. |
AirAndPollen
Uma entrada descrevendo DailyForecast.airAndPollen um único indicador de pólen, qualidade do ar ou índice UV para o dia. A name propriedade determina que tipo de indicador a entrada representa:
-
Pólen:
nameé árvore, grama, ambrosia ou mofo.valuefornece o valor previsto ecategory/categoryValueavalie de Baixo para Alto. -
Qualidade do ar:
nameé a qualidade do ar etypeidentifica o poluente que está sendo medido (um dos PM2.5, PM10, O3, NO2, SO2 ou CO).category/categoryValueAvalie a qualidade do ar de Boa para Perigosa. -
Índice UV:
nameé UVIndex.valueé o índice UV (0 a 11+), ecategory/categoryValueavalie o risco de exposição de Baixo a Extremo.
category é o rótulo qualitativo do indicador e categoryValue é a classificação correspondente de 1 a 6, onde 1 indica as condições mais seguras e 6 as mais perigosas.
| Nome | Tipo | Description |
|---|---|---|
| category |
string |
Um breve rótulo qualitativo para o indicador, retornado na linguagem especificada no pedido. Os valores possíveis dependem de
|
| categoryValue |
integer (int32) |
Uma classificação numérica de 1 a 6 que se combina com |
| name |
string |
Identifica qual indicador essa entrada representa. Seja o nome de uma fonte de pólen (Árvore, Capim, Ambrosia ou Mofo), Qualidade do Ar (nesse |
| type |
string |
Quando
|
| value |
integer (int32) |
A medição numérica para esse indicador. A unidade depende de
Tanto a qualidade do ar quanto o índice UV são índices, então são reportados como números sem unidades. |
DailyForecast
A previsão para um dia civil no local especificado retornou como uma entrada por dia no forecasts array em DailyForecastResult.
Inclui a faixa de temperatura alta/baixa do dia, faixas RealFeel (regular e sombreada), horas esperadas de sol, totais de calor/resfriamento por dia de graus, uma variedade de indicadores de qualidade do ar, pólen e índice UV, além de blocos de detalhes separados para as partes diurnas e noturnas (precipitação, vento, cobertura de nuvens e mais). O sources array lista os provedores de dados que contribuem para a previsão.
| Nome | Tipo | Description |
|---|---|---|
| airAndPollen |
Previsão de indicadores de qualidade do ar, pólen e índice UV para o dia.
Cada entrada reporta um nome (como Árvore, Capim, Ambrosia, Mofo, Qualidade do Ar ou UVIndex), um valor numérico e um valor qualitativo |
|
| date |
string (date-time) |
A data do calendário que esta previsão cobre, no formato ISO 8601 ( |
| day |
A previsão detalhada para a parte diurna do dia - incluindo temperatura, precipitação, vento, cobertura de nuvens e outros atributos chave. |
|
| degreeDaySummary |
Os totais de graus por dia de aquecimento e refrigeração para o dia, usados para estimar a demanda de energia para controle climático de edifícios. |
|
| hoursOfSun |
number (float) |
O número esperado de horas de sol durante o dia, útil para planejar atividades ao ar livre e avaliar as condições gerais durante o dia. |
| night |
A previsão detalhada para a parte noturna do dia - incluindo temperatura, precipitação, vento, cobertura de nuvens e outros atributos chave. |
|
| realFeelTemperature |
Os valores de temperatura RealFeel™ mais altos e baixos para o dia, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Desenvolvido pela AccuWeather, o RealFeel combina a temperatura do ar com umidade, vento, cobertura de nuvens, intensidade solar e outros fatores para indicar como o clima realmente se sente. Para mais informações, veja Qual é a temperatura AccuWeather RealFeel? |
|
| realFeelTemperatureShade |
Os valores altos e baixos de temperatura RealFeel™ para o dia em áreas sombreadas, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. Como |
|
| sources |
string[] |
Os provedores de dados que contribuíram para a previsão deste dia. |
| temperature |
As temperaturas altas e baixas previstas para o dia, em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. |
DailyForecastDetail
Detalhes da previsão para meio dia. A mesma forma é usada tanto DailyForecast.day para (do nascer até o pôr do sol) e DailyForecast.night (do pôr do sol até o próximo nascer do sol), então todas as referências a "este período" abaixo se referem àquela parte específica do dia ou da noite – nunca o dia completo de 24 horas. Inclui um ícone de previsão e frases, tipo/intensidade/probabilidade de precipitação, totais de acumulação, horas de precipitação, vento e cobertura de nuvens.
| Nome | Tipo | Description |
|---|---|---|
| cloudCover |
integer (int32) |
A porcentagem do céu coberto por nuvens durante esse período foi de 0 (céu limpo) a 100 (completamente nublado). Pode ser NULL. |
| hasPrecipitation |
boolean |
|
| hoursOfIce |
number (float) |
O número total de horas durante esse período em que se espera formação de gelo. |
| hoursOfPrecipitation |
number (float) |
O número total de horas durante esse período em que se espera qualquer precipitação (chuva, neve, granizo ou granizo). |
| hoursOfRain |
number (float) |
O número total de horas durante esse período em que se espera chuva. |
| hoursOfSnow |
number (float) |
O número total de horas durante esse período em que a neve é esperada. |
| ice |
A quantidade de acúmulo de gelo esperada durante esse período, em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido. |
|
| iceProbability |
integer (int32) |
A probabilidade de formação de gelo durante esse período, expressa como porcentagem de 0 a 100, onde 0 significa que não há chance de gelo e 100 significa que condições de gelo são certas. |
| iconCode |
Valor numérico representando uma imagem que corresponde à condição climática prevista para esse período, descrita pela |
|
| iconPhrase |
string |
Uma frase curta que descreve o ícone, retornada no idioma especificado na solicitação. Por exemplo, Sunny. |
| localSource |
Informações sobre o provedor local de dados meteorológicos cujo código de ícones e código de clima foram usados nesse período, quando um foi selecionado. |
|
| longPhrase |
string |
Uma frase mais longa e descritiva para esse período, retornada no idioma especificado no pedido. O Azure Mapas tenta manter essa frase abaixo de 100 caracteres, mas alguns idiomas ou eventos climáticos podem produzir uma sequência mais longa. |
| precipitationIntensity |
string |
Uma breve descrição qualitativa da intensidade da precipitação para esse período - por exemplo, Leve, Moderada ou Intensa.
Retornado na linguagem especificada na solicitação, e somente quando |
| precipitationProbability |
integer (int32) |
A probabilidade de qualquer precipitação durante esse período, expressa como uma porcentagem de 0 a 100, onde 0 significa que não há chance de precipitação e 100 significa que precipitação é certa. |
| precipitationType |
O tipo dominante de precipitação esperado nesse período é de chuva, neve, gelo ou mistura. Retornado somente quando |
|
| rain |
A quantidade de chuva esperada durante esse período, em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido. |
|
| rainProbability |
integer (int32) |
A probabilidade de chuva durante esse período, expressa como porcentagem de 0 a 100, onde 0 significa que não há chance de chuva e 100 significa que chuva é certa. |
| shortPhrase |
string |
Uma frase curta que descreve a previsão para esse período, retornada no idioma especificado no pedido. O Azure Mapas tenta manter essa frase abaixo de 30 caracteres, mas alguns idiomas ou eventos climáticos podem produzir uma sequência mais longa. |
| snow |
A quantidade de acúmulo de neve prevista durante esse período, em centímetros (cm) ou polegadas (in), dependendo da unidade especificada no pedido. |
|
| snowProbability |
integer (int32) |
A probabilidade de neve durante esse período, expressa como uma porcentagem de 0 a 100, onde 0 significa que não há chance de neve e 100 significa que neve é certa. |
| thunderstormProbability |
integer (int32) |
A probabilidade de uma tempestade durante esse período, expressa como porcentagem de 0 a 100, onde 0 significa nenhuma chance de tempestade e 100 significa que uma tempestade é certa. |
| totalLiquid |
A quantidade total de precipitação líquida (como chuva, mais o equivalente líquido de qualquer neve ou gelo) esperada durante esse período, em milímetros (mm) ou polegadas (in), dependendo da unidade especificada no pedido. |
|
| wind |
A velocidade e direção do vento previstas para esse período. A velocidade do vento está em quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido. A direção do vento é medida em graus de azimute, de 0° (norte verdadeiro) a 359°, movendo-se no sentido horário - leste está a 90°, sul a 180°, oeste a 270°. |
|
| windGust |
A velocidade e direção máxima esperada de vento de rajada curta durante esse período. Rajadas de vento são aumentos súbitos e breves na velocidade do vento que são importantes para atividades como aviação, vela e voo de pipas. A velocidade está em quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido, e a direção usa a mesma convenção de azimute que |
DailyForecastResult
A resposta foi retornada pela operação Get Daily Forecast, fornecendo uma previsão do tempo dia a dia para um local específico. Inclui um nível summary superior descrevendo as condições dominantes e a gravidade da janela solicitada, além de um forecasts array com uma DailyForecast entrada por dia.
O número de inscrições corresponde ao solicitado duration (1, 5, 10, 15, 25 ou 45 dias; 25 e 45 exigem um SKU S1).
| Nome | Tipo | Description |
|---|---|---|
| forecasts |
As previsões por dia, em ordem cronológica, com uma entrada por dia no solicitado |
|
| summary |
Um resumo em alto nível das condições climáticas dominantes ao longo da janela de previsão solicitada. O resumo pode cobrir apenas parte da janela
|
DailyForecastSummary
Um resumo em alto nível das condições climáticas dominantes em parte ou toda a janela de previsão diária solicitada. A janela resumida pode ser mais estreita que a solicitação completa – por exemplo, quando se espera tempo significativo (como um sistema de tempestade) durante apenas uma parte do período – e é delimitada por startDate e endDate. As próprias condições são descritas tanto como uma forma phraselivre, um rótulo de uma ou duas palavras category e uma classificação numérica severity .
| Nome | Tipo | Description |
|---|---|---|
| category |
string |
Um rótulo de uma ou duas palavras categorizando as condições climáticas dominantes para a janela resumida – por exemplo, Ensolarado, Parcialmente Nublado, Chuva ou Neve. |
| endDate |
string (date-time) |
O final da janela coberto por este resumo, no formato RFC 3339 - por exemplo, 2019-10-29T07:00:00-08:00. Pode ser anterior ao fim da janela de previsão solicitada se o evento resumido terminar antes dela. |
| phrase |
string |
Um breve resumo textual livre das condições climáticas dominantes para a janela resumida, retornado na linguagem especificada no pedido. Por exemplo, espere chuvas de terça a quinta. |
| severity |
integer (int32) |
Uma classificação numérica de severidade para o evento meteorológico resumido. Números mais baixos ( excluindo 0) indicam maior gravidade:
|
| startDate |
string (date-time) |
O início da janela coberta por este resumo, no formato RFC 3339 - por exemplo, 2019-10-27T19:39:57-08:00. Pode ser posterior ao início da janela de previsão solicitada se o evento resumido começar no meio dela. |
DegreeDaySummary
Os totais de grau-dia de aquecimento e resfriamento para um único dia, usados para estimar a demanda de energia para aquecimento ou resfriamento de um edifício. Cada valor é o número de graus em que a temperatura média do dia difere da linha de base de 65°F (18°C ), na unidade de temperatura especificada no pedido - graus abaixo da linha de base contribuem para heating, graus acima dela contribuem para cooling.
| Nome | Tipo | Description |
|---|---|---|
| cooling |
Dias de Resfriamento (CDD) - o número de graus em que a temperatura média do dia sobe acima da linha de base de 65°F (18°C). Valores mais altos indicam maior demanda de resfriamento. Reportado em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. |
|
| heating |
Dias de Aquecimento (HDD) - o número de graus em que a temperatura média do dia fica abaixo da linha de base de 65°F (18°C). Valores mais altos indicam maior demanda de aquecimento. Reportado em graus Celsius (°C) ou Fahrenheit (°F), dependendo da unidade especificada no pedido. |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
As informações adicionais. |
|
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | 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 comum de erro para todas as APIs do Azure Resource Manager devolver detalhes de erro em operações falhadas. (Isso também segue o formato de resposta de erro OData.).
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
IconCode
O código numérico de condição climática que identifica qual ícone exibir.
Cada valor nessa enumeração corresponde a um ícone meteorológico do Azure Mapas (como Sunny, Cloudy ou Thunderstorms) e é pareado com um ícone iconPhrase humano retornado junto com ele. O mesmo código pode aparecer em respostas atuais, horárias, diárias, trimestrais e minuto a minuto, permitindo que aplicações exibam um conjunto de ícones consistente em todos os serviços meteorológicos.
Para a lista completa de códigos, os ícones para os quais eles se mapeiam e imagens de exemplo, veja Serviços de Clima no Azure Mapas.
| 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) |
| 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 |
Gelo |
| 25 |
Sleet |
| 26 |
Chuva congelante |
| 29 |
Chuva e neve |
| 30 |
Hot |
| 31 |
Cold |
| 32 |
Windy |
| 33 |
Limpar |
| 34 |
Predominantemente limpo |
| 35 |
Períodos de céu nublado |
| 36 |
Nuvens intermitentes |
| 37 |
Luar enevoado |
| 38 |
Parcialmente nublado |
| 39 |
Parcialmente nublado com pancadas de chuva |
| 40 |
Parcialmente nublado com pancadas de chuva |
| 41 |
Parcialmente nublado com tempestades de trovão |
| 42 |
Parcialmente nublado com trovoadas |
| 43 |
Parcialmente nublado com chuva rápida |
| 44 |
Parcialmente nublado com neve |
JsonFormat
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 |
LocalSource
Informações sobre um provedor local de dados meteorológicos usado para obter a previsão em DailyForecastDetail.localSource. Identifica o provedor (id, name) e expõe o nativo weatherCode do provedor para que as aplicações possam renderizar o próprio conjunto de ícones do provedor em vez dos ícones padrão do Azure Mapas.
| Nome | Tipo | Description |
|---|---|---|
| id |
integer (int32) |
Um identificador numérico que identifica de forma única o provedor local de dados. |
| name |
string |
O nome do provedor de dados local, retornado no idioma especificado na solicitação quando disponível; caso contrário, devolvido em inglês ou no idioma em que o provedor o forneceu. |
| weatherCode |
string |
O código meteorológico nativo do provedor para essa previsão, adequado para mapear no conjunto de ícones do próprio provedor em vez do Azure Mapas |
PrecipitationType
Especifica o tipo de precipitação. Valores válidos são Chuva, Neve, Gelo ou Mistura. Essa propriedade é incluída na resposta quando dBZ é maior que zero.
| Valor | Description |
|---|---|
| Ice |
Gelo |
| Mix |
Mix |
| Rain |
Rain |
| Snow |
Snow |
UnitType
Um valor inteiro associado ao tipo de unidade exibida. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para mais informações, veja Serviços meteorológicos em 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
Especifica se deve-se devolver dados em unidades métricas ou imperiais, tendo métrica como padrão. Por exemplo:
- Métrica: milímetro (mm), metro (m), quilômetro (km), Celsius (C)
- Imperial: polegada (in), pé (pé), milha (mi), Fahrenheit (F)
| Valor | Description |
|---|---|
| imperial |
Retorne dados usando unidades imperiais como Fahrenheit (F) para temperatura e milhas (mi) para distância. |
| metric |
Retorne dados usando unidades métricas como Celsius (C) para temperatura e quilômetro (km) para distância. |
WeatherValue
Valores para métricas relacionadas ao clima, como temperatura, ponto de orvalho e velocidade do vento, apresentados em unidades métricas ou imperiais, conforme especificado no parâmetro URI unitário. Para mais informações, veja Tipos de Unidades no artigo Serviços meteorológicos no Azure Mapas.
| Nome | Tipo | Description |
|---|---|---|
| unit |
string |
A unidade de medida usada no valor de retorno, como "C" para Celsius, "F" para Fahrenheit. |
| unitType |
Um inteiro representando o tipo de unidade. Por exemplo, 0 para pés, 1 para polegadas, 2 para milhas. Para uma lista completa, veja Tipos de Unidades no artigo Serviços meteorológicos no Azure Mapas. |
|
| value |
number (float) |
O valor medido expresso na unidade especificada. |
WeatherValueRange
Fornece as temperaturas mais altas e mais baixas previstas para o período especificado, medidas em graus Celsius (°C) ou Fahrenheit (°F), com base na unidade especificada no pedido.
| Nome | Tipo | Description |
|---|---|---|
| maximum |
Fornece a temperatura máxima para o período especificado, medida em graus Celsius (°C) ou Fahrenheit (°F), com base na unidade especificada no pedido. |
|
| minimum |
Fornece a temperatura mínima para o período de tempo especificado, medida em graus Celsius (°C) ou Fahrenheit (°F), com base na unidade especificada no pedido. |
WindDetails
Fornece a velocidade prevista do vento, medida em unidades como quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido. Também indica a direção do vento medida em graus de azimute, começando no norte verdadeiro e movendo-se no sentido horário. O norte corresponde a 0°, leste a 90°, sul a 180° e oeste a 270°. Os valores possíveis variam de 0° a 359°.
| Nome | Tipo | Description |
|---|---|---|
| direction |
A direção do vento é medida em graus de azimute, começando no verdadeiro Norte (0°) e movendo-se no sentido horário. Leste corresponde a 90°, sul a 180° e oeste a 270°. Os valores possíveis variam de 0° a 359°. Essa propriedade retorna um inteiro representando a direção do vento. |
|
| speed |
A velocidade esperada do vento, medida em quilômetros por hora (km/h) ou milhas por hora (mph), dependendo da unidade especificada no pedido. |
WindDirection
Fornece detalhes sobre a direção do vento, incluindo a direção em graus de azimute e uma abreviação localizada da direção do vento.
| Nome | Tipo | Description |
|---|---|---|
| degrees |
integer (int32) |
A direção do vento é medida em graus de azimute, começando no norte verdadeiro e movendo-se no sentido horário. Norte corresponde a 0 graus, leste a 90 graus, sul a 180 graus e oeste a 270 graus. Os valores possíveis variam de 0 a 359 graus. |
| localizedDescription |
string |
Uma abreviação localizada da direção do vento, retornada no idioma especificado no pedido. Por exemplo, |