Cómo Usar la API de OpenWeather

OpenWeatherMap es un sitio web que proporciona información detallada relacionada con el clima. Ofrece una API para que los desarrolladores de aplicaciones puedan beneficiarse de sus datos y funciones. Para conocer los datos y funciones que ofrece y entender cómo podemos utilizarlos, debemos examinar la Documentación de la API.

Planes de Precios

Otra clase de datos son los datos actuales y pronósticos futuros. En esta categoría se ofrecen diferentes opciones como la API de clima actual, la API de pronóstico de 5 días / 3 horas, la API de pronóstico de 16 días y mapas meteorológicos.

Para un uso de hasta 60 consultas por minuto, se puede crear una cuenta y obtener una clave de API gratuita que cubre algunas opciones. Las otras membresías tienen tipos como startup, desarrollador, profesional y empresa; el número de consultas por minuto, las opciones disponibles y, por lo tanto, el precio aumentan.

Hacemos clic en el botón "Get API key and start" bajo el título "Free" para crear una cuenta.

Obtención de la Clave API

Después de registrarnos, vamos a la sección API keys y podemos generar una clave API con el botón "Generate". Luego podemos examinar la documentación de la API.

En la documentación de la API se indica que, con 40,000 estaciones meteorológicas, se proporciona información del clima para cualquier ubicación en el mundo que abarca 200,000 ciudades, en formatos JSON, XML y HTML.

Se ofrecen diferentes opciones para la consulta. Por simplicidad, utilizaremos la opción de nombre de la ciudad. Se proporciona el formato de consulta relacionado y un ejemplo de consulta. Aquí se puede ver que después de la expresión api.openweathermap.org/data/2.5/weather?q= viene el nombre de la ciudad.

Después de especificar el nombre de la ciudad, agregamos el símbolo & y luego escribimos nombreDelParámetro=valorDelParámetro para realizar algunas configuraciones relacionadas con la consulta (como idioma, unidades). Estos son opcionales; si no los escribimos, se aceptan valores predeterminados (Inglés, Kelvin).

Configuración de Idioma

El primer parámetro que configuraremos para la consulta en nuestra aplicación es la opción de idioma. Pero primero agreguemos el valor appid. Para ello, después del símbolo & escribimos el nombre del parámetro appid y después del símbolo = pegamos la clave API que creamos anteriormente.

https://api.openweathermap.org/data/2.5/weather?q=Ankara&appid=b6907d289e10d714a

En la documentación de la API se puede ver que se ofrecen muchas opciones de idioma. Para turco, el valor del parámetro se proporciona como tr. Para ello, al final de la consulta se debe agregar la expresión &lang=tr como se muestra a continuación:

https://api.openweathermap.org/data/2.5/weather?q=Ankara&appid=b6907d289e10d714a&lang=tr

Especificación del Tipo de Formato

Deseamos que el formato de respuesta sea JSON. Sin embargo, en la documentación se puede ver que este es el formato predeterminado y no es necesario especificarlo. Si hubiéramos querido una respuesta en formato XML o HTML, habríamos tenido que agregar el parámetro mode que representa el formato y su valor (xml o html).

Configuración de Unidades

El último parámetro que debemos configurar es el parámetro Units. En nuestro país, el sistema de unidades aceptado es el sistema métrico, donde se utiliza Celsius para la temperatura. Sin embargo, los valores presentados por defecto en la respuesta están en grados Kelvin. Si ajustamos nuestra consulta para Celsius, el resultado final sería así:

https://api.openweathermap.org/data/2.5/weather?q=Ankara&appid=57d5b781f000e6bcc75786bf6e3ff283&lang=tr&units=metric

NOTA: La clave API en los ejemplos es solo ilustrativa. Debes utilizar tu propia clave API generada en tu cuenta de OpenWeatherMap.