python magicseaweed
1.0.6
Fournit une API de base aux algues magiques.
Remarque: au 7/8/2022, il a été signalé que MagicSaveed ne distribue pas de nouvelles clés d'API. Ce package fonctionne toujours pour ceux qui ont une clé API. MAGICSAWEAED n'a pas déclaré quand ou s'ils recommencent à distribuer des clés API. Référencer la section "Obtenir une clé API" ci-dessous si vous souhaitez les contacter pour plus d'informations.
pip install magicseaweed
Aucune familiarité avec l'API magique d'algues n'est nécessaire pour utiliser ce package. Pour référence, vous pouvez trouver leur documentation API ici: Magic Seaheed Docs. Ce package fournit des interactions API par défaut en fonction du temps.
Pour utiliser l'emballage:
import magicseaweed
api_key = os . environ . get ( 'MSW_API_KEY' )
ponce_id = 348
bethune_id = 371
ponce_forecast = MSW_Forecast ( api_key , ponce_id )
ponce_now = ponce_forecast . get_current ()
print ( ponce_now . attrs )
bethune_forecast = MSW_Forecast ( api_key , bethune_id )
bethune_future = bethune_forecast . get_future ()
print ( bethune_future . summary )
for forecast in bethune_future . data :
print ( forecast . attrs )
print ( forecast . get_chart_url ( 'swell' )) La classe MSW_forecast() a quelques paramètres facultatifs. Votre clé API et un ID de spot sont les seuls paramètres requis.
Utilisez la forecast.DataBlockType() . current() , future() , all() , manual() , Méthodes pour charger les données que vous recherchez.
current() renvoie une seule prévision. Toutes les autres méthodes renvoient un bloc de prévisions.
future()all()manual()Les attributs .data pour chaque datablock sont une liste d'objets de prévision.
ponce_future = ponce_forecast . get_future ()
for forecast in ponce_future . data :
print ( forecast . summary )Exemple de réponse de l'API:
[ {
timestamp : 1366902000 ,
localTimestamp : 1366902000 ,
issueTimestamp : 1366848000 ,
fadedRating : 0 ,
solidRating : 0 ,
swell : {
minBreakingHeight : 1 ,
absMinBreakingHeight : 1.06 ,
maxBreakingHeight : 2 ,
absMaxBreakingHeight : 1.66 ,
unit : "ft" ,
components : {
combined : {
height : 1.1 ,
period : 14 ,
direction : 93.25 ,
compassDirection : "W"
} ,
primary : {
height : 1 ,
period : 7 ,
direction : 83.37 ,
compassDirection : "W"
} ,
secondary : {
height : 0.4 ,
period : 9 ,
direction : 92.32 ,
compassDirection : "W"
} ,
tertiary : {
height : 0.3 ,
period : 13 ,
direction : 94.47 ,
compassDirection : "W"
}
}
} ,
wind : {
speed : 10 ,
direction : 85 ,
compassDirection : "W" ,
chill : 15 ,
gusts : 13 ,
unit : "mph"
} ,
condition : {
pressure : 1020 ,
temperature : 18 ,
unitPressure : "mb" ,
unit : "c"
} ,
charts : {
swell : "http://cdn.magicseaweed.com/wave/750/1-1366902000-1.gif" ,
period : "http://cdn.magicseaweed.com/wave/750/1-1366902000-2.gif" ,
wind : "http://cdn.magicseaweed.com/gfs/750/1-1366902000-4.gif" ,
pressure : "http://cdn.magicseaweed.com/gfs/750/1-1366902000-3.gif" ,
sst : "http://cdn.magicseaweed.com/sst/750/1-1366902000-10.gif"
}
} ] Cette classe est pour interagir avec l'API MSW. Vous pouvez utiliser ses fonctions pour obtenir des points ou une série de données pour différentes périodes.
Paramètres :
Méthodes
start=dt.now().timestamp() et end=dt.now().timestamp() . Renvoie une prévisiondatapOrt .datetime.now().timestamp()datetime.now().timestamp() Contient des données sur une prévision au fil du temps et la réponse HTTP de MagicSaveed.
Attributs
Contient des données sur une prévision à un moment donné et la réponse HTTP de MagicSaveed.
Les points de données ont de nombreux attributs, mais tous ne sont pas toujours disponibles . Certains sont couramment utilisés:
Attributs
Méthodes
Pour une liste complète des attributs de prévisiondatapoint et des descriptions d'attribut, jetez un œil à la table de la documentation MAGICSAWEED. Remarque: Bien que l'API MSW accepte les champs dans dot.notation, utilisez Snake_Case pour accéder à ces attributs dans un prévisiondataPoint.
Tirez les demandes de bienvenue.
Non affilié à MagicSeaweed.com. Utiliser à vos risques et périls.
L'API Magic Seaheed est actuellement en version bêta. Pour obtenir une clé API, veuillez suivre les instructions disponibles ici
