Compartir vía


Weather - Get Daily Forecast

Úselo para obtener un pronóstico meteorológico detallado diario para los próximos 1, 5, 10, 15, 25 o 45 días.

La Get Daily Forecast API es una solicitud HTTP GET que devuelve un pronóstico meteorológico detallado, como la temperatura y el viento, por día para los próximos 1, 5, 10, 15, 25 o 45 días para una ubicación de coordenadas determinada. La respuesta incluye detalles como la temperatura, el viento, las precipitaciones, la calidad del aire y el índice de rayos UVA. Para obtener más información, consulte Solicitar datos de previsión meteorológica diaria.

Si usa el plan de tarifa Gen1 S0, puede solicitar una previsión diaria para los próximos 1, 5, 10 y 15 días. Si usa el plan de tarifa Gen1 S1 o Gen2, también puede solicitar una previsión diaria para los próximos 25 días y 45 días.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
format
path True

JsonFormat

Formato deseado de la respuesta. Solo se admite json formato.

api-version
query True

string

Número de versión de la API de Azure Maps.

query
query True

number[]

La consulta aplicable especificada como una cadena separada por comas compuesta por latitud seguida de longitud, por ejemplo, "47.641268,-122.125679".

La información meteorológica generalmente está disponible para ubicaciones en tierra, cuerpos de agua rodeados de tierra y áreas del océano que se encuentran dentro de aproximadamente 50 millas náuticas de una costa.

duration
query

integer

Especifica durante cuántos días se devuelven las respuestas diarias de previsión. Los valores disponibles son:

  • 1 - Devolver los datos de previsión para el día siguiente. Se devuelve de forma predeterminada.
  • 5 - Devolver datos de previsión para los próximos 5 días.
  • 10 - Devolver datos de previsión para los próximos 10 días.
  • 25 - Devolver los datos de previsión para los próximos 25 días. Solo disponible en SKU S1.
  • 45 - Devolver datos de previsión para los próximos 45 días. Solo disponible en SKU S1.
language
query

string

Idioma en el que se deben devolver los resultados de la búsqueda. Debe ser una de las etiquetas de idioma IETF admitidas, sin distinción entre mayúsculas y minúsculas. Cuando los datos del idioma especificado no están disponibles para un campo específico, se usa el idioma predeterminado.

Consulte idiomas admitidos para obtener más información.

unit
query

WeatherDataUnit

Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.

Encabezado de la solicitud

Nombre Requerido Tipo Description
x-ms-client-id

string

Especifica qué cuenta está pensada para su uso junto con el modelo de seguridad de Id. de Microsoft Entra. Representa un identificador único para la cuenta de Azure Maps y se puede recuperar de la API de cuenta del plano de administración de Azure Maps. Para usar la seguridad del identificador de Entra de Microsoft en Azure Maps, consulte los siguientes artículos de para obtener instrucciones.

Respuestas

Nombre Tipo Description
200 OK

DailyForecastResult

De acuerdo

Other Status Codes

ErrorResponse

Error inesperado.

Seguridad

AADToken

Estos son los flujos de Microsoft Entra OAuth 2.0. Cuando se empareja con acceso basado en rol de Azure control, se puede usar para controlar el acceso a las API REST de Azure Maps. Los controles de acceso basados en roles de Azure se usan para designar el acceso a una o varias cuentas de recursos o subrecursos de Azure Maps. Se puede conceder acceso a cualquier usuario, grupo o entidad de servicio a través de un rol integrado o de un rol personalizado compuesto por uno o varios permisos para las API REST de Azure Maps.

Para implementar escenarios, se recomienda ver conceptos de autenticación. En resumen, esta definición de seguridad proporciona una solución para modelar aplicaciones a través de objetos capaces de controlar el acceso en determinadas API y ámbitos.

Notas

  • Esta definición de seguridad requiere el uso del encabezado x-ms-client-id para indicar a qué recurso de Azure Maps solicita acceso la aplicación. Esto se puede adquirir desde la API de administración de de Maps.

El Authorization URL es específico de la instancia de nube pública de Azure. Las nubes soberanas tienen direcciones URL de autorización únicas y configuraciones de id. de Microsoft Entra. * El control de acceso basado en rol de Azure se configura desde el plano de administración de Azure a través de Azure Portal, PowerShell, la CLI, los SDK de Azure o las API REST. * El uso de sdk web de Azure Maps permite la configuración basada en la configuración de una aplicación para varios casos de uso.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

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

subscription-key

