API GORADAR

Данные о позициях судов

Данное API позволяет получать данные о позициях (координатах) судов из заданного списка. Можно получать данные как по всему списку сразу, так и по выбранному судну или судам через указания их IMO или MMSI. Также для каждого запроса возможно указывать глубину истории позиций в минутах. Данное API работает для разовых запросов и не подходит для регуляного отслеживания флота.

Пример URL с атрибутами для получения (возврата) данных (GET)

https://goradar.ru/g/list?
key
=
%KEY%
&
imo
=9013658,9641481,9641481&
mmsi
=273428510,210621000&
age
=60

где

%KEY%
-- уникальный приватный ключ доступа к API

Если указать только ключ доступа, будут показаны позиции всех судов на которые была подписка (в течении последних 120 минут)

Атрибуты запроса

Атрибут Тип Обязательно По умолчанию Описание
key
String Да Ключ доступа к API
age
Integer Нет 120 Максимальный возраст возвращаемых позиций (минут назад)
imo
List of integers Нет Список IMO номеров разделенных запятыми
mmsi
List of integers Нет Список MMSI номеров разделенных запятыми

Ответы и Примеры

Ответы по умолчанию возвращаются в формате JSON (массив объектов). Нулевым элементом данного массива всегда будет объект содержащий единственный атрибут "status". Данный атрибут может принимать следующие значения:

ok -- ключ верный (200 ответ сервера). Только при этом статусе возвращаются данные при их наличии
bad key -- неверный ключ
empty key -- атрибут ключа не указан

Пример JSON: список всех позиций за последние 5 лет: https://goradar.ru/g/list?key=CwxXaZypkKFBAuaApM4JjSZEj5qu69hD&age=2628000

Расшифровка атрибутов возвращаемого JSON

Атрибут Тип Описание
MMSI
Integer MMSI номер судна
TIMESTAMP
String Дата получения позиции
LATITUDE
FLoat Широта
LONGITUDE
FLoat Долгота
SPEED
Float Скорость судна
HEADING
Float Направление (носа) судна
STATUS
Integer Навигационный статус судна:
0 -- ход на тяге двигателя
1 -- на якоре
2 -- без командования
3 -- ограниченная маневренность
4 -- стеснено своей осадкой (отношение между осадкой и глубиной значимо ограничивают возможности отклонения от текущего курса)
5 -- пришвартовано
6 -- на мели
7 -- на рыбной ловле
8 -- в пути под парусом
9 -- зарезервировано для будущих изменений навигационного статуса для судов, перевозящих опасные грузы (DG), вредные вещества (HS) или морские загрязнители (MP)
10 -- зарезервировано для будущих изменений навигационного статуса для судов, перевозящих опасные грузы (DG), вредные вещества (HS) или морские загрязнители (MP)
11,12,13 -- зарезервированы на будущее
11,12,13 -- зарезервированы на будущее
14 -- активирован АИС-САРТ (передатчик используемый при бедствии)
15 -- не определено
IMO
Integer IMO номер судна
NAME
String Название судна
CALLSIGN
String Позывной судна
TYPE
Integer Тип судна:
0 -- не определено
1-19 -- зарезервировано на будущее
20 -- любые суда типа Wing in ground (WIG)
21 -- суда типа Wing in ground (WIG), категория опасности A
22 -- суда типа Wing in ground (WIG), категория опасности B
23 -- суда типа Wing in ground (WIG), категория опасности C
24 -- суда типа Wing in ground (WIG), категория опасности D
25-29 -- суда типа Wing in ground (WIG), зарезервировано на будущее
30 -- рыбный промысел
31 -- буксировка
32 -- буксировка, с длиной более 200 метров или шириной более 25 метров
33 -- дноуглубительные работы или подводные операции
34 -- для дайвинга
35 -- военное
36 -- парусное
37 -- прогулочное
38,39 -- зарезервировано
40 -- скоростное судно любой категории
41 -- скоростное судно категории опасности A
42 -- скоростное судно категории опасности B
43 -- скоростное судно категории опасности C
44 -- скоростное судно категории опасности D
45-48 -- скоростное судно, зарезервировано на будущее
49 -- скоростное судно, без уточняющей информации
50 -- лоцманское
51 -- поисково-спасательное
52 -- буксир
53 -- одномачтовое
54 -- снаряжено для защиты от загрязнения
55 -- правоохранительные органы
56,57 -- запчасти
58 -- медицинский транспорт
59 -- небоевое судно
60 -- пассажирское любого типа
61 -- пассажирское судно категории опасности A
62 -- пассажирское судно категории опасности B
63 -- пассажирское судно категории опасности C
64 -- пассажирское судно категории опасности D
65-68 -- пассажирское, зарезервировано на будущее
69 -- пассажирское, без уточняющей информации
70 -- грузовое любого типа
71 -- грузовое судно категории опасности A
72 -- грузовое судно категории опасности B
73 -- грузовое судно категории опасности C
74 -- грузовое судно категории опасности D
75-78 -- грузовое, зарезервировано на будущее
79 -- грузовое, без уточняющей информации
80 -- танкер любого типа
81 -- танкер судно категории опасности A
82 -- танкер судно категории опасности B
83 -- танкер судно категории опасности C
84 -- танкер судно категории опасности D
85-88 -- танкер, зарезервировано на будущее
89 -- танкер, без уточняющей информации
80 -- другие суда любого типа
81 -- другое судно категории опасности A
82 -- другое судно категории опасности B
83 -- другое судно категории опасности C
84 -- другое судно категории опасности D
85-88 -- другое судно, зарезервировано на будущее
89 -- другое судно, без уточняющей информации
TOP
Integer Расстояние от AIS антенны до носовой части судна
BOTTOM
Integer Расстояние от AIS антенны до кормы
LEFT
Integer Расстояние от AIS антенны до левого борта
RIGHT
Integer Расстояние от AIS антенны до правого борта
(Таким образом можно вычислять размеры судна: Длина = TOP + BOTTOM, Ширина = LEFT + RIGHT)
DRAUGHT
Float Осадка судна
DESTINATION
String Пункт назначения (установленный вручную)
ETA
String Ориентировочное время прибытия в пункт назначения (вводится вручную)
ETA_FULL
String То же, в более длинном формате
SRC
String провайдер получения поиции: SAT -- через спутник, TER -- через наземную AIS станцию
ZONE
String область (географическая) расположения судна
ECA
String Находится ли судно в зоне контроля выбросов (Emission Control Area (ECA) + SECA). Да или нет

Примеры