Skip to main content

Esempio: utilizzo del OpenWeather Client SL Biblioteca

Prodotto: Librerie CODESYS IIOT SL

Le OpenWeather Client SL Example.project un progetto di esempio mostra come usare OpenWeather Client SL libreria per interrogare i dati meteorologici tramite l'API OpenWeather.

Preparazione

Per interrogare i dati dall'esterno OpenWeather API, devi inserire una chiave API valida. Il servizio «One Call API 3.0" deve essere attivato per questa chiave. Se è già stata generata una chiave, non è necessario eseguire ulteriori passaggi preparatori

Se non disponi ancora di una chiave e desideri crearne una nuova o se non sei sicuro che il servizio richiesto sia stato attivato per la tua chiave, procedi come segue:

  1. Crea un account.

    Crea un account su Sito web OpenWeather oppure accedi se sei già registrato.

  2. Genera una chiave.

    Una volta effettuato l'accesso, vai al API keys menu. Qui puoi visualizzare tutte le chiavi API attive e creare nuove chiavi usando il Generate pulsante.

  3. Attiva il servizio «One Call API 3.0".

    Questo servizio è necessario per il corretto funzionamento della libreria. Accedere al Billing Plans voce di menu e cerca il servizio «One Call API 3.0".

    Se non sei ancora abbonato a questo servizio, puoi farlo facendo clic sul Subscribe pulsante. Ora il Status il campo dovrebbe essere Activated.

    Dopo questo passaggio, dovresti essere in grado di vedere quanto segue:

    _example_img_iiot_openwheather.png

  4. Facoltativo: imposta un limite di chiamate.

    Se desideri utilizzare solo la quota giornaliera gratuita, puoi impostare un limite per assicurarti che non possano essere effettuate più di 1000 chiamate.

    Per fare ciò, accedi al Billing Plans voce di menu in modo da poter vedere la visualizzazione mostrata sopra. Calls per day colonna, puoi definire il numero massimo di chiamate che desideri consentire al giorno.

    Fatto

    Tieni pronta la tua chiave API per eseguire le applicazioni di esempio.

Descrizione

Nota generale sulle informazioni sulla posizione negli esempi

  • Negli esempi, i dati sulla posizione (GeoLocation) è definito staticamente nell'area di dichiarazione del rispettivo programma principale dell'applicazione (qui: CFC_PRG).

  • È possibile modificare i valori di questo oggetto per interrogare i dati meteorologici di altre località.

    Avviso

    Solo le coordinate GPS nel formato «Decimal Degree» (DD), definite da longitudine e latitudine, influiscono effettivamente sulla posizione per la quale vengono richiesti i dati. Altre informazioni, come il nome della città, non hanno

  • È possibile ottenere le coordinate di una posizione tramite un servizio di mappe e inserire manualmente le informazioni rimanenti, se necessario. In alternativa, puoi anche usare GeoLocator blocchi funzionali (vedi GeoLocatorExamplesapplicazione) per compilare correttamente il GeoLocation struttura.

Applicazione: CurrentWeatherExample

In questa applicazione, i dati meteorologici attuali per una località specificata vengono richiesti dall'API OpenWeather. sApiKey campo, inserisci la tua chiave API e imposta il xLoadWeatherData contrassegnare a TRUE per recuperare i dati. I dati vengono caricati nel currentWeatherData struttura. È possibile visualizzare il contenuto della struttura nell'area di monitoraggio.

Applicazione: WeatherForecastExample

In questa applicazione, viene richiesta una previsione meteo oraria per le prossime 48 ore per una località specificata al OpenWeather API. sApiKey campo, inserisci la tua chiave API e imposta xLoadWeatherData contrassegnare a TRUE per recuperare i dati. I dati vengono caricati nel weatherForecast struttura. È possibile visualizzare il contenuto della struttura nell'area di monitoraggio.

Applicazione: CurrentWeatherAndForecastExample

In questa applicazione, il tempo corrente e le previsioni meteo orarie per le prossime 48 ore per una località specificata sono richieste al OpenWeather API. sApiKey campo, inserisci la tua chiave API e imposta xLoadWeatherData contrassegnare a TRUE per recuperare i dati. I dati vengono caricati nel currentWeatherData e weatherForecast strutture. È possibile visualizzare il contenuto delle strutture nell'area di monitoraggio.

