Previous value: -"beam, metres"New value: +"beam, metres; never for gear"

Previous value: -"maximum static draught, metres"New value: +"maximum static draught, metres; never for gear"

Previous value: -"true heading, degrees"New value: +"true heading, degrees, 0 to 359; never for gear"

Previous value: -"overall length, metres"New value: +"overall length, metres; never for gear, whose size is a placeholder"

Previous value: -"ISO 3166-1 alpha-2 code of the flag state, from the MMSI's maritime identification digits"New value: +"ISO 3166-1 alpha-2 code of the flag state, from the MMSI's maritime identification digits; never set for gear"

Previous value: -"vessel, aton (aid to navigation), base (base station), or sar (search and rescue aircraft)"New value: +"vessel, aton (aid to navigation), base (base station), sar (search and rescue aircraft or active distress beacon: AIS-SART, man-overboard, EPIRB-AIS), or gear (fishing gear, usually a net buoy, which has no flag)"

Previous value: -"text to find in the vessel name, at least 2 characters, case-insensitive"New value: +"text to find in the vessel name, at least 2 characters, case-insensitive; with a feeder or partner token, IMO followed by an IMO number finds that IMO"

Previous value: -"true when total exceeds the rows returned; narrow the query or raise limit"New value: +"true when rows were left out: total exceeds the rows returned, so narrow the query or raise limit, or an IMO number is reported by more than the 10 vessels returned for it"

Previous value: -"the source's own page for this vessel"New value: +"the source's page for this vessel, or its public search when the source keeps no per-vessel pages"

Added value: +{
+  "description": "call sign as registered; the callsign in the vessel's own properties is the one AIS reports",
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "particulars as registered, merged from the enrichment sources into one vocabulary (get_vessels)",
+  "properties": {
+    "beam": {
+      "description": "beam as registered, metres",
+      "type": "number"
+    },
+    "builder": {
+      "description": "shipyard or builder",
+      "type": "string"
+    },
+    "commons_category": {
+      "description": "the category of the ship's photos on Wikimedia Commons",
+      "type": "string"
+    },
+    "deadweight": {
+      "description": "deadweight, tonnes",
+      "type": "integer"
+    },
+    "depth": {
+      "description": "registered depth, metres",
+      "type": "number"
+    },
+    "draught": {
+      "description": "design draught, metres; AIS reports the draught on the current voyage",
+      "type": "number"
+    },
+    "former_names": {
+      "description": "names the vessel has carried before, oldest first",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "null",
+        "array"
+      ]
+    },
+    "gross_tonnage": {
+      "type": "integer"
+    },
+    "home_port": {
+      "description": "port of registry",
+      "type": "string"
+    },
+    "identification": {
+      "description": "the flag state's number for the vessel: a documented vessel's official number, else its state registration",
+      "type": "string"
+    },
+    "image": {
+      "description": "the Commons page of a photo of the ship, which shows its license and credit",
+      "type": "string"
+    },
+    "length": {
+      "description": "length as registered, metres; may differ from the AIS length",
+      "type": "number"
+    },
+    "net_tonnage": {
+      "type": "integer"
+    },
+    "operator": {
+      "type": "string"
+    },
+    "owner": {
+      "type": "string"
+    },
+    "registered_name": {
+      "description": "name as documented with the flag state, when it differs from what AIS reports",
+      "type": "string"
+    },
+    "registry": {
+      "description": "country of registry, in English",
+      "type": "string"
+    },
+    "service": {
+      "description": "flag-state service type, e.g. Towing Vessel, Passenger (Inspected), Recreational",
+      "type": "string"
+    },
+    "ship_type": {
+      "description": "kind of ship, e.g. bulk carrier, container ship, ferry",
+      "type": "string"
+    },
+    "status": {
+      "description": "flag-state status, e.g. Active, Laid Up",
+      "type": "string"
+    },
+    "tonnage_measure": {
+      "description": "how a tonnage from the flag state was measured: Convention (the international system), Regulatory (the older US system, in register tons), or Simplified (small vessels)",
+      "type": "string"
+    },
+    "wikipedia": {
+      "description": "the ship's English Wikipedia article",
+      "type": "string"
+    },
+    "yard_number": {
+      "description": "the builder's hull number",
+      "type": "string"
+    },
+    "year_built": {
+      "type": "integer"
+    }
+  },
+  "type": [
+    "null",
+    "object"
+  ]
+}

Added value: +{
+  "additionalProperties": {
+    "type": "string"
+  },
+  "description": "the source of each particulars field, by the field's name; values are keys of sources (get_vessels)",
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {
+    "additionalProperties": false,
+    "properties": {
+      "credit": {
+        "description": "display credit for the source",
+        "type": "string"
+      },
+      "license": {
+        "type": "string"
+      },
+      "url": {
+        "description": "the source's own page for this vessel",
+        "type": "string"
+      }
+    },
+    "required": [
+      "credit",
+      "license"
+    ],
+    "type": "object"
+  },
+  "description": "each contributing source's credit, license, and its own page for this vessel (get_vessels)",
+  "type": "object"
+}

