Weather - Get Minute Forecast

Referência

Serviço:: Maps

Versão da API:: 1.1

Use para obter uma previsão minuto a minuto para os próximos 120 minutos em intervalos de 1, 5 e 15 minutos.

A API Get Minute Forecast é uma solicitação de GET HTTP que retorna previsões minuto a minuto para um determinado local para os próximos 120 minutos. Os utilizadores podem solicitar previsões meteorológicas em intervalos de 1, 5 e 15 minutos. A resposta incluirá detalhes como o tipo de precipitação (incluindo chuva, neve ou uma mistura de ambos), hora de início e valor da intensidade de precipitação (dBZ). Para obter mais informações, consulte Solicitar dados de previsão do tempo minuto a minuto.

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}

Com parâmetros opcionais:

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}&interval={interval}&language={language}

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
format	path	True	JsonFormat	Formato desejado da resposta. Apenas `json` formato é suportado.
api-version	query	True	string	Número da versão da API do Azure Maps.
query	query	True	number[]	A consulta aplicável especificada como uma cadeia de caracteres separada por vírgulas composta por latitude seguida de longitude, por exemplo, "47.641268,-122.125679". As informações meteorológicas estão geralmente disponíveis para locais em terra, corpos de água cercados por terra e áreas do oceano que estão a aproximadamente 50 milhas náuticas de uma costa.
interval	query		integer	Especifica o intervalo de tempo em minutos para a previsão do tempo retornada. Os valores suportados são `1` - Recuperar previsão para intervalos de 1 minuto. Retornado por padrão. `5` - Recupere previsões para intervalos de 5 minutos. `15` - Recuperar previsões para intervalos de 15 minutos.
language	query		string	Idioma em que os resultados da pesquisa devem ser retornados. Deve ser uma das tags de idioma IETF suportadas, sem distinção entre maiúsculas e 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 suportados para obter detalhes.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
x-ms-client-id		string	Especifica qual conta deve ser usada em conjunto com o modelo de segurança do Microsoft Entra ID. Ele representa uma ID exclusiva para a conta do Azure Maps e pode ser recuperado da API de Conta do plano de gerenciamento do Azure Maps. Para usar a segurança do Microsoft Entra ID no Azure Maps, consulte os seguintes artigos para obter orientação.

Respostas

Name	Tipo	Description
200 OK	MinuteForecastResult	OK
Other Status Codes	ErrorResponse	Ocorreu um erro inesperado.

Segurança

AADToken

Estes são os Microsoft Entra OAuth 2.0 Flows. Quando emparelhado com controle de de acesso baseado em função do Azure, ele pode ser usado para controlar o acesso às APIs REST do Azure Maps. 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 subrecursos do Azure Maps. 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 Maps.

Para implementar cenários, recomendamos a visualização conceitos de autenticação. Em resumo, essa definição de segurança fornece uma solução para modelar aplicativos(s) por meio de objetos capazes de controle de acesso em APIs e escopos específicos.

Observações

Essa definição de segurança requer o uso do cabeçalho x-ms-client-id para indicar a qual recurso do Azure Maps o aplicativo está solicitando acesso. Isso pode ser adquirido na API de gerenciamento de do Maps.

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 a partir do plano de gerenciamento do Azure por meio do portal do Azure, PowerShell, CLI, SDKs do Azure ou APIs REST. * O uso do SDK da Web do Azure Maps 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
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

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

subscription-key

Esta é uma chave compartilhada que é provisionada quando você Criar uma conta do Azure Maps no portal do Azure ou usando PowerShell, CLI, SDKs do Azure ou API REST.

Com essa chave, qualquer aplicativo pode acessar todas as APIs REST. Em outras palavras, essa chave pode ser usada como uma chave mestra na conta em que eles são emitidos.

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

Tipo: apiKey
Em: query

SAS Token

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