Importante

Le CurrentWeatherAndForecastExample il blocco funzione potrebbe dare l'impressione che esegua semplicemente il CurrentWeather e ForecastWeather blocchi di funzione uno dopo l'altro. Questo non è il caso. CurrentWeatherAndForecastExample blocco funzione può interrogare i dati meteorologici correnti e i dati meteorologici previsionali in una sola chiamata API. Dovrebbe quindi essere sempre utilizzato quando sono richiesti entrambi i tipi di dati.

Applicazione: GeoLocatorExamples

In questa applicazione, viene richiesta una descrizione della posizione, ma soprattutto le coordinate di una posizione, al OpenWeather Geocoding API.

Nel sApiKey campo, inserisci la tua chiave API e imposta il xLoad[...] contrassegna a TRUE per recuperare i dati. I dati vengono caricati nel location struttura. È possibile visualizzare il contenuto della struttura nell'area di monitoraggio.

Applicazione: VisuExample

L'applicazione mostra la richiesta del tempo attuale e le previsioni del tempo per le prossime 48 ore in connessione con un'interfaccia di visualizzazione.

Una visualizzazione è un buon modo per avere una rapida panoramica delle informazioni disponibili.

Interfaccia utente

Quando si avvia l'applicazione, si apre la seguente finestra di visualizzazione:

_example_img_iiot_openwheather_visu.png
. L'interfaccia è composta da quattro parti principali:

  1. Barra di controllo

    È possibile utilizzare la barra di controllo sul lato sinistro per controllare l'applicazione.

    Fai clic su _example_icon_iiot_openwheather_update_data.png pulsante per recuperare e visualizzare dati reali dal server API. Nota che devi impostare una chiave API per questo. Se fare clic su questo pulsante non ha effetto, controlla la chiave API che hai inserito.

    Fai clic su _example_icon_iiot_openwheather_load_dummy.png pulsante per caricare dati fittizi che non richiedono una chiamata API. Questi dati vengono quindi caricati da un file JSON che contiene una risposta API precedente

    Fai clic su _example_icon_iiot_openwheather_api_key.png pulsante per mostrare e nascondere la finestra in cui inserisci la tua chiave API.

  2. Sovrapposizione di chiavi API

    Facendo clic su _example_icon_iiot_openwheather_api_key.png si aprirà la finestra per inserire la chiave API. Fai clic nel campo di testo per inserire o modificare la chiave.

  3. Visualizzazione del meteo attuale

    Il pannello in alto al centro mostra i dati meteorologici attuali. Vengono visualizzate tutte le informazioni disponibili. Puoi usare un tooltip (passaci sopra con il puntatore del mouse) per visualizzare la descrizione dei valori che non hanno un'etichetta sull'interfaccia

  4. Visualizzazione delle previsioni del tempo

    Il pannello in basso al centro mostra le previsioni del tempo. Le informazioni mostrate qui sono state ridotte per ottenere una visualizzazione chiara. Teoricamente, per ogni voce sono disponibili quasi tutte le informazioni, disponibili anche per le condizioni meteorologiche attuali (eccetto gli orari di alba/tramonto

    Poiché la previsione per le prossime 48 ore contiene un punto dati ogni ora, ci sono 48 pannelli tra cui passare.

    Usa il _example_icon_iiot_openwheather_arrow_left.png e _example_icon_iiot_openwheather_arrow_right.png pulsanti per spostare la visualizzazione delle 48 voci una voce a sinistra o a destra. Usa il _example_icon_iiot_openwheather_arrow2_left.png e _example_icon_iiot_openwheather_arrow2_right.png pulsanti per passare rapidamente all'inizio o alla fine.

Requisiti e restrizioni di sistema

Sistema di programmazione

CODESYS Development System (versione 3.5.18.0 o superiore)

Sistema di runtime

CODESYS Control Win (versione 3.5.18.0)

Componenti aggiuntivi

-

Avviso

_example_icon.png SCARICA progetti

In questa sezione: