Weather - Get Daily Forecast

Servicio:: Maps

Versión de la API:: 1.1

Ú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.

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}

Con parámetros opcionales:

GET {endpoint}/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
endpoint	path	True	string (uri)	El nombre de host del servicio Azure Maps. Usa `https://atlas.microsoft.com` para la nube pública Azure. Para dirigirse a una geografía Azure Maps específica o a una nube soberana, véase Azure Maps alcance geográfico.
format	path	True	JsonFormat	Formato deseado de la respuesta. Solo se admite `json` formato.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.
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 (int32)	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. `45` - Devolver datos de previsión para los próximos 45 días.
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 solicitud

Nombre	Requerido	Tipo	Description
x-ms-client-id		string	Indica la cuenta destinada a usarse con el modelo de seguridad Microsoft Entra ID. Este ID único para la cuenta de Azure Maps puede obtenerse desde la API de la cuenta Azure Maps plano de gestión. Para más información sobre el uso de la seguridad Microsoft Entra ID en Azure Maps, consulte Gestionar la autenticación en Azure Maps.

Respuestas

Nombre	Tipo	Description
200 OK	DailyForecastResult	La solicitud se ha realizado correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

AadToken

Estos son los flujos Microsoft Entra OAuth 2.0. Cuando se combina con el control de acceso basado en roles Azure puede usarse para controlar el acceso a Azure Maps APIs REST. Los controles de acceso basados en roles de Azure se utilizan para designar el acceso a una o más cuentas o subrecursos de recursos 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.

Note

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 Maps.
El Authorization URL es específico de la instancia de nube pública de Azure. Las nubes soberanas tienen URLs de Autorización y configuraciones de Microsoft Entra ID únicas.
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

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: header

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

HTTP

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

Respuesta de muestra

status code:: 200

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

Definiciones

