1.4 Vessels in Zone

Description

The Vessels in Zone retrieves all AIS data of vessels within a specified geographic area in a single request. You may pass multiple latitude and longitude coordinates to define a custom polygonal search area.

The recommended area size for a single request is within 1°×1° to ensure full data return in one call; otherwise, you will need to make multiple requests with the scode token to fetch all vessel data in the target area.

The JSON format returns approximately 2,600 vessel records per response, while the binary format returns around 8,000 records. For large search areas, you may split the area into smaller subareas and request data sequentially, and use the scode token to retrieve remaining vessel data iteratively.

We also provide customized push services for Vessels in Zone, supporting integration via TCP/IP or Kafka. Please contact our support team for more information: support@elaneglobal.com

Use Cases

Customs and Border Inspection Area Monitoring
Monitor all vessels in coastal or key designated areas, track the vessel watchlist, and oversee vessel operating behaviors.

Port Vessel Density Analysis
Define a zone near the port to capture all vessel information within the scope, filter vessels by category and destination port data, and analyze the vessel distribution density around the port.

Logistics Vessel Matching
Specify a zone around the departure port/warehouse, filter information and destination ports of all cargo vessels, and generate a shortlist of qualified cargo vessels by combining vessel profile queries, historical behavior, ETA and other datasets.

Request Limits

An API key must be created before using this service. API calls are subject to quota restrictions according to your permission type. To view your current service access permissions, please contact our support team: support@elaneglobal.com.

Endpoint

Endpoint	HTTP Method	Remarks
`https://api.elaneglobal.com/v1/AIS/VesselsInZone`	GET	Vessels that have not reported AIS data for more than 2 hours will be excluded from the area-based search results, as their presence in the target area cannot be verified.TCP/IP custom push services can be customized to your actual needs, supporting multiple filtering rules: designated geographic area, vessel type/length, and custom dedicated fleet lists. Push frequency and returned data fields can also be defined as required.

Example API call

https://api.elaneglobal.com/v1/AIS/VesselsInZone?key=1F6D701272402D1E7D8D316CCE519123&region=121.289063,35.424868-122.783203,35.281501-122.167969,33.979809&output=1

Note:
The key 1F6D701272402D1E7D8D316CCE519123 is the official key of elaneglobal.com, bound to the domain api.elaneglobal.com.
Users are not authorized to use this key for data access—utilizing it will return a status code 14, indicating an error in the source domain.
To trial the service, please contact our support team: support@elaneglobal.com.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

⚪0success

application/json

Body

Example

{
  "status": 0,
  "msg": "",
  "data": {
    "total": 54,
    "scode": 20,
    "continue": 0,
    "ship_list": [
      {
        "mmsi": 370286000,
        "imo": 9844100,
        "call_sign": "HOLO",
        "ship_name": "SEA VICTORIA",
        "ship_cnname": "",
        "data_source": 0,
        "ship_type": 70,
        "length": 340,
        "width": 62,
        "left": 36,
        "trail": 51,
        "draught": 12.7,
        "dest": "SINGAPORE,SG",
        "destcode": "SGSIN",
        "eta": "1746547200",
        "navistat": 0,
        "lat": 34.606657,
        "lng": 121.966072,
        "sog": 12.8,
        "cog": 111.4,
        "hdg": 114,
        "rot": 0,
        "last_time": 1745904185
      },
      {
        "mmsi": 412304788,
        "imo": 0,
        "call_sign": "",
        "ship_name": "SUGANYU04788",
        "ship_cnname": "苏赣渔04788",
        "data_source": 0,
        "ship_type": 30,
        "length": 0,
        "width": 0,
        "left": 0,
        "trail": 0,
        "draught": 0,
        "dest": "",
        "destcode": "",
        "eta": "",
        "navistat": 0,
        "lat": 34.507535,
        "lng": 121.96778,
        "sog": 8.6,
        "cog": 246.9,
        "hdg": 511,
        "rot": 0,
        "last_time": 1745902562
      }
    ]
  }
}

Description#

Use Cases#

Request Limits#

Endpoint#

Example API call#