Se trata de una clave compartida que se aprovisiona al Creación de una cuenta de Azure Maps en Azure Portal o mediante PowerShell, la CLI, los SDK de Azure o la API REST.

Con esta clave, cualquier aplicación puede acceder a todas las API REST. En otras palabras, esta clave se puede usar como clave maestra en la cuenta en la que se emiten.

Para las aplicaciones expuestas públicamente, nuestra recomendación es usar las aplicaciones cliente confidenciales enfoque acceder a las API REST de Azure Maps para que la clave se pueda almacenar de forma segura.

Tipo: apiKey
En: query

SAS Token

Se crea un token de firma de acceso compartido a partir de la operación List SAS en el recurso de Azure Maps a través del plano de administración de Azure a través de Azure Portal, PowerShell, CLI, SDK de Azure o API REST.

Con este token, cualquier aplicación tiene autorización para acceder a los controles de acceso basados en rol de Azure y el control específico a la expiración, la tasa y las regiones de uso para el token determinado. Es decir, el token de SAS se puede usar para permitir que las aplicaciones controle el acceso de forma más segura que la clave compartida.

En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es configurar una lista específica de orígenes permitidos en el recurso de cuenta de mapa de limitar el abuso de representación y renovar periódicamente el token de SAS.

Tipo: apiKey
En: header

Ejemplos

Successfully retrieve detailed daily weather forecast for a given coordinate location

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary

Resumen de las principales condiciones para el período de tiempo solicitado. Tenga en cuenta que el resumen puede cubrir solo una parte del período de tiempo.

DayOrNight
DegreeDaySummary
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

IconCode

Valor numérico que representa una imagen que muestra el iconPhrasearchivo . Consulte Servicios meteorológicos en Azure Maps para obtener más información.

JsonFormat

Formato deseado de la respuesta. Solo se admite json formato.

LocalSource

Información del proveedor local de datos meteorológicos.

PrecipitationType

Especifica el tipo de precipitación ("Lluvia", "Nieve", "Hielo" o "Mezcla"). Si dbz es cero, precipitationType no está presente en la respuesta.

UnitType

Valor de ID numérico asociado al tipo de unidad que se muestra. Se puede utilizar para la traducción de unidades. Consulte Servicios meteorológicos en Azure Maps para obtener más información.

WeatherDataUnit

Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.

WeatherUnit

Valor específico de una unidad dada en relación con el clima.

WeatherUnitRange

Valores de temperatura devueltos.

WindDetails

Se devuelven los detalles del viento, incluida la velocidad y la dirección.

WindDirection

Dirección del viento

AirAndPollen

Nombre Tipo Description
category

string

Categoría de la calidad del aire o tipo de contaminación. Por ejemplo, bajo, alto, bueno, moderado, insalubre, peligroso.

categoryValue

integer (int32)

Valor asociado a la calidad del aire o categoría de contaminación. Estos valores oscilan entre 1 y 6. 1 que implica buenas condiciones, 6 que implica condiciones peligrosas.

name

string

Nombre del polen o contaminante. Por ejemplo, el césped, el moho, las malezas, la calidad del aire, los árboles y el índice UV.

type

string

Solo existe para la calidad del aire. Algunos ejemplos son la contaminación por ozono y partículas.

value

integer (int32)

Valor del tipo dado anteriormente. Los valores asociados con el moho, la hierba, las malezas y los árboles se expresan en unidades de partes por metro cúbico. Tanto la calidad del aire como los rayos UV son índices, por lo que no tienen unidades.

DailyForecast

Nombre Tipo Description
airAndPollen

AirAndPollen[]

Calidad del aire

date

string (date-time)

La fecha y la hora de la observación actual se muestran en formato ISO 8601, por ejemplo, 2019-10-27T19:39:57-08:00.

day

DayOrNight

Detalle del pronóstico del día

degreeDaySummary

DegreeDaySummary

Resumen de la temperatura media de la información de grados día de calefacción o grados día de enfriamiento

hoursOfSun

number (float)

Horas de sol.

night

DayOrNight

Detalle del pronóstico nocturno

realFeelTemperature

WeatherUnitRange

RealFeel™ Temperature siendo devuelta.

realFeelTemperatureShade

WeatherUnitRange

RealFeel™ Temperature siendo devuelta. Describe cómo se siente realmente la temperatura a la sombra.

sources

string[]

Fuente(s) de los datos de previsión.

temperature

WeatherUnitRange

Valores de temperatura del día.

DailyForecastResult