Nombre	Description
AirAndPollen	Una entrada describe `DailyForecast.airAndPollen` un único indicador de polen, calidad del aire o índice UV para el día. La `name` propiedad determina qué tipo de indicador representa la entrada: Polen: `name` es árbol,hierba, ambrosía o moho. `value` da la cantidad prevista y `category` / `categoryValue` la califícala de Baja a Alta. Calidad del aire: `name` es calidad del aire e `type` identifica el contaminante que se está midiendo (uno de PM2.5, PM10, O3, NO2, SO2 o CO). `category` / `categoryValue` Califica la calidad del aire de Buena a Peligrosa. Índice UV: `name` es UVIndex. `value` es el índice UV (0 a 11+), y `category` / `categoryValue` se valora el riesgo de exposición de Bajo a Extremo. `category` es la etiqueta cualitativa del indicador y `categoryValue` es la calificación correspondiente del 1 al 6, donde 1 indica las condiciones más seguras y 6 las más peligrosas.
DailyForecast	La previsión para un día natural en la ubicación especificada devolvía una entrada por día en el `forecasts` array en `DailyForecastResult`. Incluye el rango de temperaturas altas/bajas del día, rangos RealFeel (normales y sombreados), horas esperadas de sol, totales de grados/refrigeración por día, una variedad de indicadores de calidad del aire, polen e índice UV, y bloques de detalle separados para las partes diurnas y nocturnas (precipitación, viento, cobertura de nubes y más). El `sources` array lista los proveedores de datos que contribuyen a la prevision.
DailyForecastDetail	Detalles del pronóstico para medio día. La misma forma se usa para ambos `DailyForecast.day` (de amanecer a atardecer) y `DailyForecast.night` (de puesta de sol a siguiente amanecer), por lo que todas las referencias a "este periodo" que aparecen a continuación se refieren a esa parte específica de día o noche, nunca a las 24 horas completas del día. Incluye un icono y frases de pronóstico, tipo / intensidad / probabilidades de precipitación, totales de acumulación, horas de precipitación, viento y cobertura de nubes.
DailyForecastResult	La respuesta fue devuelto por la operación de Previsión Diaria, proporcionando un pronóstico meteorológico día a día para una ubicación específica. Incluye un nivel `summary` superior que describe las condiciones dominantes y la gravedad de la ventana solicitada, además de un `forecasts` array con una `DailyForecast` entrada por día. El número de inscripciones coincide con el solicitado `duration` (1, 5, 10, 15, 25 o 45 días; 25 y 45 requieren un SKU S1).
DailyForecastSummary	Un resumen a gran nivel de las condiciones meteorológicas dominantes a lo largo de parte o de la totalidad de la ventana de pronóstico diario solicitada. La ventana resumida puede ser más estrecha que la solicitud completa, por ejemplo, cuando se espera un clima significativo (como un sistema de tormentas) durante solo una parte del periodo, y está delimitada por `startDate` y `endDate`. Las condiciones en sí se describen tanto como una forma `phrase`libre, una etiqueta de una o dos palabras `category` y una calificación numérica `severity` .
DegreeDaySummary	Los totales de grados por día de calefacción y refrigeración para un solo día, se utilizan para estimar la demanda energética de calentar o enfriar un edificio. Cada valor es el número de grados en que la temperatura media del día difiere de la línea base de 65°F (18°C ), en la unidad de temperatura especificada en la solicitud: los grados por debajo de la línea base contribuyen a `heating`, los grados por encima de ella contribuyen a `cooling`.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta común a errores para todas las APIs de Azure Resource Manager para devolver detalles de error por operaciones fallidas. (Esto también sigue el formato de respuesta de error de OData).
IconCode	El código numérico de condiciones meteorológicas que identifica qué icono mostrar. Cada valor en esta enumeración corresponde a un icono meteorológico de Azure Maps (como Sunny, Cloudy o Thunderstorms) y se empareja con un homólogo `iconPhrase` legible devuelto junto a él. El mismo código puede aparecer en respuestas actuales, horarias, diarias, de cuarto de día y minuto a minuto, permitiendo a las aplicaciones mostrar un conjunto de iconos consistente en todos los servicios meteorológicos. Para la lista completa de códigos, los iconos a los que se asignan y ejemplos de imágenes, véase Servicios meteorológicos en Azure Maps.
JsonFormat	Formato deseado de la respuesta. Solo se admite `json` formato.
LocalSource	Información sobre un proveedor local de datos meteorológicos utilizado para obtener la previsión en `DailyForecastDetail.localSource`. Identifica al proveedor (`id`, `name`) y expone el perfil nativo `weatherCode` del proveedor para que las aplicaciones puedan renderizar el propio conjunto de iconos del proveedor en lugar de los iconos predeterminados de Azure Maps.
PrecipitationType	Especifica el tipo de precipitación. Los valores válidos son Lluvia, Nieve, Hielo o Mezcla. Esta propiedad se incluye en la respuesta cuando dBZ es mayor que cero.
UnitType	Un valor entero asociado al tipo de unidad que se está mostrando. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para más información, consulte Servicios meteorológicos en Azure Maps.
WeatherDataUnit	Especifica si devolver datos en unidades métricas o imperiales, con métrica como valor predeterminado. Por ejemplo: Métrica: milímetro (mm), metro (m), kilómetro (km), Celsius (C) Imperial: pulgada (pulgada), pie (pie), milla (mi), Fahrenheit (F)
WeatherValue	Valores para métricas relacionadas con el clima, como temperatura, punto de rocío y velocidad del viento, presentados en unidades métricas o imperiales, según se especifica en el parámetro unitario URI. Para más información, véase Tipos de unidades en el artículo Servicios meteorológicos en Azure Maps.
WeatherValueRange	Proporciona las temperaturas más altas y más bajas previstas para el periodo especificado, medidas en grados Celsius (°C) o Fahrenheit (°F), según la unidad especificada en la solicitud.
WindDetails	Proporciona la velocidad prevista del viento, medida en unidades como kilómetros por hora (km/h) o millas por hora (mph), dependiendo de la unidad especificada en la solicitud. También indica la dirección del viento medida en grados acimutales, comenzando en el norte verdadero y moviéndose en sentido horario. El norte corresponde a 0°, el este a 90°, el sur a 180° y el oeste a 270°. Los valores posibles varían de 0° a 359°.
WindDirection	Proporciona detalles sobre la dirección del viento, incluyendo la dirección en grados de azimut y una abreviatura localizada de la dirección del viento.

