Weather - Get Daily Forecast

Serviço:: Maps

Versão da API:: 1.1

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.

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}

Com parâmetros opcionais:

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 `json` formato.
api-version	query	True	string	Número de versão da API do Azure Mapas.
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	Especifica por quantos dias as respostas diárias de previsão são retornadas. Os valores disponíveis são `1` - Retornar dados de previsão para o dia seguinte. Devolvido por padrão. `5` - Retorne os 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 de idiomas com suporte para obter detalhes.
unit	query		WeatherDataUnit	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 ao uso com o modelo de segurança de ID do Microsoft Entra. Essa ID exclusiva para a conta do Azure Mapas pode ser obtida na API da conta do plano de gerenciamento do Azure Mapas. Para obter mais informações sobre como usar a segurança de ID do Microsoft Entra no Azure Mapas, consulte Gerenciar autenticação no Azure Mapas.

Respostas

Nome	Tipo	Description
200 OK	DailyForecastResult	OK
Other Status Codes	ErrorResponse	Ocorreu um erro inesperado.

Segurança

AADToken

Estas são as Fluxos de do Microsoft Entra OAuth 2.0. Quando emparelhado com acesso baseado em função do Azure controle, 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 sub-recursos ou conta de recurso 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.

Notes

Essa definição de segurança requer o uso do cabeçalho x-ms-client-id para 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. 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 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 Azure Mapas permite a configuração baseada em configuração de um aplicativo para vários casos de uso.

Para obter mais informações sobre a plataforma de identidade da Microsoft, consulte visão geral da plataforma de identidade da Microsoft.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

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

subscription-key

Essa é uma chave compartilhada provisionada quando você 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: query

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 para limitar o abuso de renderização e renovar regularmente o Token SAS.

Tipo: apiKey
Em: header

Exemplos

Successfully retrieve detailed daily weather forecast for a given coordinate location

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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	O objeto AirAndPollen fornece dados ambientais abrangentes. Ele identifica vários tipos de pólen, como árvores, gramíneas, ambrosía e mofo, além de poluentes como PM2.5, PM10, O3, NO2, SO2 e CO. Além disso, ele reporta o Índice UV em uma escala de 1 a 10, oferece descrições qualitativas da qualidade do ar ou níveis de pólen e fornece medições numéricas da concentração de poluentes ou pólen no ar. Essas informações detalhadas ajudam os usuários a avaliar a qualidade do ar e as condições do pólen ao longo de sua rota de viagem.
DailyForecast	Fornece informações meteorológicas detalhadas para um dia específico, como temperatura, vento, precipitação, qualidade do ar e índice UV.
DailyForecastResult
DailyForecastSummary	Resumo das principais condições para o período de tempo solicitado. Observe que o resumo pode cobrir apenas parte do período de tempo.
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
IconCode	Valor numérico que representa uma imagem que corresponde à condição climática atual descrita pela `Phrase` propriedade. Para obter mais informações, consulte Serviços meteorológicos no Azure Mapas. Pode ser NULL.
JsonFormat	Formato desejado da resposta. Há suporte apenas para `json` formato.
LocalSource	Informações do provedor de dados meteorológicos locais.
PrecipitationType	Especifica o tipo de precipitação. Os valores válidos são Chuva, Neve, Gelo ou Mistura. Essa propriedade é incluída na resposta quando dBZ é maior que zero.
UnitType	Um número inteiro que representa o tipo de unidade. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para obter uma lista completa, consulte Serviços meteorológicos no Azure Mapas.
WeatherDataUnit	Especifica o retorno dos dados em unidades métricas ou unidades imperiais. O valor padrão é métrico.
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

Objeto

O objeto AirAndPollen fornece dados ambientais abrangentes. Ele identifica vários tipos de pólen, como árvores, gramíneas, ambrosía e mofo, além de poluentes como PM2.5, PM10, O3, NO2, SO2 e CO. Além disso, ele reporta o Índice UV em uma escala de 1 a 10, oferece descrições qualitativas da qualidade do ar ou níveis de pólen e fornece medições numéricas da concentração de poluentes ou pólen no ar. Essas informações detalhadas ajudam os usuários a avaliar a qualidade do ar e as condições do pólen ao longo de sua rota de viagem.

