Access Signal Ocean Platform data using Python.
Project description
The Signal Ocean SDK combines the power of Python and Signal Ocean's APIs to give you access to a variety of shipping data available in The Signal Ocean Platform.
Installation
Install the SDK with pip:
pip install signal-ocean
The Signal Ocean SDK depends on the pandas library for some of its data analysis features. Optional pandas dependencies are also optional in this SDK. If you plan to use data frame features like plotting or exporting to Excel, you need to install additional dependencies, for example:
pip install matplotlib openpyxl
For more information refer to pandas documentation.
Getting Started
To use the SDK, you need to create an account in our API Portal and subscribe to an API. Once you have a subscription key, put it inside an environment variable called SIGNAL_OCEAN_API_KEY.
Now you're ready to fetch some data:
from signal_ocean import PortAPI
port_api = PortAPI()
ports = port_api.get_ports()
print(ports)
If you don't want to use environment variables, want to use different keys for different APIs, or if you want to override the environment variables, you can configure your Connection when creating the API class:
from signal_ocean import VesselClassAPI, Connection
vessel_class_api = VesselClassAPI(Connection(api_key='YOUR KEY GOES HERE'))
vessel_classes = vessel_class_api.get_vessel_classes()
print(vessel_classes)
All API classes follow this pattern of configuration.
Check the docs for examples covering usage of our other APIs.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for signal_ocean-1.0.8-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 16e29a16874f37983b13e3f65997b2e03236181e5629dbeae432a33884524f84 |
|
| MD5 | 7d125ffac4f7c6ccff3b08ad5c432bc0 |
|
| BLAKE2b-256 | 5c01d71041ad01059f56ec753fc45903344043ebc2d3f9253f5f962670d10faa |