AirAndPollen

Objeto

Una entrada describe DailyForecast.airAndPollen un único indicador de polen, calidad del aire o índice UV para el día. La name propiedad determina qué tipo de indicador representa la entrada:

Polen: name es árbol,hierba, ambrosía o moho. value da la cantidad prevista y category / categoryValue la califícala de Baja a Alta.
Calidad del aire: name es calidad del aire e type identifica el contaminante que se está midiendo (uno de PM2.5, PM10, O3, NO2, SO2 o CO). category / categoryValue Califica la calidad del aire de Buena a Peligrosa.
Índice UV: name es UVIndex. value es el índice UV (0 a 11+), y category / categoryValue se valora el riesgo de exposición de Bajo a Extremo.

category es la etiqueta cualitativa del indicador y categoryValue es la calificación correspondiente del 1 al 6, donde 1 indica las condiciones más seguras y 6 las más peligrosas.

Nombre	Tipo	Description
category	string	Una breve etiqueta cualitativa para el indicador, devuelta en el idioma especificado en la solicitud. Los valores posibles dependen de `name`: Polen: Bajo, moderado, alto o muy alto. Calidad del aire: Buena, Moderada, Poco saludable para grupos sensibles, Poco saludable, Muy Poco saludable o Peligrosa. Índice UV: Bajo, Moderado, Alto, Muy Alto o Extremo.
categoryValue	integer (int32)	Una valoración numérica del 1 al 6 que se empareja con `category`, donde 1 indica las condiciones más seguras y 6 las más peligrosas. Úsalo cuando se necesite un valor numérico estable e independiente del idioma en lugar de la etiqueta localizada `category` .
name	string	Identifica qué indicador representa esta entrada. Ya sea el nombre de una fuente de polen (árbol,hierba, ambrosía o moho), calidad del aire (en cuyo `type` caso identifica el contaminante) o UVIndex.
type	string	¿Cuándo `name` es AirQuality, el contaminante específico que se mide uno de PM2.5, PM10, O3 (ozono), NO2 (dióxido de nitrógeno), SO2 (dióxido de azufre) o CO (monóxido de carbono). No se devuelven para entradas de polen ni de índice UV.
value	integer (int32)	La medida numérica para este indicador. La unidad depende de `name`: Para el polen, el conteo de polen previsto. Para la calidad del aire, la concentración de contaminantes en unidades apropiadas al contaminante - típicamente microgramos por metro cúbico (μg/m³) para partículas y partes por billón (ppb) para gases como el ozono. Para el índice UV, un valor índice de 0 a 11+. Tanto la calidad del aire como el índice UV son índices en sí mismos, por lo que se informan como números sin unidades.

DailyForecast

Objeto

La previsión para un día natural en la ubicación especificada devolvía una entrada por día en el forecasts array en DailyForecastResult. Incluye el rango de temperaturas altas/bajas del día, rangos RealFeel (normales y sombreados), horas esperadas de sol, totales de grados/refrigeración por día, una variedad de indicadores de calidad del aire, polen e índice UV, y bloques de detalle separados para las partes diurnas y nocturnas (precipitación, viento, cobertura de nubes y más). El sources array lista los proveedores de datos que contribuyen a la prevision.