Nome	Tipo	Description
category	string	Fornece uma descrição qualitativa de uma palavra da qualidade do ar ou do nível de pólen para o período de previsão na linguagem especificada. Essa propriedade categoriza a qualidade do ar ou a contagem de pólen em diferentes níveis, como baixo, alto, bom, moderado, insalubre, perigoso, proporcionando aos usuários uma avaliação fácil de entender das condições atuais.
categoryValue	integer (int32)	Fornece uma representação numérica da qualidade do ar ou do nível de pólen. Esse valor corresponde à propriedade qualitativa `category` , oferecendo uma forma precisa de quantificar a qualidade do ar ou o nível de pólen. Esses valores variam de 1 a 6, sendo 1 indicando boas condições e 6 condições perigosas.
name	string	Para pólen: Retorna o nome do pólen, como árvore, grama, ambrosia ou mofo. Para poluentes: Quando a `name` propriedade é `AirQuality`, o nome do poluente é retornado na `type` propriedade. Poluentes válidos incluem: PM2.5, PM10, O3, NO2, SO2 e CO. Para o índice UV: Quando a `name` propriedade é `UVIndex`, o índice UV é retornado na `value` propriedade. Valores válidos do Índice UV variam de 0 a 11+ e representam a intensidade da radiação ultravioleta. Os valores do Índice UV são categorizados da seguinte forma: 0-2: Baixo 3-5: Moderado 6-7: Alto 8-10: Muito Alto 11+: Extremo
type	string	Especifica o tipo de poluente atmosférico a ser medido. Usado apenas quando a `name` propriedade é igual a Qualidade do Ar. Exemplos de poluentes atmosféricos incluem Partículas Particuladas (PM2.5, PM10), Ozônio (O3), Dióxido de Nitrogênio (NO2), Dióxido de Enxofre (SO2) e Monóxido de Carbono (CO).
value	integer (int32)	Fornece uma medição numérica da concentração de poluentes ou pólen no ar. Esse valor é tipicamente expresso em unidades relevantes para o tipo de poluente ou pólen sendo medido, como microgramas por metro cúbico (μg/m³) para partículas ou partes por bilhão (ppb) para gases como ozônio. Tanto a qualidade do ar quanto o UV são índices, portanto, não têm unidade.

DailyForecast

Objeto

Fornece informações meteorológicas detalhadas para um dia específico, como temperatura, vento, precipitação, qualidade do ar e índice UV.

Nome	Tipo	Description
airAndPollen	AirAndPollen[]	Uma lista contendo poluentes, níveis de pólen e o índice UV para a previsão diária. Cada item da lista inclui valores e categorias previstos (por exemplo, baixo, alto, bom, moderado, pouco saudável, perigoso) para avaliar riscos potenciais à saúde.
date	string (date-time)	Data e hora da observação atual, exibidos no formato ISO 8601 (aaaaaa-mm-ddThh:mm:ss-hh:mm). Por exemplo, 2025-04-29T07:00:00-07:00.
day	DayOrNight	Fornece informações detalhadas do tempo para a previsão diurna, incluindo temperatura, precipitação, vento e outros atributos importantes.
degreeDaySummary	DegreeDaySummary	Fornece um resumo dos graus-dias de aquecimento e resfriamento. Os Graus de Aquecimento (HDD) medem a demanda de energia para aquecer um edifício, calculada com base nos graus em que a temperatura média de um dia está abaixo de 65°F/18°C. Os Graus Dias de Resfriamento (CDD) medem a demanda de energia para resfriar um edifício, calculada com base nos graus em que a temperatura média de um dia está acima de 65°F/18°C. Este resumo auxilia na gestão e planejamento energético.
hoursOfSun	number (float)	Fornece o número esperado de horas de sol para o dia especificado.
night	DayOrNight	Fornece informações detalhadas do tempo para a previsão noturna, incluindo temperatura, precipitação, vento e outros atributos chave.
realFeelTemperature	WeatherUnitRange	Fornece valores de temperatura RealFeel™ para o dia especificado, medidos em graus Celsius (C) ou Fahrenheit (F), dependendo da unidade especificada no pedido. Essa métrica, desenvolvida pela AccuWeather, incorpora mais de uma dúzia de fatores, incluindo umidade, velocidade do vento, cobertura de nuvens e intensidade solar, para oferecer uma medida abrangente de como o clima realmente se sente.
realFeelTemperatureShade	WeatherUnitRange	Fornece valores de temperatura RealFeel™ para o dia especificado em áreas sombreadas. Essa métrica, desenvolvida pela AccuWeather, incorpora mais de uma dúzia de fatores, incluindo umidade, velocidade do vento, cobertura de nuvens e intensidade solar, para oferecer uma medida abrangente de como o clima realmente se sente na sombra.
sources	string[]	Uma lista de fontes que contribuem para os dados de previsão do tempo.
temperature	WeatherUnitRange	Fornece as temperaturas máximas e mínimas previstas para o dia, em graus Celsius (C) ou Fahrenheit (F), dependendo do `unit` especificado no pedido.

