odweather
ballerinax/odweather Ballerina library
Overview
The ODWeather API v1.0 connector(https://api.oceandrivers.com/) OpenAPI specification. The ODWeather API provides the capability to access the real time and forecast ocean information.
Key Features
- Programmatic access to create and manage resources via REST API
- Seamless integration with REST API endpoints
- Support for standard HTTP methods and JSON responses
Quickstart
To use the ODWeather connector in your Ballerina application, update the .bal file as follows:
Step 1: Import connector
Import the ballerinax/odweather module into the Ballerina project.
import ballerinax/odweather;
Step 2: Create a new connector instance
odweather:Client weatherClient = check new();
Step 3: Invoke connector operation
-
Now you can use the operations available within the connector. Note that they are in the form of remote operations.
Following is an example on how to get web cams information using the connector.public function main() returns error? { http:Response entity = check weatherClient->getWebCams()(); } -
Use
bal runcommand to compile and run the Ballerina program.
Clients
odweather: Client
This is a generated connector for ODWeather API v1.0 OpenAPI specification. The ODWeather API provides the capability to access the real time and forecast ocean information.
Constructor
Gets invoked to initialize the connector.
The connector initialization does not require setting the API credentials.
init (ConnectionConfig config, string serviceUrl)- config ConnectionConfig {} - The configurations to be used when initializing the
connector
- serviceUrl string "https://api.oceandrivers.com/" - URL of the target service
compareStation
Get forecast and realtime information for known points
Parameters
- stationName string - Weather station to compare, values: cnareanl|rcnp | cmsap|boyaenderrocat|areopuertopalma | EWXXX
getAemetStation
Get data from the aemet stations
Parameters
- stationName string - station name currently: aeropuertopalma | caboblanco
- period string - Period of time to get the data. Options: lastdata lastday
getEasywind
Get data from the easywind weather stations
Parameters
- easywindId string - currently: 'EW013'|'EW008'
- period string - Period of time to get the data latestdata|latesthour|latestday
getEventStations
Get stations in an event
Parameters
- eventId string - currently: 'trofeoprincesasofia|palmavela'
getForecastPoints
Get forecast points of a yatchclub
getForecastTimeSeries
function getForecastTimeSeries(decimal latitude, decimal longitude, string weather, string? inittime, string? endtime, int? days, int? hours, string? wave, string? entryid) returns Response|errorGet timeseries forecast information
Parameters
- latitude decimal - latitude for the forecast
- longitude decimal - longitude for the forecast
- weather string - Comma separated values for the weather parameteres temperature,rain,wind_u,wind_v,gust,pressure,cloud,humidity&wave=height,direction,period
- inittime string? (default ()) - initial date for the forecast ISO string YYYY-MM-DDTHH:mm:SS.SZ
- endtime string? (default ()) - end date for the forecast ISO string YYYY-MM-DDTHH:mm:SS.SZ
- days int? (default ()) - optional number of days in string. Will be added to init forecast date
- hours int? (default ()) - optional number of hours in string. Will be added to init forecast date
- wave string? (default ()) - Comma separated values for the wave parameteres height,direction,period
- entryid string? (default ()) - Direct file I want to extract
getForecastTimeSeriesWrf
function getForecastTimeSeriesWrf(decimal latitude, decimal longitude, string weather, string? inittime, string? endtime, int? days, int? hours, string? wave, string? entryid) returns Response|errorGet timeseries forecast information
Parameters
- latitude decimal - latitude for the forecast
- longitude decimal - longitude for the forecast
- weather string - Comma separated values for the weather parameteres temperature,rain,wind_u,wind_v,gust,pressure,cloud,humidity&wave=height,direction,period
- inittime string? (default ()) - initial date for the forecast ISO string YYYY-MM-DDTHH:mm:SS.SZ
- endtime string? (default ()) - end date for the forecast ISO string YYYY-MM-DDTHH:mm:SS.SZ
- days int? (default ()) - optional number of days in string. Will be added to init forecast date
- hours int? (default ()) - optional number of hours in string. Will be added to init forecast date
- wave string? (default ()) - Comma separated values for the wave parameteres height,direction,period
- entryid string? (default ()) - Direct file I want to extract
getSocibWeatherStation
Get data from the socib bahia de palma buoy
Parameters
- stationName string - station name currently: boyaenderrocat | playadepalma
- period string - Period of time to get the data. Options: lastdata lasthour lastday
getWeatherDisplay
Get data from the weather display software
Parameters
- stationName string - currently: 'cnarenal'|'campastilla' | 'cncg'
- period string - Period of time to get the data latestdata|latesthour|latestday|dailylog
getWebCams
Get forecast and realtime information for known points
Records
odweather: ClientHttp1Settings
Provides settings related to HTTP/1.x protocol.
Fields
- keepAlive KeepAlive(default http:KEEPALIVE_AUTO) - Specifies whether to reuse a connection for multiple requests
- chunking Chunking(default http:CHUNKING_AUTO) - The chunking behaviour of the request
- proxy? ProxyConfig - Proxy server related options
odweather: ConnectionConfig
Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.
Fields
- httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client
- http1Settings? ClientHttp1Settings - Configurations related to HTTP/1.x protocol
- http2Settings? ClientHttp2Settings - Configurations related to HTTP/2 protocol
- timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection
- forwarded string(default "disable") - The choice of setting
forwarded/x-forwardedheader
- poolConfig? PoolConfiguration - Configurations associated with request pooling
- cache? CacheConfig - HTTP caching related configurations
- compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (
accept-encoding) header
- circuitBreaker? CircuitBreakerConfig - Configurations associated with the behaviour of the Circuit Breaker
- retryConfig? RetryConfig - Configurations associated with retrying
- responseLimits? ResponseLimitConfigs - Configurations associated with inbound response size limits
- secureSocket? ClientSecureSocket - SSL/TLS-related options
- proxy? ProxyConfig - Proxy server related options
- validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
odweather: ProxyConfig
Proxy server configurations to be used with the HTTP client endpoint.
Fields
- host string(default "") - Host name of the proxy server
- port int(default 0) - Proxy server port
- userName string(default "") - Proxy server username
- password string(default "") - Proxy server password
Import
import ballerinax/odweather;Metadata
Released date: 2 days ago
Version: 1.5.2
License: Apache-2.0
Compatibility
Platform: any
Ballerina version: 2201.8.0
GraalVM compatible: Yes
Pull count
Total: 27
Current verison: 0
Weekly downloads
Keywords
Type/Connector
Vendor/ODWeather
Area/Productivity & Collaboration
Lifestyle & Entertainment/News & Lifestyle
Cost/Free
Contributors
Dependencies