Removed value: -{
-  "additionalProperties": false,
-  "description": "particulars as documented with the US Coast Guard, for a US-flag vessel whose call sign and name match a vessel in its PSIX database (get_vessels)",
-  "properties": {
-    "beam": {
-      "description": "registered breadth, metres",
-      "type": "number"
-    },
-    "depth": {
-      "description": "registered depth, metres",
-      "type": "number"
-    },
-    "gross_tonnage": {
-      "type": "integer"
-    },
-    "id": {
-      "description": "the vessel's ID in PSIX",
-      "type": "integer"
-    },
-    "identification": {
-      "description": "the official number of a documented vessel, else its state registration",
-      "type": "string"
-    },
-    "length": {
-      "description": "registered length, metres",
-      "type": "number"
-    },
-    "license": {
-      "description": "public domain (U.S. government work), no credit required",
-      "type": "string"
-    },
-    "name": {
-      "description": "name as documented with the Coast Guard",
-      "type": "string"
-    },
-    "net_tonnage": {
-      "type": "integer"
-    },
-    "service": {
-      "description": "service type, e.g. Towing Vessel, Passenger (Inspected), Commercial Fishing Vessel, Recreational",
-      "type": "string"
-    },
-    "status": {
-      "description": "Coast Guard status, e.g. Active, Laid Up",
-      "type": "string"
-    },
-    "tonnage_measure": {
-      "description": "how the tonnage was measured: Convention (the international system), Regulatory (the older US system, in register tons), or Simplified (small vessels)",
-      "type": "string"
-    },
-    "year_built": {
-      "type": "integer"
-    }
-  },
-  "required": [
-    "id",
-    "license",
-    "name"
-  ],
-  "type": [
-    "null",
-    "object"
-  ]
-}

Removed value: -{
-  "additionalProperties": false,
-  "description": "particulars as registered, from the vessel's Wikidata item found by its IMO number (get_vessels)",
-  "properties": {
-    "beam": {
-      "description": "beam as registered, metres",
-      "type": "number"
-    },
-    "builder": {
-      "description": "shipyard or builder",
-      "type": "string"
-    },
-    "commons_category": {
-      "description": "the category of the ship's photos on Wikimedia Commons",
-      "type": "string"
-    },
-    "deadweight": {
-      "description": "deadweight, tonnes",
-      "type": "integer"
-    },
-    "draught": {
-      "description": "design draught, metres; AIS reports the draught on the current voyage",
-      "type": "number"
-    },
-    "former_names": {
-      "description": "names the vessel has carried before, oldest first",
-      "items": {
-        "type": "string"
-      },
-      "type": [
-        "null",
-        "array"
-      ]
-    },
-    "gross_tonnage": {
-      "type": "integer"
-    },
-    "home_port": {
-      "description": "port of registry",
-      "type": "string"
-    },
-    "id": {
-      "description": "Wikidata item ID",
-      "type": "string"
-    },
-    "image": {
-      "description": "the Commons page of a photo of the ship, which shows its license and credit",
-      "type": "string"
-    },
-    "length": {
-      "description": "length as registered, metres; may differ from the AIS length",
-      "type": "number"
-    },
-    "license": {
-      "description": "CC0-1.0: public domain, no credit required; the photos image and commons_category lead to carry their own licenses",
-      "type": "string"
-    },
-    "operator": {
-      "type": "string"
-    },
-    "owner": {
-      "type": "string"
-    },
-    "registry": {
-      "description": "country of registry, in English",
-      "type": "string"
-    },
-    "ship_type": {
-      "description": "kind of ship, e.g. bulk carrier, container ship, oil tanker, ferry",
-      "type": "string"
-    },
-    "url": {
-      "description": "the item's page on Wikidata",
-      "type": "string"
-    },
-    "wikipedia": {
-      "description": "the ship's English Wikipedia article",
-      "type": "string"
-    },
-    "yard_number": {
-      "description": "the builder's hull number",
-      "type": "string"
-    },
-    "year_built": {
-      "description": "year the vessel entered service",
-      "type": "integer"
-    }
-  },
-  "required": [
-    "id",
-    "url",
-    "license"
-  ],
-  "type": [
-    "null",
-    "object"
-  ]
-}

