Portcalls API и выгрузки заходов в порты

Генерируем и выдаём данные по заходам и выходам судов в порты по выбранным портам, странам и типам судов. Можно собрать историческую выгрузку за последний год, подготовить API-слой на кеше и затем обновлять данные инкрементально. Для России и других крупных scope задача обычно идет как batch, а не как один быстрый запрос.

CSV / JSON Порты, страны, типы судов История за 1 год и больше API и кеш-материализация

Что это за данные

События захода и выхода

Фиксируем фактическое появление судна в акватории порта и выход из неё.

Порт и локальное время

Отдаём порт, его русское имя, дату и время события в удобном для клиента виде.

Судно и характеристики

В выгрузке есть IMO, MMSI, имя судна, тип, флаг, страна и доп. поля, если они есть в базе.

  • можно отбирать порты по стране или списком
  • можно фильтровать по типам судов
  • подходит для логистики, аналитики, расследований и комплаенса
  • можно получать как историческую выгрузку, так и API-слой
  • для B2B возможны счет, договор и закрывающие документы
  • если нужен большой объем, сначала оцениваем нагрузку и разбиваем генерацию на батчи

Как задаётся scope

Порты

Можно передать список портов напрямую или собрать scope по стране и затем раскрыть его до портов.

Страны

Для страны мы работаем не абстрактно, а по реальному списку портов из базы. Это удобно для выгрузки по России, Турции или любой другой стране.

Типы судов

Можно сузить выборку до LNG, LPG, tanker, cargo, container, bulk или оставить all_vessels для полного контура.

Как мы генерируем portcalls

1

Вы выбираете порты, страну или список портов и задаёте типы судов.

2

Система собирает кандидатов по типу судна и группирует их по таблицам `mh*`.

3

Для каждого порта берётся трек в пределах геобокса и окна дат.

4

Правила детекции находят события entry/exit и вычисляют daily summary.

5

Результат пишется в cache tables, из которых API уже читается быстро.

Для больших задач мы не пытаемся прогнать всё одной гигантской транзакцией. В тяжёлых сценариях запускаем генерацию батчами по портам и по окнам дат.

Что влияет на цену и сроки

1 порт / 12 месяцев

Если кеш уже прогрет, это обычно десятки минут. Первый прогон может идти дольше, потому что строится материализация.

10 портов / 12 месяцев

Как правило, это уже несколько часов и не быстрый одиночный запрос. Такой scope лучше запускать батчем.

Россия-wide / 12 месяцев

Для всей России за год первый запуск обычно планируют как ночной или более длинный batch job.

Тарифы для исторической выгрузки

Период 1 порт.5 порт.10 порт.25 порт.50 порт.100 порт.
1 мес. 2 050 ₽
≈ 2 050 ₽ за порт в месяц
9 500 ₽
≈ 1 900 ₽ за порт в месяц
17 400 ₽
≈ 1 740 ₽ за порт в месяц
38 800 ₽
≈ 1 552 ₽ за порт в месяц
77 600 ₽
≈ 1 552 ₽ за порт в месяц
134 600 ₽
≈ 1 346 ₽ за порт в месяц
3 мес. 6 200 ₽
≈ 2 067 ₽ за порт в месяц
28 600 ₽
≈ 1 907 ₽ за порт в месяц
52 200 ₽
≈ 1 740 ₽ за порт в месяц
116 400 ₽
≈ 1 552 ₽ за порт в месяц
232 900 ₽
≈ 1 553 ₽ за порт в месяц
403 700 ₽
≈ 1 346 ₽ за порт в месяц
6 мес. 12 400 ₽
≈ 2 067 ₽ за порт в месяц
57 100 ₽
≈ 1 903 ₽ за порт в месяц
104 300 ₽
≈ 1 738 ₽ за порт в месяц
232 900 ₽
≈ 1 553 ₽ за порт в месяц
465 800 ₽
≈ 1 553 ₽ за порт в месяц
807 300 ₽
≈ 1 346 ₽ за порт в месяц
12 мес. 24 800 ₽
≈ 2 067 ₽ за порт в месяц
114 300 ₽
≈ 1 905 ₽ за порт в месяц
208 700 ₽
≈ 1 739 ₽ за порт в месяц
465 800 ₽
≈ 1 553 ₽ за порт в месяц
931 500 ₽
≈ 1 553 ₽ за порт в месяц
1 614 600 ₽
≈ 1 346 ₽ за порт в месяц