Nombre	Tipo	Description
airAndPollen	AirAndPollen[]	Indicadores pronosticados de calidad del aire, polen e índice UV para el día. Cada entrada indica un nombre (como Árbol, Hierba, Ambrosia, Moho, Calidad del Aire o UVIndex), un valor numérico y un cualitativo `category` (como Bajo, Moderado, Alto, Bueno, Poco saludable o Peligroso) para que las aplicaciones puedan señalar posibles riesgos para la salud.
date	string (date-time)	La fecha del calendario que cubre esta previsión en formato ISO 8601 (`yyyy-mm-ddThh:mm:ss-hh:mm`). Por ejemplo, 2025-04-29T07:00:00-07:00.
day	DailyForecastDetail	El pronóstico detallado para la parte diurna del día, incluyendo temperatura, precipitaciones, viento, cobertura de nubes y otros atributos clave.
degreeDaySummary	DegreeDaySummary	Totales de grados diarios de calefacción y refrigeración para el día, usados para estimar la demanda energética para el control climático de edificios.
hoursOfSun	number (float)	El número esperado de horas de sol durante el día, útil para planificar actividades al aire libre y evaluar las condiciones generales diurnas.
night	DailyForecastDetail	El pronóstico detallado para la parte nocturna del día, incluyendo temperatura, precipitaciones, viento, nubosidad y otros atributos clave.
realFeelTemperature	WeatherValueRange	Los valores de temperatura RealFeel™ altos y bajos para el día, en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud. Desarrollado por AccuWeather, RealFeel combina la temperatura del aire con la humedad, el viento, la cobertura de nubes, la intensidad solar y otros factores para indicar cómo se siente realmente el tiempo. Para más información, consulta ¿Cuál es la temperatura RealFeel de AccuWeather?
realFeelTemperatureShade	WeatherValueRange	Los valores de temperatura RealFeel™ altos y bajos para el día en zonas sombreadas, en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud. Como `realFeelTemperature`, pero excluye el efecto de calentamiento de la luz solar directa, dando una sensación más precisa de cómo se siente el clima a la sombra.
sources	string[]	Los proveedores de datos que contribuyeron a la previsión de este día.
temperature	WeatherValueRange	Las temperaturas máximas y bajas previstas para el día, en grados Celsius (°C) o Fahrenheit (°F), dependiendo de la unidad especificada en la solicitud.

DailyForecastDetail

Objeto

Detalles del pronóstico para medio día. La misma forma se usa para ambos DailyForecast.day (de amanecer a atardecer) y DailyForecast.night (de puesta de sol a siguiente amanecer), por lo que todas las referencias a "este periodo" que aparecen a continuación se refieren a esa parte específica de día o noche, nunca a las 24 horas completas del día. Incluye un icono y frases de pronóstico, tipo / intensidad / probabilidades de precipitación, totales de acumulación, horas de precipitación, viento y cobertura de nubes.