DailyForecastResult

Objeto

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

DailyForecastSummary

Objeto

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

Nome	Tipo	Description
category	string	Fornece um resumo de uma ou duas palavras das condições meteorológicas previstas, como ensolarado, parcialmente nublado, chuvoso ou neve.
endDate	string (date-time)	A data e hora de término do resumo da previsão, no formato ISO 8601 (aaaaaa-mm-mdThh:mm:ss-hh:mm). Por exemplo, 2025-04-29T07:00:00-07:00.
phrase	string	Fornece um breve resumo textual das condições meteorológicas diárias, exibido no idioma especificado.
severity	integer (int32)	Indica a severidade do tempo previsto como um inteiro. Números mais baixos representam maior gravidade: 0 = Desconhecido, 1 = Significativo, 2 = Grave, 3 = Moderado, 4 = Menor, 5 = Mínimo, 6 = Insignificante, 7 = Informativo.
startDate	string (date-time)	A data e hora de início do resumo da previsão, no formato ISO 8601 (yyy-mm-ddThh:mm:ss-hh:mm). Por exemplo, 2025-04-29T07:00:00-07:00.

DayOrNight

Objeto

Nome	Tipo	Description
cloudCover	integer (int32)	Porcentagem que representa a cobertura de nuvens.
hasPrecipitation	boolean	Um valor booleano que indica se precipitação (chuva, neve, granizo ou granizo) é esperada durante o período especificado. Retorna verdadeiro se a precipitação for esperada, caso contrário falso.
hoursOfIce	number (float)	Horas de gelo.
hoursOfPrecipitation	number (float)	Horas de precipitação
hoursOfRain	number (float)	Horas de chuva.
hoursOfSnow	number (float)	Horas de neve.
ice	WeatherUnit	Ice
iceProbability	integer (int32)	Porcentagem que representa a probabilidade de gelo. Por exemplo, '30'.
iconCode	IconCode (int32)	Valor numérico que representa uma imagem que corresponde à condição climática atual descrita pela `Phrase` propriedade. Para obter mais informações, consulte Serviços meteorológicos no Azure Mapas. Pode ser NULL.
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 locais.
longPhrase	string	Descrição da frase da previsão no idioma especificado. O Azure Mapas tenta manter essa frase com menos de 100 caracteres, mas alguns idiomas/eventos climáticos podem resultar em um comprimento de frase mais longo, excedendo 100 caracteres.
precipitationIntensity	string	Descrição da intensidade.
precipitationProbability	integer (int32)	Porcentagem que representa a probabilidade de precipitação. Por exemplo, '20'.
precipitationType	PrecipitationType	Especifica o tipo de precipitação. Os valores válidos são Chuva, Neve, Gelo ou Mistura. Essa propriedade é incluída na resposta quando dBZ é maior que zero.
rain	WeatherUnit	Rain
rainProbability	integer (int32)	Porcentagem que representa a probabilidade de chuva. Por exemplo, '40'.
shortPhrase	string	Descrição da frase da previsão no idioma especificado. O Azure Mapas tenta manter essa frase com menos de 30 caracteres, mas alguns idiomas/eventos climáticos podem resultar em um comprimento de frase mais longo, excedendo 30 caracteres.
snow	WeatherUnit	Snow
snowProbability	integer (int32)	Porcentagem que representa a probabilidade de neve. Por exemplo, '30'.
thunderstormProbability	integer (int32)	Porcentagem que representa a probabilidade de uma tempestade. Por exemplo, '80'.
totalLiquid	WeatherUnit	Equivalente líquido total 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 súbito e breve na velocidade do vento.