Nombre Tipo Description
forecasts

DailyForecast[]

Datos de pronóstico para cada día solicitado.

summary

DailyForecastSummary

Resumen de las principales condiciones para el período de tiempo solicitado. Tenga en cuenta que el resumen puede cubrir solo una parte del período de tiempo.

DailyForecastSummary

Resumen de las principales condiciones para el período de tiempo solicitado. Tenga en cuenta que el resumen puede cubrir solo una parte del período de tiempo.

Nombre Tipo Description
category

string

una o 2 palabras para resumir la frase.

endDate

string (date-time)

Fecha y hora en que finaliza el período de resumen, que se muestra en formato ISO 8601, por ejemplo, 2019-10-27T19:39:57-08:00.

phrase

string

Frase resumen de la previsión diaria. Se muestra en el idioma especificado.

severity

integer (int32)

severidad

startDate

string (date-time)

Fecha y hora en que el resumen está en vigor, mostrado en formato ISO 8601, por ejemplo, 2019-10-27T19:39:57-08:00.

DayOrNight

Nombre Tipo Description
cloudCover

integer (int32)

Porcentaje que representa la nubosidad.

hasPrecipitation

boolean

Indica la presencia o ausencia de precipitaciones. Verdadero indica la presencia de precipitación, falso indica la ausencia de precipitación.

hoursOfIce

number (float)

Horas de hielo.

hoursOfPrecipitation

number (float)

Horas de precipitación

hoursOfRain

number (float)

Horas de lluvia.

hoursOfSnow

number (float)

Horas de nieve.

ice

WeatherUnit

Hielo

iceProbability

integer (int32)

Porcentaje que representa la probabilidad de hielo. Por ejemplo, '30'.

iconCode

IconCode (int32)

Valor numérico que representa una imagen que muestra el iconPhrasearchivo . Consulte Servicios meteorológicos en Azure Maps para obtener más información.

iconPhrase

string

Descripción de la frase del icono. Se muestra en el idioma especificado. Por ejemplo, 'Sunny'.

localSource

LocalSource

Información del proveedor local de datos meteorológicos.

longPhrase

string

Descripción de la frase del pronóstico en el idioma especificado. Azure Maps intenta mantener esta frase por debajo de los 100 caracteres, pero algunos idiomas o eventos meteorológicos pueden dar lugar a una longitud de frase más larga, superior a 100 caracteres.

precipitationIntensity

string

Descripción de la intensidad.

precipitationProbability

integer (int32)

Porcentaje que representa la probabilidad de precipitación. Por ejemplo, '20'.

precipitationType

PrecipitationType

Especifica el tipo de precipitación ("Lluvia", "Nieve", "Hielo" o "Mezcla"). Si dbz es cero, precipitationType no está presente en la respuesta.

rain

WeatherUnit

Lluvia

rainProbability

integer (int32)

Porcentaje que representa la probabilidad de lluvia. Por ejemplo, '40'.

shortPhrase

string

Descripción de la frase del pronóstico en el idioma especificado. Azure Maps intenta mantener esta frase por debajo de los 30 caracteres, pero algunos idiomas o eventos meteorológicos pueden dar lugar a una longitud de frase más larga, superior a 30 caracteres.

snow

WeatherUnit

Nieve

snowProbability

integer (int32)

Porcentaje que representa la probabilidad de nieve. Por ejemplo, '30'.

thunderstormProbability

integer (int32)

Porcentaje que representa la probabilidad de una tormenta eléctrica. Por ejemplo, '80'.

totalLiquid

WeatherUnit

Equivalente líquido total de precipitación durante el período de pronóstico.

wind

WindDetails

Se devuelven los detalles del viento, incluida la velocidad y la dirección.

windGust

WindDetails

Ráfaga de viento. La ráfaga de viento es un aumento repentino y breve de la velocidad del viento.

DegreeDaySummary

Nombre Tipo Description
cooling

WeatherUnit

Número de grados en que la temperatura media está por encima de 65 grados F / 18 grados C.

heating

WeatherUnit

Número de grados en que la temperatura media está por debajo de 65 grados F / 18 grados C.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

IconCode

Valor numérico que representa una imagen que muestra el iconPhrasearchivo . Consulte Servicios meteorológicos en Azure Maps para obtener más información.

Valor Description
1

Soleado

10
11

Niebla

12

Chubascos

13

Principalmente nublado con chubascos

14

Parcialmente soleado con chubascos

15

Tormentas

16

Principalmente nublado con tormenta

17