Com esse token, qualquer aplicativo é autorizado a acessar com controles de acesso baseados em função do Azure e controle de grão fino para a expiração, taxa e região(õ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 forma mais segura 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 do Map para limitar o abuso de renderização e renovar regularmente o Token SAS.

Tipo: apiKey
Em: header

Exemplos

Successfully retrieve minute-by-minute forecasts for a given location

Pedido de amostra

HTTP

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

Resposta da amostra

Código de estado:: 200

{
  "summary": {
    "briefPhrase60": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min",
    "briefPhrase": "Rain ending in 25 min",
    "longPhrase": "Rain ending in 25 min",
    "iconCode": 12
  },
  "intervalSummaries": [
    {
      "startMinute": 0,
      "endMinute": 24,
      "totalMinutes": 25,
      "shortPhrase": "Rain ending in %minute_value min",
      "briefPhrase": "Rain ending in %minute_value min",
      "longPhrase": "Rain ending in %minute_value min",
      "iconCode": 12
    },
    {
      "startMinute": 25,
      "endMinute": 119,
      "totalMinutes": 95,
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "iconCode": 7
    }
  ],
  "intervals": [
    {
      "startTime": "2019-11-14T15:18:00-08:00",
      "minute": 0,
      "dbz": 23,
      "shortPhrase": "Light Rain",
      "threshold": "LIGHT",
      "color": {
        "red": 8,
        "green": 98,
        "blue": 2,
        "hex": "#086202"
      },
      "simplifiedColor": {
        "red": 35,
        "green": 190,
        "blue": 39,
        "hex": "#23BE27"
      },
      "precipitationType": "Rain",
      "iconCode": 12,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T15:33:00-08:00",
      "minute": 15,
      "dbz": 18,
      "shortPhrase": "Light Rain",
      "threshold": "LIGHT",
      "color": {
        "red": 32,
        "green": 133,
        "blue": 9,
        "hex": "#208509"
      },
      "simplifiedColor": {
        "red": 35,
        "green": 190,
        "blue": 39,
        "hex": "#23BE27"
      },
      "precipitationType": "Rain",
      "iconCode": 12,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T15:48:00-08:00",
      "minute": 30,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:03:00-08:00",
      "minute": 45,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:18:00-08:00",
      "minute": 60,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:33:00-08:00",
      "minute": 75,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T16:48:00-08:00",
      "minute": 90,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    },
    {
      "startTime": "2019-11-14T17:03:00-08:00",
      "minute": 105,
      "dbz": 0,
      "shortPhrase": "No Precipitation",
      "iconCode": 7,
      "cloudCover": 100
    }
  ]
}

Definições

Name	Description
ColorValue
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ForecastInterval
IconCode	Valor numérico que representa uma imagem que exibe o `iconPhrase`. Consulte serviços meteorológicos no Azure Maps para obter detalhes.
IntervalSummary
JsonFormat	Formato desejado da resposta. Apenas `json` formato é suportado.
MinuteForecastResult
MinuteForecastSummary	Resumos de frases para todo o período de previsão.
PrecipitationType	Especifica o tipo de precipitação ("Chuva", "Neve", "Gelo" ou "Mistura"). Se dbz for zero, precipitationType não está presente na resposta.

ColorValue

Name	Tipo	Description
blue	integer	Componente azul do valor RGB
green	integer	Componente verde do valor RGB.
hex	string	Valor de cor hexadecimal.
red	integer	Componente vermelho do valor RGB.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
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

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

ForecastInterval

Name	Tipo	Description
cloudCover	integer	Percentagem que representa a cobertura de nuvens.
color	ColorValue	A cor de espectro completo que mapeia para o dBZ (decibel relativo a Z). Se dbz for zero, a cor não estará presente na resposta.
dbz	number	Unidade que representa a intensidade de precipitação prevista.
iconCode	IconCode	Valor numérico que representa uma imagem que exibe o `iconPhrase`. Consulte serviços meteorológicos no Azure Maps para obter detalhes.
minute	integer	O primeiro minuto para o intervalo.
precipitationType	PrecipitationType	Especifica o tipo de precipitação ("Chuva", "Neve", "Gelo" ou "Mistura"). Se dbz for zero, precipitationType não está presente na resposta.
shortPhrase	string	Uma pequena frase que descreve a condição de precipitação para o intervalo.
simplifiedColor	ColorValue	A cor da banda que mapeia para o tipo de precipitação e limiar. Se dbz for zero, não está presente na resposta.
startTime	string	A data e a hora para o início do intervalo no formato ISO 8601, por exemplo, 2019-10-27T19:39:57-08:00.
threshold	string	Chave que especifica o valor limite. Junto com precipitationType, pode ser usado para determinar o simplifiedColor. Se dbz for zero, não está presente na resposta.

IconCode

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

Name	Tipo	Description
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

IntervalSummary

Name	Tipo	Description
briefPhrase	string	Breve frase resumida. O comprimento da frase é de aproximadamente 60 caracteres.
endMinute	integer	O último minuto a que se aplica o resumo.
iconCode	IconCode	Valor numérico que representa uma imagem que exibe o `iconPhrase`. Consulte serviços meteorológicos no Azure Maps para obter detalhes.
longPhrase	string	Frase resumida longa. O comprimento da frase é de 60+ caracteres.
shortPhrase	string	Breve frase resumida. O comprimento da frase é de aproximadamente 25 caracteres.
startMinute	integer	O primeiro minuto a que se aplica o resumo.
totalMinutes	integer	O número de minutos a que se aplica o resumo.

JsonFormat

Formato desejado da resposta. Apenas json formato é suportado.

Name	Tipo	Description
json	string	O formato de intercâmbio de dados de notação de objeto JavaScript

MinuteForecastResult

Name	Tipo	Description
intervalSummaries	IntervalSummary[]	Informações resumidas para cada intervalo na previsão. Os resumos decompõem cada intervalo potencial onde a precipitação começa e para.
intervals	ForecastInterval[]	Dados de previsão para cada intervalo na previsão.
summary	MinuteForecastSummary	Resumos de frases para todo o período de previsão.

MinuteForecastSummary

Resumos de frases para todo o período de previsão.

Name	Tipo	Description
briefPhrase	string	Frase resumida para os próximos 120 minutos. O comprimento da frase é de aproximadamente 60 caracteres.
briefPhrase60	string	Frase resumida para os próximos 60 minutos. O comprimento da frase é de aproximadamente 60 caracteres.
iconCode	IconCode	Valor numérico que representa uma imagem que exibe o `iconPhrase`. Consulte serviços meteorológicos no Azure Maps para obter detalhes.
longPhrase	string	Longa frase resumida para os próximos 120 minutos. O comprimento da frase é de 60+ caracteres.
shortPhrase	string	Breve frase resumida para os próximos 120 minutos. O comprimento da frase é de aproximadamente 25 caracteres.

PrecipitationType

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

Name	Tipo	Description
Ice	string	Gelo
Mix	string	Misturar
Rain	string	Chuva
Snow	string	Neve

Partilhar via