Added value: +{
+  "additionalProperties": false,
+  "description": "particulars as documented with the US Coast Guard, for a US-flag vessel whose call sign and name match a vessel in its PSIX database (get_vessels)",
+  "properties": {
+    "beam": {
+      "description": "registered breadth, metres",
+      "type": "number"
+    },
+    "depth": {
+      "description": "registered depth, metres",
+      "type": "number"
+    },
+    "gross_tonnage": {
+      "type": "integer"
+    },
+    "id": {
+      "description": "the vessel's ID in PSIX",
+      "type": "integer"
+    },
+    "identification": {
+      "description": "the official number of a documented vessel, else its state registration",
+      "type": "string"
+    },
+    "length": {
+      "description": "registered length, metres",
+      "type": "number"
+    },
+    "license": {
+      "description": "public domain (U.S. government work), no credit required",
+      "type": "string"
+    },
+    "name": {
+      "description": "name as documented with the Coast Guard",
+      "type": "string"
+    },
+    "net_tonnage": {
+      "type": "integer"
+    },
+    "service": {
+      "description": "service type, e.g. Towing Vessel, Passenger (Inspected), Commercial Fishing Vessel, Recreational",
+      "type": "string"
+    },
+    "status": {
+      "description": "Coast Guard status, e.g. Active, Laid Up",
+      "type": "string"
+    },
+    "tonnage_measure": {
+      "description": "how the tonnage was measured: Convention (the international system), Regulatory (the older US system, in register tons), or Simplified (small vessels)",
+      "type": "string"
+    },
+    "year_built": {
+      "type": "integer"
+    }
+  },
+  "required": [
+    "id",
+    "license",
+    "name"
+  ],
+  "type": [
+    "null",
+    "object"
+  ]
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "particulars as registered, from the vessel's Wikidata item found by its IMO number (get_vessels)",
+  "properties": {
+    "beam": {
+      "description": "beam as registered, metres",
+      "type": "number"
+    },
+    "builder": {
+      "description": "shipyard or builder",
+      "type": "string"
+    },
+    "commons_category": {
+      "description": "the category of the ship's photos on Wikimedia Commons",
+      "type": "string"
+    },
+    "deadweight": {
+      "description": "deadweight, tonnes",
+      "type": "integer"
+    },
+    "draught": {
+      "description": "design draught, metres; AIS reports the draught on the current voyage",
+      "type": "number"
+    },
+    "former_names": {
+      "description": "names the vessel has carried before, oldest first",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "null",
+        "array"
+      ]
+    },
+    "gross_tonnage": {
+      "type": "integer"
+    },
+    "home_port": {
+      "description": "port of registry",
+      "type": "string"
+    },
+    "id": {
+      "description": "Wikidata item ID",
+      "type": "string"
+    },
+    "image": {
+      "description": "the Commons page of a photo of the ship, which shows its license and credit",
+      "type": "string"
+    },
+    "length": {
+      "description": "length as registered, metres; may differ from the AIS length",
+      "type": "number"
+    },
+    "license": {
+      "description": "CC0-1.0: public domain, no credit required; the photos image and commons_category lead to carry their own licenses",
+      "type": "string"
+    },
+    "operator": {
+      "type": "string"
+    },
+    "owner": {
+      "type": "string"
+    },
+    "registry": {
+      "description": "country of registry, in English",
+      "type": "string"
+    },
+    "ship_type": {
+      "description": "kind of ship, e.g. bulk carrier, container ship, oil tanker, ferry",
+      "type": "string"
+    },
+    "url": {
+      "description": "the item's page on Wikidata",
+      "type": "string"
+    },
+    "wikipedia": {
+      "description": "the ship's English Wikipedia article",
+      "type": "string"
+    },
+    "yard_number": {
+      "description": "the builder's hull number",
+      "type": "string"
+    },
+    "year_built": {
+      "description": "year the vessel entered service",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "id",
+    "url",
+    "license"
+  ],
+  "type": [
+    "null",
+    "object"
+  ]
+}

Previous value: -"requested IMO numbers matching no vessel heard in the last 30 minutes"New value: +"requested IMO numbers matching no vessel the network has heard"

Previous value: -"requested MMSIs not heard in the last 30 minutes"New value: +"requested MMSIs matching no vessel the network has heard"

Added value: +{
+  "description": "only vessels flying this flag: ISO 3166-1 alpha-2, e.g. NO, FI, MH",
+  "type": "string"
+}

Added value: +{
+  "description": "requested IMO numbers matching no vessel heard in the last 30 minutes",
+  "items": {
+    "maximum": 4294967295,
+    "minimum": 0,
+    "type": "integer"
+  },
+  "type": [
+    "null",
+    "array"
+  ]
+}

Added value: +{
+  "description": "beam, metres",
+  "maximum": 65535,
+  "minimum": 0,
+  "type": [
+    "null",
+    "integer"
+  ]
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "description": "destination as typed by the crew: a port name, a UN/LOCODE, or nothing useful",
+  "type": "string"
+}

Added value: +{
+  "description": "maximum static draught, metres",
+  "type": [
+    "null",
+    "number"
+  ]
+}

Added value: +{
+  "description": "estimated arrival as sent, MM-DD HH:MM UTC or MM-DD; AIS carries no year, so read it as the next occurrence",
+  "type": "string"
+}

Added value: +{
+  "description": "ISO 3166-1 alpha-2 code of the flag state, from the MMSI's maritime identification digits",
+  "type": "string"
+}

Added value: +{
+  "description": "IMO number, once the vessel's static data has been heard",
+  "maximum": 4294967295,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "overall length, metres",
+  "maximum": 65535,
+  "minimum": 0,
+  "type": [
+    "null",
+    "integer"
+  ]
+}