DegreeDaySummary

Objeto

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

Objeto

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

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

IconCode

Enumeração

Valor numérico que representa uma imagem que corresponde à condição climática atual descrita pela Phrase propriedade. Para obter mais informações, consulte Serviços meteorológicos no Azure Mapas. Pode ser NULL.

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)
9
10
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	Ice
25	Sleet
26	Chuva congelante
27
28
29	Chuva e neve
30	Hot
31	Cold
32	Windy
33	Clear
34	Predominantemente limpo
35	Períodos de céu nublado
36	Nuvens intermitentes (noite)
37	Luar enevoado
38	Muito nublado (noite)
39	Parcialmente nublado com pancadas de chuva
40	Muito nublado com aguaceiros (noite)
41	Parcialmente nublado com tempestades de trovão
42	Principalmente nublado com trovoadas (noite)
43	Principalmente nublado com rajadas (noite)
44	Principalmente nublado com neve (noite)

JsonFormat

Enumeração

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

Objeto

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

Nome	Tipo	Description
id	integer (int32)	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, Nome será exibido em inglês ou no idioma em que 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 dos ícones do Azure Mapas.

PrecipitationType

Enumeração

Especifica o tipo de precipitação. Os valores válidos são Chuva, Neve, Gelo ou Mistura. Essa propriedade é incluída na resposta quando dBZ é maior que zero.

Valor	Description
Ice	Ice
Mix	Mix
Rain	Rain
Snow	Snow

UnitType

Enumeração

Um número inteiro que representa o tipo de unidade. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para obter uma lista completa, consulte Serviços meteorológicos no 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

Enumeração

Especifica o retorno dos dados em unidades métricas ou unidades imperiais. O valor padrão é métrico.

Valor	Description
imperial	Retorne dados usando unidades imperiais como Fahrenheit (F) para temperatura e milha (mi) para distância.
metric	Retorne dados usando unidades métricas como Celsius (C) para temperatura e quilômetro (km) para distância.

WeatherUnit

Objeto

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

Nome	Tipo	Description
unit	string	Tipo de unidade para o valor retornado.
unitType	UnitType (int32)	Um número inteiro que representa o tipo de unidade. Por exemplo, 17 para Celsius, 18 para Fahrenheit. Pode ser usado para tradução de unidades. Para obter uma lista completa, consulte Serviços meteorológicos no Azure Mapas.
value	number (float)	Valor arredondado.

WeatherUnitRange

Objeto

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

Objeto

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

Objeto

Direção do vento

Nome	Tipo	Description
degrees	integer (int32)	Direção do vento em graus de azimute, começando no norte verdadeiro e continuando no sentido horário. 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.

Compartilhar via

Weather - Get Daily Forecast

Parâmetros de URI

Cabeçalho da solicitação

Respostas

Segurança

AADToken

Notes

Escopos

subscription-key

SAS Token

Exemplos

Successfully retrieve detailed daily weather forecast for a given coordinate location

Solicitação de exemplo

Resposta de exemplo

Definições

AirAndPollen

DailyForecast

DailyForecastResult

DailyForecastSummary

DayOrNight

DegreeDaySummary

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

LocalSource

PrecipitationType

UnitType

WeatherDataUnit

WeatherUnit

WeatherUnitRange

WindDetails

WindDirection