Skip to main content

Ejemplo: uso del OpenWeather Client SL Biblioteca

Producto: Bibliotecas CODESYS IIOT S.L.

El OpenWeather Client SL Example.project Un ejemplo de proyecto muestra cómo usar el OpenWeather Client SL biblioteca para consultar datos meteorológicos a través de la API OpenWeather.

Preparación

Para consultar datos desde el exterior OpenWeather API, debes introducir una clave de API válida. El servicio «One Call API 3.0» debe estar activado para esta clave. Si ya ha generado una clave, no necesita realizar ningún otro paso preparatorio

Si aún no tiene una clave y desea crear una nueva o si no está seguro de si se ha activado el servicio requerido para su clave, proceda de la siguiente manera:

  1. Crea una cuenta.

    Crea una cuenta en el Sitio web de OpenWeather o inicia sesión si ya te has registrado.

  2. Genera una clave.

    Cuando haya iniciado sesión, navegue hasta la API keys menú. Allí puede ver todas las claves de API activas y crear nuevas claves mediante el Generate botón.

  3. Activa el servicio «One Call API 3.0".

    Este servicio es necesario para que la biblioteca funcione correctamente. Navegue hasta el Billing Plans elemento del menú y busque el servicio «One Call API 3.0».

    Si aún no se ha suscrito a este servicio, puede hacerlo haciendo clic en Subscribe botón. Ahora el Status el campo debe ser Activated.

    Tras este paso, deberías poder ver lo siguiente:

    _example_img_iiot_openwheather.png

  4. Opcional: configura un límite de llamadas.

    Si solo quieres usar la cuota diaria gratuita, puedes establecer un límite para asegurarte de que no se puedan realizar más de 1000 llamadas.

    Para ello, navegue hasta la Billing Plans elemento del menú para que pueda ver la vista que se muestra arriba. En el Calls per day columna, puedes definir el número máximo de llamadas que deseas permitir por día.

    Hecho

    Tenga lista su clave de API para ejecutar las aplicaciones de ejemplo.

Descripción

Nota general sobre la información de ubicación en los ejemplos

  • En los ejemplos, los datos de ubicación (GeoLocation) se define estáticamente en el área de declaración del programa principal respectivo de la aplicación (aquí: CFC_PRG).

  • Puede cambiar los valores de este objeto para consultar datos meteorológicos de otras ubicaciones.

    Aviso

    Solo la coordenada GPS en el formato «Grado decimal» (DD), que se define mediante una longitud y una latitud, influye realmente en la ubicación para la que se solicitan los datos. Otra información, como el nombre de la ciudad, no tiene ningún efecto.

  • Puede obtener las coordenadas de una ubicación a través de un servicio de mapas e introducir la información restante manualmente si es necesario. Como alternativa, también puedes usar el GeoLocator bloques de funciones (consulte GeoLocatorExamplessolicitud) para rellenar correctamente el GeoLocation estructura.

Solicitud: CurrentWeatherExample

En esta aplicación, los datos meteorológicos actuales de una ubicación específica se solicitan a la API de OpenWeather. En el sApiKey campo, introduce tu clave de API y configura el xLoadWeatherData marcar para TRUE para obtener datos. Los datos se cargan en el currentWeatherData estructura. Puede ver el contenido de la estructura en el área de monitoreo.

Solicitud: WeatherForecastExample

En esta aplicación, se solicita un pronóstico meteorológico por hora para las próximas 48 horas para una ubicación específica al OpenWeather API. En el sApiKey campo, introduce tu clave de API y configura el xLoadWeatherData marcar para TRUE para obtener datos. Los datos se cargan en el weatherForecast estructura. Puede ver el contenido de la estructura en el área de monitoreo.

Solicitud: CurrentWeatherAndForecastExample

