vessel-api-python 2.0.0__tar.gz → 2.0.1__tar.gz

{vessel_api_python-2.0.0 → vessel_api_python-2.0.1}/CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to this package are documented here.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [2.0.1] - 2026-10-08
+
+Documentation only. No method, parameter or model changed.
+
+### Fixed
+
+- The bundled OpenAPI spec named the satellite fallback parameter `sat`; the
+  API's parameter is `filter.sat`. Descriptions corrected.
+
+### Changed
+
+- README: the satellite fallback note says when it fires (no recent terrestrial
+  position stored); the radius example describes the time window it searches
+  (default 2 hours, at most 4).
+
 ## [2.0.0] - 2026-08-16
 
 Vessel ownership, classification and inspection data, and NAVTEX messages, were

{vessel_api_python-2.0.0 → vessel_api_python-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vessel-api-python
-Version: 2.0.0
+Version: 2.0.1
 Summary: Python client for the Vessel Tracking API: maritime vessel tracking, port events, emissions, and nautical infrastructure.
 Project-URL: Documentation, https://vesselapi.com/docs
 Project-URL: Repository, https://github.com/vessel-api/vesselapi-python
@@ -131,11 +131,12 @@ print(f"{vessel.vessel.name} ({vessel.vessel.vessel_type})")
 pos = client.vessels.position("232003239", filter_id_type="mmsi")
 print(f"Position: {pos.vessel_position.latitude}, {pos.vessel_position.longitude}")
 
-# filter_sat=True falls back to satellite AIS when nothing is stored.
+# filter_sat=True falls back to satellite AIS when no recent terrestrial position is stored.
 # ⚠️ Satellite lookups draw on a prepaid balance and are charged per call.
 # Omit it unless you need that fallback.
 
-# Find all vessels within 10 km of Rotterdam.
+# Find vessels with an AIS position within 10 km of Rotterdam in the last 2 hours
+# (the default time window, at most 4 hours).
 nearby = client.location.vessels_radius(latitude=51.9225, longitude=4.47917, radius=10000)
 for v in nearby.vessels or []:
     print(f"{v.vessel_name} at {v.latitude}, {v.longitude}")

{vessel_api_python-2.0.0 → vessel_api_python-2.0.1}/README.md

@@ -97,11 +97,12 @@ print(f"{vessel.vessel.name} ({vessel.vessel.vessel_type})")
 pos = client.vessels.position("232003239", filter_id_type="mmsi")
 print(f"Position: {pos.vessel_position.latitude}, {pos.vessel_position.longitude}")
 
-# filter_sat=True falls back to satellite AIS when nothing is stored.
+# filter_sat=True falls back to satellite AIS when no recent terrestrial position is stored.
 # ⚠️ Satellite lookups draw on a prepaid balance and are charged per call.
 # Omit it unless you need that fallback.
 
-# Find all vessels within 10 km of Rotterdam.
+# Find vessels with an AIS position within 10 km of Rotterdam in the last 2 hours
+# (the default time window, at most 4 hours).
 nearby = client.location.vessels_radius(latitude=51.9225, longitude=4.47917, radius=10000)
 for v in nearby.vessels or []:
     print(f"{v.vessel_name} at {v.latitude}, {v.longitude}")

{vessel_api_python-2.0.0 → vessel_api_python-2.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vessel-api-python"
-version = "2.0.0"
+version = "2.0.1"
 description = "Python client for the Vessel Tracking API: maritime vessel tracking, port events, emissions, and nautical infrastructure."
 readme = "README.md"
 requires-python = ">=3.9"

{vessel_api_python-2.0.0 → vessel_api_python-2.0.1}/src/vessel_api_python/_constants.py

@@ -1,6 +1,6 @@
 """Constants for the Vessel API Python SDK."""
 
-VERSION = "2.0.0"
+VERSION = "2.0.1"
 DEFAULT_BASE_URL = "https://api.vesselapi.com/v1"
 DEFAULT_USER_AGENT = f"vesselapi-python/{VERSION}"
 DEFAULT_MAX_RETRIES = 3