Bietet grundlegende API für magische Seetang.
Hinweis: Ab dem 7.07.2022 wurde berichtet, dass Magicseaweed keine neuen API -Schlüssel vertreibt. Dieses Paket funktioniert immer noch für diejenigen, die einen API -Schlüssel haben. MagicseeAwed hat nicht angegeben, wann oder ob sie wieder mit der Verteilung von API -Schlüssel anfangen. Verweisen Sie unten auf den Abschnitt "einen API -Schlüssel erhalten", wenn Sie sie kontaktieren möchten, um weitere Informationen zu erhalten.
pip install magicseaweed
Um dieses Paket zu verwenden, ist keine Vertrautheit mit der Magic Seewed -API erforderlich. Als Referenz finden Sie hier ihre API -Dokumentation: Magic Seegen -Dokumente. Dieses Paket bietet einige Standard -API -Interaktionen basierend auf der Zeit.
Um den Wrapper zu verwenden:
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' )) Die Klasse MSW_forecast() verfügt über einige optionale Parameter. Ihre API -Schlüssel und eine Spot -ID sind die einzigen erforderlichen Parameter.
Verwenden Sie die forecast.DataBlockType() current() , future() , all() , manual() , Methoden zum Laden der Daten, nach denen Sie suchen.
current() gibt eine einzige Prognose zurück. Alle anderen Methoden geben einen Prognosenblock zurück.
future()all()manual()Die .Data -Attribute für jedes Datablock sind eine Liste von Prognoseobjekten.
ponce_future = ponce_forecast . get_future ()
for forecast in ponce_future . data :
print ( forecast . summary )Beispiel API -Antwort:
[ {
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"
}
} ] Diese Klasse dient zur Interaktion mit der MSW -API. Sie können seine Funktionen verwenden, um Punkte oder Datenreihen für verschiedene Zeiträume zu erhalten.
Parameter :
Methoden
start=dt.now().timestamp() und end=dt.now().timestamp() angerufen haben. Gibt einen Vorhersage zurück.datetime.now().timestamp()datetime.now().timestamp() Enthält Daten über eine Prognose im Laufe der Zeit und die HTTP -Reaktion von Magicseaweed.
Attribute
Enthält Daten zu einer Prognose zu einer bestimmten Zeit und der HTTP -Antwort von MagicseeAwed.
Datenpunkte haben viele Attribute, aber nicht alle sind immer verfügbar . Einige häufig verwendete sind:
Attribute
Methoden
Für eine vollständige Liste von Prognoseattributen und Attributbeschreibungen finden Sie einen Blick auf die Tabelle aus der MagicseAweed -Dokumentation. HINWEIS: Während die MSW -API Felder in dot.notation akzeptiert, verwenden Sie Snake_Case, um auf diese Attribute in einem prognostizierten Zugriff auf diese Attribute zuzugreifen.
Anfragen willkommen geheißen.
Nicht mit magicseeeaweed.com verbunden. Verwenden Sie auf eigenes Risiko.
Die Magic Seaeed API befindet sich derzeit in Beta. Um einen API -Schlüssel zu erhalten, befolgen Sie bitte die Anweisungen, die hier verfügbar sind