Nombre	Tipo	Description
cloudCover	integer (int32)	El porcentaje del cielo cubierto de nubes durante este periodo fue de 0 (cielo despejado) a 100 (completamente nublado). Puede ser NULL.
hasPrecipitation	boolean	`true` si se espera precipitación (lluvia, nieve, aguanieve o granizo) durante este periodo; `false` en caso contrario.
hoursOfIce	number (float)	El número total de horas durante este periodo en las que se espera la formación de hielo.
hoursOfPrecipitation	number (float)	El número total de horas durante este periodo en las que se espera cualquier precipitación (lluvia, nieve, aguanieve o granizo).
hoursOfRain	number (float)	El número total de horas durante este periodo en las que se espera lluvia.
hoursOfSnow	number (float)	El número total de horas durante este periodo en las que se espera nieve.
ice	WeatherValue	La cantidad de acumulación de hielo esperada durante este periodo, en milímetros (mm) o pulgadas (in), dependiendo de la unidad especificada en la solicitud.
iceProbability	integer (int32)	La probabilidad de formación de hielo durante este periodo, expresada como un porcentaje de 0 a 100, donde 0 significa que no hay posibilidad de hielo y 100 significa que las condiciones de hielo son seguras.
iconCode	IconCode	Valor numérico que representa una imagen que corresponde a las condiciones meteorológicas previstas para este periodo, descritas por la `iconPhrase` propiedad. El valor numérico corresponde a un icono meteorológico de Azure Maps; para la lista completa, consulta Servicios meteorológicos en Azure Maps. Puede ser NULL.
iconPhrase	string	Una frase corta que describe el icono, devuelta en el idioma especificado en la solicitud. Por ejemplo, Sunny.
localSource	LocalSource	Información sobre el proveedor local de datos meteorológicos cuyo código de iconos y código meteorológico se usaron para ese periodo, cuando se seleccionó uno.
longPhrase	string	Una frase más larga y descriptiva para este periodo, devuelta en el idioma especificado en la solicitud. Azure Maps intenta mantener esta frase por debajo de 100 caracteres, pero algunos idiomas o eventos meteorológicos pueden producir una cadena más larga.
precipitationIntensity	string	Una breve descripción cualitativa de la intensidad de la precipitación para este periodo, por ejemplo, Ligera, Moderada o Intensa. Devuelta en el lenguaje especificado en la solicitud, y solo cuando `hasPrecipitation` es `true`.
precipitationProbability	integer (int32)	La probabilidad de cualquier precipitación durante este periodo, expresada como un porcentaje de 0 a 100, donde 0 significa que no hay probabilidad de precipitación y 100 significa que precipitación es segura.
precipitationType	PrecipitationType	El tipo dominante de precipitación esperado durante este periodo es de lluvia, nieve, hielo o mezcla. Solo se devuelve cuando `hasPrecipitation` es `true`.
rain	WeatherValue	La cantidad de lluvia esperada durante este periodo, en milímetros (mm) o pulgadas (in), dependiendo de la unidad especificada en la solicitud.
rainProbability	integer (int32)	La probabilidad de lluvia durante este periodo, expresada como un porcentaje de 0 a 100, donde 0 significa que no hay probabilidad de lluvia y 100 significa que lluvia es segura.
shortPhrase	string	Una frase corta que describe la previsión para este periodo, devuelta en el idioma especificado en la solicitud. Azure Maps intenta mantener esta frase por debajo de 30 caracteres, pero algunos idiomas o eventos meteorológicos pueden producir una cadena más larga.
snow	WeatherValue	La cantidad de nieve acumulada prevista durante este periodo, en centímetros (cm) o pulgadas (pulgadas), dependiendo de la unidad especificada en la solicitud.
snowProbability	integer (int32)	La probabilidad de nieve durante este periodo, expresada como un porcentaje de 0 a 100, donde 0 significa que no hay posibilidad de nieve y 100 significa que nieve es segura.
thunderstormProbability	integer (int32)	La probabilidad de una tormenta durante este periodo, expresada como un porcentaje de 0 a 100, donde 0 significa que no hay probabilidad de tormenta y 100 significa que una tormenta es segura.
totalLiquid	WeatherValue	La cantidad total de precipitación líquida (como lluvia, más el equivalente líquido de cualquier nieve o hielo) esperada durante este periodo, en milímetros (mm) o pulgadas (in), dependiendo de la unidad especificada en la solicitud.
wind	WindDetails	La velocidad y dirección del viento previstas para este periodo. La velocidad del viento es en kilómetros por hora (km/h) o millas por hora (mph), dependiendo de la unidad especificada en la solicitud. La dirección del viento se mide en grados de azimut, desde 0° (norte verdadero) hasta 359°, moviéndose en sentido horario: el este es 90°, el sur 180°, el oeste 270°.
windGust	WindDetails	La velocidad y dirección máxima esperada de viento de ráfaga corta durante este periodo. Las ráfagas de viento son aumentos repentinos y breves en la velocidad del viento que importan para actividades como la aviación, la vela y el vuelo de cometas. La velocidad está en kilómetros por hora (km/h) o millas por hora (mph) dependiendo de la unidad especificada en la solicitud, y la dirección utiliza la misma convención de azimut que `wind`.

DailyForecastResult

Objeto

La respuesta fue devuelto por la operación de Previsión Diaria, proporcionando un pronóstico meteorológico día a día para una ubicación específica. Incluye un nivel summary superior que describe las condiciones dominantes y la gravedad de la ventana solicitada, además de un forecasts array con una DailyForecast entrada por día. El número de inscripciones coincide con el solicitado duration (1, 5, 10, 15, 25 o 45 días; 25 y 45 requieren un SKU S1).