Ориентировочная стоимость считается по числу месяцев, портов и типу выборки. Для страны или большого списка портов цена будет выше, но за счёт скидки по объему.

Тарифы для API и регулярных обновлений

Период 1 порт.5 порт.10 порт.25 порт.50 порт.100 порт.
1 мес. 2 750 ₽
≈ 2 750 ₽ за порт в месяц
12 700 ₽
≈ 2 540 ₽ за порт в месяц
23 200 ₽
≈ 2 320 ₽ за порт в месяц
51 800 ₽
≈ 2 072 ₽ за порт в месяц
103 500 ₽
≈ 2 070 ₽ за порт в месяц
179 400 ₽
≈ 1 794 ₽ за порт в месяц
3 мес. 8 300 ₽
≈ 2 767 ₽ за порт в месяц
38 100 ₽
≈ 2 540 ₽ за порт в месяц
69 600 ₽
≈ 2 320 ₽ за порт в месяц
155 300 ₽
≈ 2 071 ₽ за порт в месяц
310 500 ₽
≈ 2 070 ₽ за порт в месяц
538 200 ₽
≈ 1 794 ₽ за порт в месяц
6 мес. 16 600 ₽
≈ 2 767 ₽ за порт в месяц
76 200 ₽
≈ 2 540 ₽ за порт в месяц
139 100 ₽
≈ 2 318 ₽ за порт в месяц
310 500 ₽
≈ 2 070 ₽ за порт в месяц
621 000 ₽
≈ 2 070 ₽ за порт в месяц
1 076 400 ₽
≈ 1 794 ₽ за порт в месяц
12 мес. 33 100 ₽
≈ 2 758 ₽ за порт в месяц
152 400 ₽
≈ 2 540 ₽ за порт в месяц
278 200 ₽
≈ 2 318 ₽ за порт в месяц
621 000 ₽
≈ 2 070 ₽ за порт в месяц
1 242 000 ₽
≈ 2 070 ₽ за порт в месяц
2 152 800 ₽
≈ 1 794 ₽ за порт в месяц

API-доступ использует тот же набор данных, но после первичной материализации работает быстрее и удобен для интеграции в CRM, TMS, аналитику или внутренний кабинет.

Калькулятор цены и нагрузки

Как выглядит API

Для оперативного доступа используется API feed; для длинной истории и крупных скоупов сначала запускается материализация и экспорт в cache tables.

GET https://shipinfo.net/topos/api/portcall_feed.php?key=YOUR_TOKEN&days=30&port=3272&mode=lng_only
{
  "ok": true,
  "meta": {
    "days": 30,
    "ports": [3272, 3465],
    "mode": "lng_only",
    "source": "portcall_feed_events_cache"
  },
  "data": [
    {
      "event_day": "2026-05-27",
      "event_ts": "2026-05-27 14:12:00",
      "event_type": "entry",
      "port_id": 3272,
      "port_name": "Sabetta",
      "mmsi": 273000000,
      "imo": 1234567,
      "vessel_name": "VESSEL NAME"
    }
  ]
}

Сроки на практике

1 порт / 1 месяц

Обычно это десятки минут, если кеш уже прогрет, и дольше, если строим первый раз.

10 портов / 12 месяцев

Чаще всего несколько часов. Это уже batch job, а не быстрый запрос.

Россия-wide / 12 месяцев

Инициирующий прогон может занять ночь или дольше; мы разбиваем его на этапы.

FAQ

Можно ли выбрать порты по стране?

Да. На генерации и в коммерческом расчете мы обычно считаем scope через количество портов в стране или через список портов, который вы передаете.

Что быстрее: история или API?

Первичная история и первая материализация API примерно одинаково тяжелые. После записи в кеш API работает быстрее.

Что если нужен весь портовый контур России за год?

Это большой batch. Мы разбиваем его на части и обычно не запускаем в одну монолитную задачу.

Какие данные попадают в выдачу?

Порт, русское имя порта, время события, IMO, MMSI, имя, тип, флаг, страна, а также дополнительные поля, если они есть в базе.

Можно ли получить документы на юрлицо?

Да. Для B2B возможны счет, договор и закрывающие документы.

Можно ли начать с небольшого объема?

Да. На практике это лучший путь: сначала одна страна или несколько портов, затем расширяем scope.

Контакты

info@goradar.ru
+7 (495) 142 30 50

Юрлицо: ООО «СТЭЛС А»полная карточка реквизитов.