Distance & Time API V2

API Entry Point	https://sirius.searates.com/api/distanceandtime?parameters
HTTP Method	GET

Request Parameters

Parameter name		Required	Type	Description
key		yes	string	API key: hexadecimal number
lat_from		yes	float number	The latitude value specifying the location for which you wish to obtain the closest point of loading.
lng_from		yes	float number	The longitude value specifying the location for which you wish to obtain the closest point of loading.
lat_to		yes	float number	The latitude value specifying the location for which you wish to obtain the closest point of discharge.
lng_to		yes	float number	The longitude value specifying the location for which you wish to obtain the closest point of discharge.
type		yes	string	The available values for this parameter are: sea | air | road | rail Default value: sea
speed		no	float number	Speed ​​for the selected type of transport. If speed is not set, it will be defaulted depending on the type (sea - 13 knots, air - 800 km/h, road - 35 km/h, rail - 35)
road_speed		no	float number	Transport speed to ports. Used for types sea, air. By default 35 km/h.

Example URL

https://sirius.searates.com/api/distanceandtime?lat_from=31.230416&lng_from=121.473701&lat_to=46.482526&lng_to=30.7233095&type=sea&key=XXXXXX&speed=15&road_speed=50

The above query returns the following result:

Example JSON response (type: sea)

{
  "transit_time_chart": {
    "pay": true,
    "drilldown": [
      {
        "name": "HAMBURG SUD",
        "id": "HAMBURG SUD",
        "lineId": 4,
        "data": [
          [
            "SEGU4197094",
            25
          ],
          ...
        ],
        "y": 31,
        "color": {
          ...
        }
      },
    ]
  },
  "road_from": {
    "path": [
      [
        31.230068,
        121.474106
      ],
      ...
    ],
    "distance": 28.495,
    "transit_time_seconds": 2052,
    "transit_time_days": "0 days",
    "name": "Shanghai, China",
    "speed": "50 km\/h",
    "lat": 31.230416,
    "lng": 121.473701
  },
  "sea": {
    "dist": 15401.06,
    "path": [
      [
        31.400089849043,
        121.49711608887
      ],
      ...
    ],
    "transit_time_seconds": 1995818,
    "transit_time_days": "23 days",
    "from_name": "Shanghai",
    "to_name": "Odessa",
    "speed": "15 knots",
    "from_lat": 31.4000905769357,
    "from_lng": 121.497112503479,
    "to_lat": 46.4999995864331,
    "to_lng": 30.7307730194095
  },
  "road_to": {
    "path": [
      [
        46.499035,
        30.729176
      ],
      ...
    ],
    "distance": 3.03772,
    "transit_time_seconds": 219,
    "transit_time_days": "0 days",
    "name": "Odessa, Odessa Oblast, Ukraine",
    "speed": "50 km\/h",
    "lat": 46.482526,
    "lng": 30.7233095
  }
}