Nombre Tipo Description

forecasts

Nombre	Tipo	Description
forecasts	DailyForecast[]	Las previsiones diarias, en orden cronológico con una entrada por día en la sección solicitada `duration`. Cada entrada informa `DailyForecast` de las temperaturas máximas/bajas del día, el rango de RealFeel, las horas de sol, los totales de grados por día de calefacción/refrigeración, índices de aire y polen, bloques de detalle separados de día y noche (precipitación, viento, cobertura de nubes y más), y las fuentes de datos que contribuyen al pronóstico.
summary	DailyForecastSummary	Un resumen a gran nivel de las condiciones meteorológicas dominantes a lo largo de la ventana de pronóstico solicitada. El resumen puede cubrir solo parte de la ventana por ejemplo, cuando se espera un clima significativo (como un sistema de tormentas) durante una parte de este tiempo, en lugar de durante todo el periodo.

DailyForecast[]

Las previsiones diarias, en orden cronológico con una entrada por día en la sección solicitada duration. Cada entrada informa DailyForecast de las temperaturas máximas/bajas del día, el rango de RealFeel, las horas de sol, los totales de grados por día de calefacción/refrigeración, índices de aire y polen, bloques de detalle separados de día y noche (precipitación, viento, cobertura de nubes y más), y las fuentes de datos que contribuyen al pronóstico.

summary

DailyForecastSummary

Un resumen a gran nivel de las condiciones meteorológicas dominantes a lo largo de la ventana de pronóstico solicitada. El resumen puede cubrir solo parte de la ventana

por ejemplo, cuando se espera un clima significativo (como un sistema de tormentas) durante una parte de este tiempo, en lugar de durante todo el periodo.

DailyForecastSummary

Objeto

Un resumen a gran nivel de las condiciones meteorológicas dominantes a lo largo de parte o de la totalidad de la ventana de pronóstico diario solicitada. La ventana resumida puede ser más estrecha que la solicitud completa, por ejemplo, cuando se espera un clima significativo (como un sistema de tormentas) durante solo una parte del periodo, y está delimitada por startDate y endDate. Las condiciones en sí se describen tanto como una forma phraselibre, una etiqueta de una o dos palabras category y una calificación numérica severity .

Nombre	Tipo	Description
category	string	Una etiqueta de una o dos palabras que categoriza las condiciones meteorológicas dominantes para la ventana resumida, por ejemplo, soleado, parcialmente nublado, lluvioso o nevado.
endDate	string (date-time)	El final de la ventana cubierto por este resumen, en formato RFC 3339 - por ejemplo, 2019-10-29T07:00:00-08:00. Puede ser antes de que termine la ventana de previsión solicitada si el evento resumido termina antes que ella.
phrase	string	Un breve resumen textual de forma libre de las condiciones meteorológicas dominantes para la ventana resumida, devuelto en el idioma especificado en la solicitud. Por ejemplo, se esperan chubascos de martes a jueves.
severity	integer (int32)	Una valoración numérica de severidad para el evento meteorológico resumido. Números más bajos ( excluyendo el 0) indican mayor severidad: 0: Desconocido 1: Significativo 2: Mayor 3: Moderado 4: Menor 5: Mínimo 6: Insignificante 7: Informativo
startDate	string (date-time)	El inicio de la ventana cubierta por este resumen, en formato RFC 3339 - por ejemplo, 2019-10-27T19:39:57-08:00. Puede ser posterior al inicio de la ventana de previsión solicitada si el evento resumido comienza a mitad de ella.

DegreeDaySummary

Objeto

Los totales de grados por día de calefacción y refrigeración para un solo día, se utilizan para estimar la demanda energética de calentar o enfriar un edificio. Cada valor es el número de grados en que la temperatura media del día difiere de la línea base de 65°F (18°C ), en la unidad de temperatura especificada en la solicitud: los grados por debajo de la línea base contribuyen a heating, los grados por encima de ella contribuyen a cooling.

