Navigation
Nearby navigation aids
Find the aids closest to a point, nearest first.
For example, the lights a ship passes on its way into port. Distances are great-circle distances in kilometres, rounded to 0.1 km.
apiKeyAuthorizationBearer <token>An API key from the dashboard: a secret key (wk_sk_) from servers, or a publishable key (wk_pk_) from the origins listed on it. A workload can send its token in place of a secret key. See Authentication.
lat*numberLatitude in decimal degrees.
-90 <= value <= 90lon*numberLongitude in decimal degrees.
-180 <= value <= 180country?array<>ISO 3166-1 alpha-2 country code in capitals, e.g. NL. Repeat it for several countries: country=US&country=CA.
max_distance_km?numberLeave out anything further away than this, in kilometres.
0 < valuelimit?integerHow many to return.
1 <= value <= 5010kind?array<>Only aids of these kinds: light, buoy, beacon, racon, fog_signal, virtual, radio_beacon, dgps or drilling_unit. Leave it out for all of them.
The nearest aids, closest first, each with its distance. There is no total or offset: ask for a larger limit to see more.
application/json- response
results*array<>limit*integercurl -X GET 'https://waykite.com/api/v1/navigation/aids/nearby?lat=-90&lon=-180'{ "results": [ { "id": "aid_0c1c9b4c42a7ee54fe722dd8", "kind": "light", "name": "Raffles", "international_number": "F1693", "country": "SG", "coordinates": { "lat": 1.160222, "lon": 103.740775 }, "timezone": "Asia/Singapore", "characteristics": [ "Fl.(3)W. period 20s", "RACON O(- - - )" ], "height_m": 32, "range_nm": 20, "structure": "White round tower", "remarks": "AIS (MMSI No 005631114). Radar Reflector. DGPS Station", "nearest_port": { "unlocode": "SGSEB", "distance_km": 7.9 }, "distance_km": 3.2 } ], "limit": 1}Get a navigation aid GET
Look up one aid by its `id`. When there is none, the response is `204 No Content`, with an empty body.
Navigation aids in an area GET
List the aids in a box, by its edges in decimal degrees: everything a map shows, for example. A box whose west edge is east of its east edge crosses the antimeridian. At most 500 aids are returned; `truncated` says when there were more, and a smaller box shows them all.