python magicseaweed
1.0.6
Proporciona API básica a algas mágicas.
Nota: A partir del 7/8/2022, se informó que MagicSeaweed no está distribuyendo nuevas claves API. Este paquete todavía funciona para aquellos que tienen una clave API. MagicSeaweed no ha declarado cuándo o si comenzarán a distribuir las claves API nuevamente. Haga referencia a la sección "Obtenga una clave API" a continuación si desea comunicarse con ellos para obtener más información.
pip install magicseaweed
No se requiere familiaridad con la API Magic Seaweed para usar este paquete. Como referencia, puede encontrar su documentación de API aquí: Documentos mágicos de algas. Este paquete proporciona algunas interacciones API predeterminadas basadas en el tiempo.
Para usar el envoltorio:
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 clase MSW_forecast() tiene algunos parámetros opcionales. Su clave API y una ID de Spot son los únicos parámetros requeridos.
Use el forecast.DataBlockType() Eg. current() , future() , all() , manual() , Métodos para cargar los datos que busca.
current() devuelve un único pronóstico. Todos los demás métodos devuelven un bloque de pronósticos.
future()all()manual()Los atributos .data para cada dataBlock son una lista de objetos de pronóstico.
ponce_future = ponce_forecast . get_future ()
for forecast in ponce_future . data :
print ( forecast . summary )Ejemplo de respuesta de 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"
}
} ] Esta clase es para interactuar con la API de MSW. Puede usar sus funciones para obtener puntos o series de datos por diferentes períodos de tiempo.
Parámetros :
Métodos
start=dt.now().timestamp() y end=dt.now().timestamp() . Devuelve un ForecastDatapoint .datetime.now().timestamp()datetime.now().timestamp() Contiene datos sobre un pronóstico con el tiempo y la respuesta HTTP de MagicSeaweed.
Atributos
Contiene datos sobre un pronóstico en un momento particular y la respuesta HTTP de MagicSeaweed.
Los puntos de datos tienen muchos atributos, pero no todos están siempre disponibles . Algunos usados comúnmente son:
Atributos
Métodos
Para obtener una lista completa de atributos y descripciones de atributos PrevedDatapoint, eche un vistazo a la tabla de la documentación de MagicSeaweed. NOTA: Mientras la API de MSW acepta campos en Dot. Notación, use Snake_Case para acceder a estos atributos en un ForecastDatapoint.
Solicitudes de bienvenida.
No afiliado a MagicSeaweed.com. Use bajo su propio riesgo.
La API Magic Seaweed se encuentra actualmente en Beta. Para obtener una clave API, siga las instrucciones disponibles aquí Regístrese