Nombre	Tipo	Description
cooling	WeatherValue	Grados Días de Enfriamiento (CDD): el número de grados en que la temperatura media del día supera la línea base de 65°F (18°C). Valores más altos indican una mayor demanda de refrigeración. Reportado en grados Celsius (°C) o Fahrenheit (°F) según la unidad especificada en la solicitud.
heating	WeatherValue	Grados Día-Calefacción (HDD): el número de grados en que la temperatura media del día queda por debajo de la línea base de 65°F (18°C). Valores más altos indican una mayor demanda de calefacción. Reportado en grados Celsius (°C) o Fahrenheit (°F) según la unidad especificada en la solicitud.

ErrorAdditionalInfo

Objeto

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

Nombre	Tipo	Description
info		Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

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

Objeto

Respuesta común a errores para todas las APIs de Azure Resource Manager para devolver detalles de error por operaciones fallidas. (Esto también sigue el formato de respuesta de error de OData).

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

IconCode

Enumeración

El código numérico de condiciones meteorológicas que identifica qué icono mostrar. Cada valor en esta enumeración corresponde a un icono meteorológico de Azure Maps (como Sunny, Cloudy o Thunderstorms) y se empareja con un homólogo iconPhrase legible devuelto junto a él. El mismo código puede aparecer en respuestas actuales, horarias, diarias, de cuarto de día y minuto a minuto, permitiendo a las aplicaciones mostrar un conjunto de iconos consistente en todos los servicios meteorológicos.

Para la lista completa de códigos, los iconos a los que se asignan y ejemplos de imágenes, véase Servicios meteorológicos en Azure Maps.

Valor	Description
1	Soleado
2	Mayormente soleado
3	Parcialmente soleado
4	Nubes intermitentes
5	Sol brumoso
6	Mayormente nublado
7	Cloudy
8	Lúgubre (nublado)
11	Niebla
12	Showers
13	Principalmente nublado con chubascos
14	Parcialmente soleado con chubascos
15	Thunderstorms
16	Principalmente nublado con tormenta
17	Parcialmente soleado con tormenta
18	Lluvia
19	Flurries
20	Principalmente nublado con nevisca
21	Principalmente soleado con nevisca
22	Snow
23	Principalmente nublado con nieve
24	Hielo
25	Conjunto de reses
26	Lluvia helada
29	Lluvia y nieve
30	Hot
31	Frío
32	Windy
33	Clear
34	Mayormente claro
35	Parcialmente nublado
36	Nubes intermitentes
37	Luz de luna brumosa
38	Mayormente nublado
39	Parcialmente nublado con chubascos
40	Principalmente nublado con chubascos
41	Parcialmente nublado con tormenta
42	Principalmente nublado con tormenta
43	Principalmente nublado con nevisca
44	Principalmente nublado con nieve

JsonFormat

Enumeración

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

Objeto

Información sobre un proveedor local de datos meteorológicos utilizado para obtener la previsión en DailyForecastDetail.localSource. Identifica al proveedor (id, name) y expone el perfil nativo weatherCode del proveedor para que las aplicaciones puedan renderizar el propio conjunto de iconos del proveedor en lugar de los iconos predeterminados de Azure Maps.

Nombre	Tipo	Description
id	integer (int32)	Un identificador numérico que identifica de forma única al proveedor local de datos.
name	string	El nombre del proveedor local de datos, devuelto en el idioma especificado en la solicitud cuando esté disponible; de lo contrario, devuelto en inglés o en el idioma en que el proveedor lo suministró.
weatherCode	string	El código meteorológico nativo del proveedor para este pronóstico, adecuado para mapear al conjunto de iconos propio del proveedor en lugar del Azure Maps `iconCode`por defecto.

PrecipitationType

Enumeración

Especifica el tipo de precipitación. Los valores válidos son Lluvia, Nieve, Hielo o Mezcla. Esta propiedad se incluye en la respuesta cuando dBZ es mayor que cero.

Valor	Description
Ice	Hielo
Mix	Mix
Rain	Lluvia
Snow	Snow

