If you are receiving no data or empty responses from your API calls, consider these common causes and their explanations:
1. No Records in the MarineTraffic Database for the Defined timespan
The API may not return data if there are no records in the MarineTraffic database for the specific time range you’ve defined.
Solution:
Try adjusting the timespan parameter to capture a broader range of data.
Note: Ensure the new value does not exceed the maximum timespan limit for the specific API service. Refer to the API documentation for details.
2. Limited AIS Coverage in the Area
If the vessel(s) are operating in areas with limited AIS coverage, such as:
Regions with sparse terrestrial AIS stations.
Areas without satellite AIS reception.
Locations where roaming AIS data is delayed or unavailable.
Explanation:
This is expected behavior in such regions. New data will be returned as soon as it is received from the vessels.
3. Contact Support for Assistance
If the above actions do not resolve the issue, you can contact our support team for further troubleshooting.- Check whether a fleet has been created in your MarineTraffic account. Creating a fleet and adding selected vessels ensures they appear in fleet views and API results.
MarineTraffic API services are linked directly to your MarineTraffic Events fleet; ensure vessels are activated for API access after being added.
Applicable API Services The above guidance applies to the following API services: • AIS • Port Calls • Voyage Forecasts • Expected Arrivals For additional details, refer to the API documentation.Additionally, if managing fleets, ensure that the relevant vessels in your MarineTraffic Events fleet have been activated for API access.