Logo

An API for determining if a point (latitude and longitude) is on water or land. Welcome to the future.

From the Dockwa Engineers

Api

https://api.onwater.io/api/v1/results/[latitude],[longitude]?access_token=[your_token]


Water Example

https://api.onwater.io/api/v1/results/23.92323,-66.3

Result

{
  "query": "23.92323,-66.3",
  "request_id": "dbfc0929-286f-4bea-914b-6a46290a72c1",
  "lon": 23.92323,
  "lat": -66.3,
  "water": true
}

Land Example

https://api.onwater.io/api/v1/results/42.35,-71.1

Result

{
  "query": "42.35,-71.1",
  "request_id": "8c2f5f7d-0fce-4e31-bd7c-27fce7f6e092",
  "lon": 42.35,
  "lat": -71.1,
  "water": false
}

Bulk Example

curl -X POST \
  -H "Content-Type: application/json" \
  -d '["23.92323,-66.3","42.35,-71.1"]' \
  https://api.onwater.io/api/v1/results

Result

[{
  "query": "23.92323,-66.3",
  "request_id": "982bf1cd-9400-4d4b-a478-9955ba890413",
  "lon": 23.92323,
  "lat": -66.3,
  "water": true
}, {
  "query": "42.35,-71.1",
  "request_id": "982bf1cd-9400-4d4b-a478-9955ba890413",
  "lon": 42.35,
  "lat": -71.1,
  "water": false
}]

Getting Started

Sign up for a developer account and API Key.

Choose a Plan

We offer 2 plans: unpaid and paid.

  • An unpaid API Key grants 15 requests every minute for free. Up to 3 coordinates per bulk request.
  • A paid API Key with much higher limits: 10 requests per second. Up to 20 coordinates per bulk request. The paid plan costs $0.00005 / coordinate (or $1 / 20,000 coordinates).

You can enable the paid plan by adding a Payment Option when logged in.

Have something else in mind? Drop us a note, we'd love to hear from you. [email protected]


©2018 Dockwa, Inc.