UnitType

Enumeración

Un valor entero asociado al tipo de unidad que se está mostrando. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para más información, consulte Servicios meteorológicos en Azure Maps.

Valor	Description
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	meter
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	Grados centígrados
18	Fahrenheit
19	kelvin
20	percent
21	flotante
22	entero
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeración

Especifica si devolver datos en unidades métricas o imperiales, con métrica como valor predeterminado. Por ejemplo:

Métrica: milímetro (mm), metro (m), kilómetro (km), Celsius (C)
Imperial: pulgada (pulgada), pie (pie), milla (mi), Fahrenheit (F)

Valor	Description
imperial	Devolve datos usando unidades imperiales como Fahrenheit (F) para la temperatura y millas (mi) para la distancia.
metric	Devuelve datos utilizando unidades métricas como Celsius (C) para la temperatura y kilómetro (km) para la distancia.

WeatherValue

Objeto

Valores para métricas relacionadas con el clima, como temperatura, punto de rocío y velocidad del viento, presentados en unidades métricas o imperiales, según se especifica en el parámetro unitario URI. Para más información, véase Tipos de unidades en el artículo Servicios meteorológicos en Azure Maps.

Nombre	Tipo	Description
unit	string	La unidad de medida utilizada en el valor de retorno, como "C" para Celsius, "F" para Fahrenheit.
unitType	UnitType	Un entero que representa el tipo de unidad. Por ejemplo, 0 para pies, 1 para pulgadas, 2 para millas. Para una lista completa, véase Tipos de unidades en el artículo Servicios meteorológicos en Azure Maps.
value	number (float)	El valor medido expresado en la unidad especificada.

WeatherValueRange

Objeto

Proporciona las temperaturas más altas y más bajas previstas para el periodo especificado, medidas en grados Celsius (°C) o Fahrenheit (°F), según la unidad especificada en la solicitud.

Nombre	Tipo	Description
maximum	WeatherValue	Proporciona la temperatura máxima para el periodo especificado, medida en grados Celsius (°C) o Fahrenheit (°F), según la unidad especificada en la solicitud.
minimum	WeatherValue	Proporciona la temperatura mínima para el intervalo de tiempo especificado, medida en grados Celsius (°C) o Fahrenheit (°F), en función de la unidad especificada en la solicitud.

WindDetails

Objeto

Proporciona la velocidad prevista del viento, medida en unidades como kilómetros por hora (km/h) o millas por hora (mph), dependiendo de la unidad especificada en la solicitud. También indica la dirección del viento medida en grados acimutales, comenzando en el norte verdadero y moviéndose en sentido horario. El norte corresponde a 0°, el este a 90°, el sur a 180° y el oeste a 270°. Los valores posibles varían de 0° a 359°.

Nombre	Tipo	Description
direction	WindDirection	La dirección del viento se mide en grados acimutales, comenzando en el norte verdadero (0°) y moviéndose en sentido horario. El este corresponde a 90°, el sur a 180° y el oeste a 270°. Los valores posibles varían de 0° a 359°. Esta propiedad devuelve un entero que representa la dirección del viento.
speed	WeatherValue	La velocidad esperada del viento, medida en kilómetros por hora (km/h) o millas por hora (mph), dependiendo de la unidad especificada en la solicitud.

WindDirection

Objeto

Proporciona detalles sobre la dirección del viento, incluyendo la dirección en grados de azimut y una abreviatura localizada de la dirección del viento.

Nombre	Tipo	Description
degrees	integer (int32)	La dirección del viento se mide en grados acimutales, comenzando en el norte verdadero y moviéndose en sentido horario. El norte corresponde a 0 grados, el este a 90 grados, el sur a 180 grados y el oeste a 270 grados. Los valores posibles varían de 0 a 359 grados.
localizedDescription	string	Una abreviatura localizada de la dirección del viento, devuelta en el idioma especificado en la solicitud. Por ejemplo, `N` para el Norte, `E` para el Este, `S` para el Sur y `W` para el Oeste.