python magicseaweed
1.0.6
يوفر واجهة برمجة التطبيقات الأساسية للأعشاب البحرية السحرية.
ملاحظة: اعتبارًا من 7/8/2022 ، أفيد أن Magicseaweed لا يوزع مفاتيح API جديدة. هذه الحزمة لا تزال تعمل لأولئك الذين لديهم مفتاح API. لم يذكر Magicseaweed متى أو إذا كانوا سيبدأون في توزيع مفاتيح API مرة أخرى. الرجوع إلى قسم "الحصول على مفتاح API" أدناه إذا كنت ترغب في الاتصال بهم للحصول على مزيد من المعلومات.
pip install magicseaweed
لا يلزم إلقاء نظرة على واجهة برمجة تطبيقات الأعشاب البحرية السحرية لاستخدام هذه الحزمة. كمرجع ، يمكنك العثور على وثائق API الخاصة بهم هنا: Magic Seaweed Docs. توفر هذه الحزمة بعض تفاعلات API الافتراضية بناءً على الوقت.
لاستخدام الغلاف:
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' )) تحتوي فئة MSW_forecast() على عدد قليل من المعلمات الاختيارية. مفتاح API الخاص بك ، ومعرف البقعة هي المعلمات المطلوبة الوحيدة.
استخدم forecast.DataBlockType() على سبيل المثال. current() ، future() ، all() ، manual() ، طرق لتحميل البيانات التي تتبعها.
current() إرجاع توقع واحد. جميع الطرق الأخرى تُرجع كتلة من التنبؤات.
future()all()manual()سمات .Data لكل بيانات Datablock هي قائمة بالكائنات المتوقعة.
ponce_future = ponce_forecast . get_future ()
for forecast in ponce_future . data :
print ( forecast . summary )مثال استجابة 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"
}
} ] هذه الفئة هي للتفاعل مع واجهة برمجة تطبيقات MSW. يمكنك استخدام وظائفها للحصول على نقاط أو سلسلة من البيانات لفترات زمنية مختلفة.
حدود :
طُرق
start=dt.now().timestamp() و end=dt.now().timestamp() . إرجاع نقطة التوقعات .datetime.now().timestamp()datetime.now().timestamp() يحتوي على بيانات حول التنبؤ بمرور الوقت واستجابة HTTP من Magicseaweed.
صفات
يحتوي على بيانات حول التنبؤ في وقت معين واستجابة HTTP من Magicseaweed.
تحتوي نقاط البيانات على العديد من السمات ، ولكن ليس كلها متوفرة دائمًا . بعض منها شائعة الاستخدام هي:
صفات
طُرق
للحصول على قائمة كاملة بسمات التوقعات وأوصاف السمات ، ألق نظرة على الجدول من وثائق Magicseaweed. ملاحظة: بينما تقبل واجهة برمجة تطبيقات MSW الحقول في dot.notation ، استخدم Snake_Case للوصول إلى هذه السمات في نقطة التنبؤ.
سحب طلبات الترحيب.
لا ينتم إلى magicseaweed.com. استخدم على مسؤوليتك الخاصة.
واجهة برمجة تطبيقات الأعشاب البحرية السحرية حاليا في بيتا. للحصول على مفتاح API ، يرجى اتباع الإرشادات المتاحة هنا التسجيل