Parcialmente soleado con tormenta

18

Lluvia

19

Nevisca

2

Principalmente soleado

20

Principalmente nublado con nevisca

21

Principalmente soleado con nevisca

22

Nieve

23

Principalmente nublado con nieve

24

Hielo

25

Aguanieve

26

Lluvia helada

27
28
29

Lluvia y nieve

3

Parcialmente soleado

30

Caliente

31

Frío

32

Viento

33

Claro

34

Principalmente despejado

35

Parcialmente nublado

36

Nubes intermitentes (noche)

37

Calima

38

Mayormente nublado (noche)

39

Parcialmente nublado con chubascos

4

Nubes intermitentes

40

Mayormente nublado con chubascos (noche)

41

Parcialmente nublado con tormenta

42

Mayormente nublado con tormentas eléctricas (noche)

43

Mayormente nublado con ráfagas (Noche)

44

Mayormente nublado con nieve (noche)

5

Calima

6

Principalmente nublado

7

Turbio

8

Cubierto

9

JsonFormat

Formato deseado de la respuesta. Solo se admite json formato.

Valor Description
json

el formato de intercambio de datos de notación de objetos JavaScript

LocalSource

Información del proveedor local de datos meteorológicos.

Nombre Tipo Description
id

integer (int32)

Identificador numérico, único para el proveedor de datos local.

name

string

Nombre del proveedor de datos local. El nombre se muestra en el idioma especificado por el código de idioma en la dirección URL, si está disponible. De lo contrario, el nombre se muestra en inglés o en el idioma en el que se proporcionó el nombre.

weatherCode

string

Código meteorológico proporcionado por el proveedor de datos local. Este código meteorológico permite que el pronóstico coincida con los iconos proporcionados por el proveedor de datos local en lugar de con los iconos de Azure Maps.

PrecipitationType

Especifica el tipo de precipitación ("Lluvia", "Nieve", "Hielo" o "Mezcla"). Si dbz es cero, precipitationType no está presente en la respuesta.

Valor Description
Ice

Hielo

Mix

Mezclar

Rain

Lluvia

Snow

Nieve

UnitType

Valor de ID numérico asociado al tipo de unidad que se muestra. Se puede utilizar para la traducción de unidades. Consulte Servicios meteorológicos en Azure Maps para obtener más información.

Valor Description
0

pies

1

Pulgadas

10

metrospor segundo

11

hectoPascales

12

pulgadasOfMercurio

13

kiloPascales

14

Milibares

15

milímetrosDeMercurio

16

librasPorPulgada Cuadrada

17

grados centígrados

18

grados Fahrenheit

19

grados Kelvin

2

millas

20

por ciento

21

flotante

22

entero

3

Milímetro

31

MicrogramosPerCubicMeterOfAir

4

centímetro

5

Metro

6

kilómetro

7

kilómetrosPor hora

8

Nudos

9

millasPor hora

WeatherDataUnit

Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric.

Valor Description
imperial

Datos devueltos en unidades imperiales. Algunos ejemplos de unidades del sistema imperial son Fahrenheit y milla.

metric

Devuelva los datos en unidades métricas. Algunos ejemplos de unidades del sistema métrico son Celsius y kilómetro.

WeatherUnit

Valor específico de una unidad dada en relación con el clima.

Nombre Tipo Description
unit

string

Tipo de unidad para el valor devuelto.

unitType

UnitType (int32)

Valor de ID numérico asociado al tipo de unidad que se muestra. Se puede utilizar para la traducción de unidades. Consulte Servicios meteorológicos en Azure Maps para obtener más información.

value

number (float)

Valor redondeado.

WeatherUnitRange

Valores de temperatura devueltos.

Nombre Tipo Description
maximum

WeatherUnit

Temperatura máxima para el período de tiempo

minimum

WeatherUnit

Temperatura mínima para el período de tiempo.

WindDetails

Se devuelven los detalles del viento, incluida la velocidad y la dirección.

Nombre Tipo Description
direction

WindDirection

Dirección del viento

speed

WeatherUnit

Velocidad del viento en unidad especificada.

WindDirection

Dirección del viento

Nombre Tipo Description
degrees

integer (int32)

Dirección del viento en grados acimutales, comenzando en el norte verdadero y continuando en el sentido de las agujas del reloj. El norte es de 0 grados, el este es de 90 grados, el sur es de 180 grados, el oeste es de 270 grados. Valores posibles de 0 a 359.

localizedDescription

string

Abreviatura de dirección en el idioma especificado.