API / Webservice

Build on Top of Aquaplot

Every feature, functionality and service that we provide is accessible via API so you can use it to integrate it into your products and services, website, internal tools or even your ERP.

Below are some examples. A complete list and the documentation can be found at doc.aquaplot.com.

Get Distance
/distance/from/lng/lat/to/lng/lat?options

Get information on a particular route. Response includes for example total distance and S(ECA) distance.


See Documentation
Example
Request:
api.aquaplot.com/v1/distance/from/19/61.5/to/31/43?suez=true&panama=true
Response:
{
  "type":"FeatureCollection",
  "features":[
    {
      "type":"Feature",
      "properties":
      {
        "total_length": 4293.96,
        "seca_length": 1430.72,
        "crossed": []
      },
      "geometry":
      {
        "type":"LineString",
        "coordinates":
        [
          [19,61.5],
          [31,43]
        ]
      }
    }
  ]
}
Get Route
/route/from/lng/lat/to/lng/lat?options

Get a route (sequence of waypoints) which you can display on a map. Result also includes all information from a /distance call.


See Documentation
Example
Request:
api.aquaplot.com/v1/route/from/19/61.5/to/31/43?suez=true&panama=true
Response:
{
  "type":"FeatureCollection",
  "features":[
    {
      "type":"Feature",
      "properties":
      {
        "total_length": 4293.96,
        "seca_length": 1430.72,
        "crossed": []
      },
      "geometry":
      {
        "type":"LineString",
        "coordinates":
        [
          [19,61.5],
          [19.092528,59.831667],
          [19.107389,59.7875],
          [19.090833,59.748306],
          ... many more ...,
          [29.069583,41.119972],
          [29.069528,41.160806],
          [31,43]
        ]
      }
    }
  ]
}
Search Ports by Name
/geocode/query

Retrieve ports and points of interest that include your search query. Use this call to, for example, implement a search field.


See Documentation
Example
Request:
api.aquaplot.com/v1/geocode/ham
Response:
[
  {
    "key": "HAMBURG",
    "value": {
      "lat": 53.552889,
      "lng": 9.831694
    }
  },
  {
    "key": "HAMBURG (PG) HABOUR",
    "value": {
      "lat": -1.623778,
      "lng": 149.958278
    }
  }
]
Store Points of Interest
/geocode/name/lng/lat

Store any locations in our database so it will be accessible for you via the "Search Ports by Name" call.


See Documentation
Example
Request:
api.aquaplot.com/v1/geocode/MyAnchorage/12.34/56.78
Response:
{
  "status": "ok",
  "name": "MyAnchorage",
  "lng": 12.34,
  "lat": 56.78
}

How To Get Started - Next Steps

Free Trial!
Sign up for a free trial account for Aquaplot Explorer and then message our support team via our online form to receive API access.
Free Help!
We provide a free 1 hour consultation on request. Discuss business or technical requirements and get assistance for your project.

Also, have a look at the documentation.

Have an Idea for a Feature or Interested in a Partnership?

We are working on adding more and more features and expanding functionality and always appreciate input from industry professionals.

Send Us A Message

World of Sea Distance Services