Le code source de ce package est disponible sur : https://github.com/myconstellation/constellation-packages/tree/master/ForecastIO

Installation

Prérequis : créer un compte développeur sur Dark Sky

Pour pouvoir utiliser le service Forecast.io vous devez créer un compte développeur Dark Sky sur : https://darksky.net/dev/

Vous disposez de 1.000 appels au service par jour gratuitement.

Une fois inscrit, copiez la clé API que vous devrez rentrer dans la configuration du package Constellation.

Installation du package Constellation

Depuis le “Online Package Repository” de votre Console Constellation, déployez le package ForecastIO :

Une fois le package télécharger votre repository local, sélectionnez la sentinelle sur laquelle déployer le package.

Pour finir, sur la page de Settings, vous devez obligatoirement définir la configuration au format XML :

Le XML de configuration du package a la structure suivante :

<forecastIOConfigurationSection xmlns="urn:ForecastIO" apiKey="xxxxxxxxxxxxxxxxx" refreshInterval="00:30:00" language="en">
  <stations>
    <station name="Paris" longitude="2.35" latitude="48.853" />
  </stations>
</forecastIOConfigurationSection>

Sur la balise racine, vous devez obligatoirement spécifier dans l’attribut “apiKey” votre clé d’API obtenue sur le portail développeur Dark Sky. Vous pouvez également modifier l’intervalle de rafraichissement des prévisions (par défaut 30 minutes), la langue des commentaires (par défaut en anglais) ainsi que les unités (en rajoutant l’attribut « unit »).

Dans la listes “<stations>” vous pouvez configurer autant de stations que vous souhaitez. Chaque station est définie par un nom et une position GPS (Latitude et Longitude).

Par exemple, pour maintenir à jour dans vos StateObjects Constellation, la météo (en Francais),  pour Paris, Lille et Londres toutes les 10 minutes:

<forecastIOConfigurationSection xmlns="urn:ForecastIO" apiKey="xxxxxxxxxxxxxxxxx" refreshInterval="00:10:00" language="fr">
  <stations>
    <station name="Paris" longitude="2.35" latitude="48.853" />
    <station name="Lille" longitude="3.05" latitude="50.629" />
    <station name="Londre" longitude="-0.14" latitude="51.557" />
  </stations>
</forecastIOConfigurationSection>

Bien entendu vos  pouvez également déployer ce package manuellement dans la configuration de votre Constellation :

<package name="ForecastIO">
  <settings>
    <setting key="forecastIOConfigurationSection">
        <content>
        <forecastIOConfigurationSection xmlns="urn:ForecastIO" apiKey="xxxxxxxxxxxxxxxxx" refreshInterval="00:30:00" language="fr">
          <stations>
            <station name="Paris" longitude="2.35" latitude="48.853" />
            <station name="Lille" longitude="3.05" latitude="50.629" />
            <station name="Londre" longitude="-0.14" latitude="51.557" />
          </stations>
        </forecastIOConfigurationSection>
        </content>
    </setting>
  </settings>
</package>

Détails du package

Les Settings

Les StateObjects

Vous retrouverez autant de StateObjects que de stations spécifiées dans la configuration du package. Ces StateObjects sont mis à jour pour l’intervalle défini dans la configuration (toutes les 30 minutes par défaut).

Les MessageCallbacks

Le package expose 2 MessageCallbacks :

Quelques exemples

• Afficher la météo dans un Dashboard HTML
• Envoyer une notification depuis un package C# en cas de pluie dans l’heure

The post ForecastIO : les prévisions météo dans Constellation appeared first on Constellation.