Get Started
Generate an access token
To access the data in PONTOS-HUB you will need an access token. To generate one, fill out the form below and click the "Submit" button. This token allows us to have an idea of who is using the data and for what purpose without storing personal identifying information. The access token is valid for 1 month.📢 PONTOS-HUB is made available under the Open Database License (ODbL) v1.0. Any rights in individual contents of the database are licensed under the Database Contents License (DbCL) v1.0.
These licenses are quite permissive. For example, you can use the contents of PONTOS-HUB in commercial applications. To fully understand the rights granted and conditions of use, refer to the original license texts. A summary of the ODbL license can be found here.
Get (near) real-time data using the MQTT API and MQTT Explorer
You can easily use MQTT Explorer to get (near) real-time ship operation data through the MQTT API. The text and images below describe how to configure the connection in MQTT Explorer. To learn more about the MQTT API check out the docs.
- Name:
Pontos(or similar name) - Encryption (tls):
On - Protocol:
ws:// - Host:
pontos.ri.se - Port:
443 - Basepath:
mqtt - Username:
__token__ - Password:
<YOUR_ACCESS_TOKEN> - Topic: ADD
PONTOS_EGRESS/#REMOVE#and$SYS/#(In 'Advanced' configuration)
Basic connection configuration.
Advanced connection configuration.Get historical data using the REST API and Curl
You can easily use curl in your terminal or command window to get historical ship operational data through the REST API. Below is a simple script that requests a list of all the vessels available in PONTOS-HUB. To learn more about the REST-API check out the docs.
curl -X GET \ -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \ https://pontos.ri.se/api/vessel_ids
