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 |
Formato deseado de la respuesta. Solo se admite |
|
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:
|
|
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 |
Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric. |
Encabezado de la solicitud
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo |
|
Other Status Codes |
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.
- Para obtener más información sobre la plataforma de identidad de Microsoft, consulte introducción a la plataforma de identidad de Microsoft.
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 |
---|---|
Air |
|
Daily |
|
Daily |
|
Daily |
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. |
Day |
|
Degree |
|
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Icon |
Valor numérico que representa una imagen que muestra el |
Json |
Formato deseado de la respuesta. Solo se admite |
Local |
Información del proveedor local de datos meteorológicos. |
Precipitation |
Especifica el tipo de precipitación ("Lluvia", "Nieve", "Hielo" o "Mezcla"). Si dbz es cero, precipitationType no está presente en la respuesta. |
Unit |
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. |
Weather |
Especifica que se devuelvan los datos en unidades métricas o en unidades imperiales. El valor predeterminado es metric. |
Weather |
Valor específico de una unidad dada en relación con el clima. |
Weather |
Valores de temperatura devueltos. |
Wind |
Se devuelven los detalles del viento, incluida la velocidad y la dirección. |
Wind |
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 |
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 |
Detalle del pronóstico del día |
|
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 |
Detalle del pronóstico nocturno |
|
realFeelTemperature |
RealFeel™ Temperature siendo devuelta. |
|
realFeelTemperatureShade |
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 |
Valores de temperatura del día. |
DailyForecastResult
Nombre | Tipo | Description |
---|---|---|
forecasts |
Datos de pronóstico para cada día solicitado. |
|
summary |
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 |
Hielo |
|
iceProbability |
integer (int32) |
Porcentaje que representa la probabilidad de hielo. Por ejemplo, '30'. |
iconCode |
Icon |
Valor numérico que representa una imagen que muestra el |
iconPhrase |
string |
Descripción de la frase del icono. Se muestra en el idioma especificado. Por ejemplo, 'Sunny'. |
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 |
Especifica el tipo de precipitación ("Lluvia", "Nieve", "Hielo" o "Mezcla"). Si dbz es cero, precipitationType no está presente en la respuesta. |
|
rain |
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 |
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 |
Equivalente líquido total de precipitación durante el período de pronóstico. |
|
wind |
Se devuelven los detalles del viento, incluida la velocidad y la dirección. |
|
windGust |
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 |
Número de grados en que la temperatura media está por encima de 65 grados F / 18 grados C. |
|
heating |
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 |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
IconCode
Valor numérico que representa una imagen que muestra el iconPhrase
archivo . 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 |
Unit |
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 |
Temperatura máxima para el período de tiempo |
|
minimum |
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 |
Dirección del viento |
|
speed |
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. |