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.

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}

Con parámetros opcionales:

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	Indica la cuenta destinada a su uso con el modelo de seguridad de identificador de Microsoft Entra. Este identificador único para la cuenta de Azure Maps se puede obtener de la API de cuenta del plano de administración de Azure Maps. Para obtener más información sobre el uso de la seguridad de ID de Microsoft Entra en Azure Maps, consulte Administración de la autenticación en Azure Maps.

Respuestas

Nombre	Tipo	Description
200 OK	DailyForecastResult	OK
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.

Notes

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

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

{
  "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	El objeto AirAndPollen proporciona datos ambientales completos. Identifica varios tipos de polen como árboles, pastos, ambrosía y moho, así como contaminantes como PM2.5, PM10, O3, NO2, SO2 y CO. Además, informa del Índice UV en una escala del 1 al 10, ofrece descripciones cualitativas de la calidad del aire o los niveles de polen, y proporciona mediciones numéricas de la concentración de contaminantes o polen en el aire. Esta información detallada ayuda a los usuarios a evaluar la calidad del aire y las condiciones del polen a lo largo de su ruta de viaje.
DailyForecast	Proporciona información meteorológica detallada para un día específico, como temperatura, viento, precipitaciones, calidad del aire e índice UV.
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 corresponde a la condición meteorológica actual descrita por la `Phrase` propiedad. Para más información, consulte Servicios meteorológicos en Azure Maps. Puede ser NULL.
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. 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 número entero que representa el tipo de unidad. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para obtener una lista completa, consulte Servicios meteorológicos en Azure Maps.
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

Objeto

El objeto AirAndPollen proporciona datos ambientales completos. Identifica varios tipos de polen como árboles, pastos, ambrosía y moho, así como contaminantes como PM2.5, PM10, O3, NO2, SO2 y CO. Además, informa del Índice UV en una escala del 1 al 10, ofrece descripciones cualitativas de la calidad del aire o los niveles de polen, y proporciona mediciones numéricas de la concentración de contaminantes o polen en el aire. Esta información detallada ayuda a los usuarios a evaluar la calidad del aire y las condiciones del polen a lo largo de su ruta de viaje.

Nombre	Tipo	Description
category	string	Proporciona una descripción cualitativa de una palabra de la calidad del aire o del nivel de polen para el periodo de previsión, en el idioma especificado. Esta propiedad categoriza la calidad del aire o el recuento de polen en diferentes niveles, como bajo, alto, bueno, moderado, insalubre, peligroso, proporcionando a los usuarios una evaluación fácil de entender de las condiciones actuales.
categoryValue	integer (int32)	Proporciona una representación numérica de la calidad del aire o del nivel de polen. Este valor corresponde a la propiedad cualitativa `category` , ofreciendo una forma precisa de cuantificar la calidad del aire o el nivel de polen. Estos valores varían de 1 a 6, siendo 1 que indica buenas condiciones y 6 que se refieren a condiciones peligrosas.
name	string	Para el polen: Devuelve el nombre del polen, como árbol, hierba, ambrosía o moho. Para los contaminantes: Cuando la `name` propiedad es `AirQuality`, se devuelve el nombre del contaminante en la `type` propiedad. Los contaminantes válidos incluyen: PM2.5, PM10, O3, NO2, SO2 y CO. Para el índice UV: Cuando la `name` propiedad es `UVIndex`, el índice UV se devuelve en la `value` propiedad. Los valores válidos del índice UV varían de 0 a 11+ y representan la intensidad de la radiación ultravioleta. Los valores del Índice UV se categorizan de la siguiente manera: 0-2: Bajo 3-5: Moderado 6-7: Alto 8-10: Muy alto 11+: Extremo
type	string	Especifica el tipo de contaminante atmosférico que se está midiendo. Solo se usa cuando la `name` propiedad es igual a calidad de aire. Ejemplos de contaminantes atmosféricos incluyen las partículas en suspensión (PM2.5, PM10), el ozono (O3), el dióxido de nitrógeno (NO2), el dióxido de azufre (SO2) y el monóxido de carbono (CO).
value	integer (int32)	Proporciona una medición numérica de la concentración de contaminantes o polen en el aire. Este valor se expresa típicamente en unidades relevantes para el tipo de contaminante o polen que se está midiendo, como microgramos por metro cúbico (μg/m³) para partículas o partes por billón (ppb) para gases como el ozono. Tanto la calidad del aire como los rayos UV son índices, por lo que no tienen unidades.

DailyForecast

Objeto

Proporciona información meteorológica detallada para un día específico, como temperatura, viento, precipitaciones, calidad del aire e índice UV.

Nombre	Tipo	Description
airAndPollen	AirAndPollen[]	Una lista que contiene contaminantes, niveles de polen y el índice UV para la previsión diaria. Cada elemento de la lista incluye cantidades y categorías previstas (por ejemplo, bajos, altos, buenos, moderados, poco saludables, peligrosos) para evaluar los posibles riesgos para la salud.
date	string (date-time)	Fecha y hora de la observación actual, mostradas en formato ISO 8601 (aaaaaa-mm-ddThh:mm:ss-hh:mm). Por ejemplo, 2025-04-29T07:00:00-07:00.
day	DayOrNight	Proporciona información meteorológica detallada para el pronóstico diurno, incluyendo temperatura, precipitación, viento y otros atributos clave.
degreeDaySummary	DegreeDaySummary	Proporciona un resumen de los grados de calefacción y refrigeración. Los Grados Día de Calefacción (HDD) miden la demanda de energía para calentar un edificio, calculada en función de los grados en que la temperatura media diaria está por debajo de 65°F/18°C. Los grados día-enfriamiento (CDD) miden la demanda de energía para enfriar un edificio, calculada en función de los grados en los grados en los que la temperatura media de un día está por encima de 65°F/18°C. Este resumen ayuda en la gestión y planificación energética.
hoursOfSun	number (float)	Proporciona el número esperado de horas de sol para el día especificado.
night	DayOrNight	Proporciona información meteorológica detallada para el pronóstico nocturno, incluyendo temperatura, precipitación, viento y otros atributos clave.
realFeelTemperature	WeatherUnitRange	Proporciona valores de temperatura RealFeel™ para el día especificado, medidos en grados Celsius (C) o Fahrenheit (F), dependiendo de la unidad especificada en la solicitud. Esta métrica, desarrollada por AccuWeather, incorpora más de una docena de factores, incluyendo la humedad, la velocidad del viento, la cobertura de nubes y la intensidad solar, para ofrecer una medida completa de cómo se siente realmente el tiempo.
realFeelTemperatureShade	WeatherUnitRange	Proporciona valores de temperatura RealFeel™ para el día especificado en zonas sombreadas. Esta métrica, desarrollada por AccuWeather, incorpora más de una docena de factores, incluyendo humedad, velocidad del viento, cobertura de nubes e intensidad solar, para ofrecer una medida completa de cómo se siente realmente el tiempo a la sombra.
sources	string[]	Una lista de fuentes que contribuyen a los datos de pronóstico meteorológico.
temperature	WeatherUnitRange	Proporciona las temperaturas máximas y mínimas previstas para el día, en grados Celsius (C) o Fahrenheit (F), dependiendo de lo `unit` especificado en la solicitud.

DailyForecastResult

Objeto

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

Objeto

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	Ofrece un resumen de una o dos palabras de las condiciones meteorológicas previstas, como soleado, parcialmente nublado, lluvia o nieve.
endDate	string (date-time)	La fecha y hora de finalización del resumen de la previsión en formato ISO 8601 (aaa: mm:ss-hh:mm). Por ejemplo, 2025-04-29T07:00:00-07:00.
phrase	string	Proporciona un breve resumen textual de las condiciones meteorológicas diarias, mostrado en el idioma especificado.
severity	integer (int32)	Indica la severidad del tiempo pronosticado como un entero. Los números bajos representan mayor severidad: 0 = Desconocido, 1 = Significativo, 2 = Mayor, 3 = Moderado, 4 = Menor, 5 = Mínimo, 6 = Insignificante, 7 = Informativo.
startDate	string (date-time)	La fecha y hora de inicio del resumen de la previsión están en formato ISO 8601 (aaaa: mm:ss-hh:mm). Por ejemplo, 2025-04-29T07:00:00-07:00.

DayOrNight

Objeto

Nombre	Tipo	Description
cloudCover	integer (int32)	Porcentaje que representa la nubosidad.
hasPrecipitation	boolean	Un valor booleano que indica si se espera precipitación (lluvia, nieve, aguanieve o granizo) durante el periodo especificado. Retorna verdadero si se espera precipitación, en caso contrario falso.
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	Ice
iceProbability	integer (int32)	Porcentaje que representa la probabilidad de hielo. Por ejemplo, '30'.
iconCode	IconCode (int32)	Valor numérico que representa una imagen que corresponde a la condición meteorológica actual descrita por la `Phrase` propiedad. Para más información, consulte Servicios meteorológicos en Azure Maps. Puede ser NULL.
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. Los valores válidos son Lluvia, Nieve, Hielo o Mezcla. Esta propiedad se incluye en la respuesta cuando dBZ es mayor que cero.
rain	WeatherUnit	Rain
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	Snow
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

Objeto

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

Objeto

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

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 de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

IconCode

Enumeración

Valor numérico que representa una imagen que corresponde a la condición meteorológica actual descrita por la Phrase propiedad. Para más información, consulte Servicios meteorológicos en Azure Maps. Puede ser NULL.

Valor	Description
1	Sunny
2	Mayormente soleado
3	Parcialmente soleado
4	Nubes intermitentes
5	Sol brumoso
6	Mayormente nublado
7	Cloudy
8	Lúgubre (nublado)
9
10
11	Fog
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	Rain
19	Flurries
20	Principalmente nublado con nevisca
21	Principalmente soleado con nevisca
22	Snow
23	Principalmente nublado con nieve
24	Ice
25	Sleet
26	Lluvia helada
27
28
29	Lluvia y nieve
30	Hot
31	Cold
32	Windy
33	Clear
34	Mayormente claro
35	Parcialmente nublado
36	Nubes intermitentes (noche)
37	Luz de luna brumosa
38	Mayormente nublado (noche)
39	Parcialmente nublado con chubascos
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)

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

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	Ice
Mix	Mix
Rain	Rain
Snow	Snow

UnitType

Enumeración

Un número entero que representa el tipo de unidad. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para obtener una lista completa, 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	Celsius
18	Fahrenheit
19	kelvin
20	percent
21	float
22	integer
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Enumeración

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

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

WeatherUnit

Objeto

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)	Un número entero que representa el tipo de unidad. Por ejemplo, 17 para Celsius, 18 para Fahrenheit. Se puede utilizar para la traducción de unidades. Para obtener una lista completa, consulte Servicios meteorológicos en Azure Maps.
value	number (float)	Valor redondeado.

WeatherUnitRange

Objeto

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

Objeto

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

Objeto

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.

Compartir a través de

Weather - Get Daily Forecast

Parámetros de identificador URI

Encabezado de la solicitud

Respuestas

Seguridad

AADToken

Notes

Ámbitos

subscription-key

SAS Token

Ejemplos

Successfully retrieve detailed daily weather forecast for a given coordinate location

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AirAndPollen

DailyForecast

DailyForecastResult

DailyForecastSummary

DayOrNight

DegreeDaySummary

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

LocalSource

PrecipitationType

UnitType

WeatherDataUnit

WeatherUnit

WeatherUnitRange

WindDetails

WindDirection