En esta aplicación, el clima actual y el pronóstico meteorológico por hora para las próximas 48 horas para una ubicación específica se solicitan al OpenWeather API. En el sApiKey campo, introduce tu clave de API y configura el xLoadWeatherData marcar para TRUE para obtener datos. Los datos se cargan en el currentWeatherData y weatherForecast estructuras. Puede ver el contenido de las estructuras en el área de monitoreo.

Importante

El CurrentWeatherAndForecastExample el bloque de función podría dar la impresión de que simplemente ejecuta el CurrentWeather y ForecastWeather la función bloquea uno tras otro. Ese no es el caso. CurrentWeatherAndForecastExample bloque de funciones puede consultar los datos meteorológicos actuales y los datos meteorológicos pronosticados en una sola llamada a la API. Por lo tanto, siempre debe usarse cuando se requieran ambos tipos de datos.

Solicitud: GeoLocatorExamples

En esta aplicación, se solicita una descripción de la ubicación, pero sobre todo las coordenadas de una ubicación, al OpenWeather Geocoding API.

En el sApiKey campo, introduce tu clave de API y configura el xLoad[...] banderas para TRUE para obtener datos. Los datos se cargan en el location estructura. Puede ver el contenido de la estructura en el área de monitoreo.

Solicitud: VisuExample

La aplicación muestra la consulta del tiempo actual y el pronóstico del tiempo para las próximas 48 horas en conexión con una interfaz de visualización.

Una visualización es una buena forma de obtener una visión general rápida de la información disponible.

Interfaz de usuario

Al iniciar la aplicación, se abre la siguiente ventana de visualización:

_example_img_iiot_openwheather_visu.png
. La interfaz consta de cuatro partes principales:

  1. Barra de control

    Puede usar la barra de control del lado izquierdo para controlar la aplicación.

    Haga clic en _example_icon_iiot_openwheather_update_data.png botón para obtener y mostrar datos reales del servidor API. Tenga en cuenta que debe configurar una clave de API para ello. Si hacer clic en este botón no tiene ningún efecto, compruebe la clave de API que ha introducido.

    Haga clic en _example_icon_iiot_openwheather_load_dummy.png botón para cargar datos ficticios que no requieren una llamada a la API. Luego, estos datos se cargan desde un archivo JSON que contiene una respuesta de API anterior

    Haga clic en _example_icon_iiot_openwheather_api_key.png botón para mostrar y ocultar la ventana en la que se introduce la clave de API.

  2. Superposición de claves de API

    Al hacer clic en _example_icon_iiot_openwheather_api_key.png botón abrirá la ventana para introducir la clave de API. Haga clic en el campo de texto para introducir o cambiar su clave.

  3. Visualización del clima actual

    El panel central superior muestra los datos meteorológicos actuales. Se muestra toda la información disponible. Puede utilizar una información emergente (pase el puntero del ratón por encima de ella) para mostrar la descripción de los valores que no tienen etiqueta en la interfaz

  4. Visualización de la previsión meteorológica

    El panel central inferior muestra el pronóstico del tiempo. La información que se muestra aquí se ha reducido para obtener una visualización más clara. En teoría, casi toda la información está disponible para cada entrada, y también está disponible para el clima actual (excepto las horas de salida y puesta del sol).

    Como la previsión para las próximas 48 horas contiene un punto de datos cada hora, hay 48 paneles entre los que cambiar.

    Usa el _example_icon_iiot_openwheather_arrow_left.png y _example_icon_iiot_openwheather_arrow_right.png botones para mover la vista de las 48 entradas una entrada hacia la izquierda o hacia la derecha. Utilice el _example_icon_iiot_openwheather_arrow2_left.png y _example_icon_iiot_openwheather_arrow2_right.png botones para ir rápidamente al principio o al final.

Requisitos y restricciones del sistema

Sistema de programación

CODESYS Development System (versión 3.5.18.0 o superior)

Sistema de ejecución

CODESYS Control Win (versión 3.5.18.0)

Componentes adicionales

-

Aviso

_example_icon.png DESCARGAR proyectos

En esta sección: