Documentation du code de SPIP et de ses plugins

Rainette

meteo_charger.php

Ce fichier contient la fonction standard de chargement et fourniture des données météo.

Elle s'applique à tous les services et à tous les types de données.

Table of Contents

Functions

inc_meteo_charger_dist()  : array<string|int, mixed>
Renvoyer le contenu du fichier cache des données météos correspondant au lieu et au type de données choisis après l'avoir éventuellement mis à jour.

Functions

inc_meteo_charger_dist()

Renvoyer le contenu du fichier cache des données météos correspondant au lieu et au type de données choisis après l'avoir éventuellement mis à jour.

inc_meteo_charger_dist(string $lieu[, null|string $mode = 'conditions' ][, null|string $service = '' ][, null|array<string|int, mixed> $options = [] ]) : array<string|int, mixed>

Si le fichier cache est obsolète ou absent, on le crée après avoir chargé puis phrasé le flux XML ou JSON et stocké les données collectées et transcodées dans un tableau standardisé. L'appelant doit s'assurer que la périodicité est compatible avec le service; cette fonction ne retourne donc que des erreurs de chargement.

Parameters
$lieu : string

Le lieu concerné par la méteo exprimé selon les critères requis par le service mais non normalisé.

$mode : null|string = 'conditions'

Le type de données météorologiques demandé :

  • conditions, la valeur par défaut
  • previsions
  • infos
$service : null|string = ''

Le nom abrégé du service :

  • owm pour OpenWeather, la valeur par défaut
  • weatherbit pour Weatherbit.io
  • weatheapi pour WeatherAPI
  • accuweather pour AccuWeather
  • aeris pour AerisWeather
  • openmeteo pour OpenMeteo
  • wwo pour World Weather Online
  • meteoconcept pour Meteo-Concept
$options : null|array<string|int, mixed> = []

Options pour l'acquisition des données météo : La périodicité horaire des prévisions (periodicite) :

  • 24, les prévisions de la journée (défaut pour le mode prévisions)
  • 12, les prévisions du jour et de la nuit
  • 6, les prévisions de la journée par période de 6h
  • 3, les prévisions de la journée par période de 3h
  • 1, les prévisions de la journée pour chaque heure
  • 0, pour les modes conditions et infos La langue du résumé méteo (langue) : par défaut la langue spip de la page L'indicateur du mode de lancement du chargement (via_job) : Prend les valeurs 'on' pour indiquer que l'appel vient d'un job et '' sinon (défaut). Cette information ne sert qu'au pipeline post_chargement_meteo
Tags
uses
rainette_service_defaut()
uses
rainette_service_est_indisponible()
uses
erreur_normaliser_extras()
uses
configuration_service_lire()
uses
parametrage_service_normaliser()
uses
cache_normaliser()
uses
cache_est_valide()
uses
requete_autorisee()
uses
meteo_normaliser()
uses
indice2risque_uv()
uses
code_meteo2icone()
uses
cache_ecrire()
uses
cache_lire()
throws
Exception
Return values
array<string|int, mixed>

Le contenu du fichier cache avec les données demandées à jour.


        
On this page

Search results