VIAMICHELIN REST API


météo

Description

Cette fonction permet de récupérer la météo du jour avec et les prévisions complètes à 10 jours, à l'échelle planétaire.

URL

http://apir.viamichelin.com/apir/1/weather.{output}?lg={lg}&center={center}&geobounds={geobounds}&zoomLevel={zoomLevel}&todayForecast={todayForecast}&fullForecast={fullForecast}&nbDays={nbDays}&authkey={authkey}&charset={charset}&ie={ie}&callback={callback}&signature={signature}

Format de sortie

xml, json

Comptabilisation

Un accès à la météo = une requête facturée (quel que soit le nombre de jours et de stations)

Versions du service

VersionDescription
1.0 Ajouté à l'API REST

 

Paramètres d'entrée

NomObligatoire?TypeDescriptionDéfaut
lg oui string Code langue (fra, deu, spa, ita, eng, ces, dan, nld, fin, int, nor, pol, por, swe) N/A
center oui sauf si geobounds défini float:float Centre de la recherche specifié sous la forme longitude;latitude exprimé en degrés decimaux. La météo renvoyée est celle de la station la plus proche. N/A
geobounds oui sauf si center défini float:float:float:floa Emprise géographique sous la forme minLon:minLat:maxLon:maxLat. La météo renvoyée est celle des stations incluses pour le zoomLevel donné. N/A
zoomLevel oui sauf si center défini positive integer Niveau de zoom à considérer pour l'emprise. Plus le zoom est élevé, plus il y a de stations renvoyées en préservant au mieux la répartition spatiale. N/A
todayForecast non bool Spécifie si l'on souhaite les prévisions de la journée en cours par tranches de 3h. false
fullForecast non bool Spécifie si l'on souhaite les prévisions exhaustives. false
nbDays non positive integer Nombre de jours de prévisions voulu. 5
authkey oui string Clef d'authentification. Cela peut-être une clef JS, un token généré par la fonction token ou l'identifiant du client en cas de signature de la requête (voir le paramètre signature) N/A
signature non string Signature de la requête avec l'algorithme HMAC-SHA1 où la clef secrète est le mot de passe du client. Si la requête est signée, authKey doit contenir l'identifiant du client, et expires doit-être valorisé. La signature s'applique sur des URL ayant leurs chaînes de caractères encodées. vide
expires non sauf si signature défini date Date GMT d'expiration de la requête au format yyyy-MM-dd'T'HH:mm:ss.SSS`'Z. vide
callback non string Nom de la fonction de callback à lancer (n'a de sens que si le format vaut json) vide
charset non string Encodage des caractères dans la réponse 'ISO-8859-1'
ie non string Encodage des caractères dans la requête 'ISO-8859-1'

 

Restrictions

  • Consulter la liste des prévisions possibles.
  • Le nombre de jours de prévision est plafonné à 10.
  • Le nombre de stations retournées est plafonné à 20.
  • Les observations météorologiques passées ne sont pas disponibles.

 

Exemples de requêtes

 

Structure de la réponse

  • La structure est de type weatherStationList open in new tab. Toute donnée peut être absente ou prendre la valeur -99 si elle est indisponible.
  •  

Veuillez noter que les champs retournés qui ne seraient pas expliqués dans ce document correspondent à des champs à usage interne de ViaMichelin. Ils peuvent évoluer à tout moment et ne devraient pas être utilisés. Leur présence traduit le fait que ViaMichelin utilise en interne les mêmes services et la même infrastructure que ceux mis à disposition de ces clients.

Retour haut de page