Developer

Язык: Русский
Оформление

Тема

Цвет акцента

Тема и цвет сохранятся на satelit.md и в приложении.

Войти

Где сменить тему?

Выберите, где применить новую тему.

Изменить можно в любой момент в шапке.

Гайд · Node.js 18+

Оповещение о дроне для вашего города

Satelit следит за дронами до 300 км от границы Молдовы и оценивает их путь на 30 минут вперёд. Зоны задаёте вы: город с радиусом, точку или всю страну. Когда дрон в зоне или долетит до неё за ваши минуты, вебхук drone.zone приходит на ваш сервер, один раз на дрон.

Работает на
Node.js 18+
Один запуск
0 кредитов
В месяц
0 кредитов
Настройка
15 мин
$ PORT=8080 node drone_alert.mjsDRONE ALERT: A drone may reach chisinau (30 km) in about 12 min, near Ocnița, heading S at 180 km/h.

Как это работает

  1. Добавьте адрес сервера в панели с событиями drone.zone, drone.entered и drone.ended и свои зоны, например {"city": "chisinau", "radius_km": 30, "lead_min": 15}.
  2. Скрипт проверяет подпись в Satelit-Signature, отвечает 200 и пропускает повтор с тем же id.
  3. В drone.zone поле data.eta_min говорит, через сколько минут прилетит дрон; 0 значит, что он уже в зоне. data.zone называет зону.
  4. Скрипт сразу пишет в канал место, курс и скорость. drone.ended сообщает, что дрона больше нет.

Сколько стоит: Вебхуки не тратят кредиты. Зоны есть на тарифах с вебхуками: 3 на Creator, 20 на Pro, 100 на Business. На тарифе Start вебхуков нет.

Как запустить

bash
export SATELIT_WEBHOOK_SECRET=whsec_...
export TELEGRAM_TOKEN=... TELEGRAM_CHAT=@canalul_tau
PORT=8080 node drone_alert.mjs

Что выводит

stdout
DRONE ALERT: A drone may reach chisinau (30 km) in about 12 min, near Ocnița, heading S at 180 km/h.

Полный скрипт

drone_alert.mjs
#!/usr/bin/env node
// Receives Satelit's drone watch (any plan with webhooks): drone.zone when a drone is in one of your zones or on its way
// there, drone.entered when one is inside Moldova, drone.ended when it is gone. Checks the signature, tells your channel once
// per drone and stage, and edits nothing else. Your zones are set in the dashboard on the address, for example
//   [{"city": "chisinau", "radius_km": 30, "lead_min": 15}, {"lat": 47.76, "lon": 27.93, "radius_km": 20, "lead_min": 10}]
//   SATELIT_WEBHOOK_SECRET=... PORT=8080 node drone_alert.mjs
//   TELEGRAM_TOKEN=... TELEGRAM_CHAT=@your_channel   (without them the alert is printed)
// Put it behind HTTPS and add the address with the events drone.zone, drone.entered and drone.ended.
import { createHmac, timingSafeEqual } from "node:crypto";
import { createServer } from "node:http";

const SECRET = process.env.SATELIT_WEBHOOK_SECRET;
if (!SECRET) throw new Error("Set SATELIT_WEBHOOK_SECRET");
const { TELEGRAM_TOKEN, TELEGRAM_CHAT } = process.env;
const seen = new Set();

function verified(rawBody, header = "") {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const t = Number(parts.t);
  if (!t || Math.abs(Date.now() / 1000 - t) > 300) return false;
  const expected = Buffer.from(createHmac("sha256", SECRET).update(`${t}.${rawBody}`).digest("hex"));
  const given = Buffer.from(parts.v1 ?? "");
  return expected.length === given.length && timingSafeEqual(expected, given);
}

async function tell(text) {
  console.log(text);
  if (!TELEGRAM_TOKEN || !TELEGRAM_CHAT) return;
  fetch(`https://api.telegram.org/bot${TELEGRAM_TOKEN}/sendMessage`, {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ chat_id: TELEGRAM_CHAT, text, disable_web_page_preview: true }),
  }).catch((e) => console.error(`telegram: ${e.message}`));
}

// the zone in words: a town and its radius, a point, or the whole country
const zoneName = (z) => (z.moldova ? "Moldova" : z.city ? `${z.city} (${z.radius_km} km)` : `${z.lat}, ${z.lon} (${z.radius_km} km)`);
const where = (d) => `near ${d.last_reported?.near ?? "an unknown place"}, heading ${d.heading ?? "?"} at ${d.speed_kmh ?? "?"} km/h`;
const count = (d) => (d.count > 1 ? `${d.count} drones` : "A drone");

function zone(d) {
  const is = d.count > 1 ? "are" : "is";
  const what = d.eta_min === 0 ? `${is} in ${zoneName(d.zone)}` : `may reach ${zoneName(d.zone)} in about ${d.eta_min} min`;
  tell(`DRONE ALERT: ${count(d)} ${what}, ${where(d)}. Estimate, preliminary. ${d.url ?? ""}`.trim());
}

function entered(d) {
  const town = d.moldova?.towns?.[0];
  tell(`DRONE IN MOLDOVA: ${count(d)} ${where(d)}${town ? `, ${town.km} km from ${town.name}` : ""}. Follow the authorities' instructions. ${d.url ?? ""}`.trim());
}

function ended(d) {
  tell(`Drone track ended (${d.status}): ${d.last_reported?.near ?? "last place unknown"}.`);
}

const server = createServer((req, res) => {
  const chunks = [];
  req.on("data", (c) => chunks.push(c));
  req.on("end", () => {
    const raw = Buffer.concat(chunks).toString("utf8");
    if (!verified(raw, req.headers["satelit-signature"])) {
      res.writeHead(401).end();
      return;
    }
    const event = JSON.parse(raw);
    res.writeHead(200).end(); // answer first: Satelit does not wait for your work
    if (seen.has(event.id)) return; // a retry of what we already handled
    seen.add(event.id);
    if (event.type === "drone.zone") zone(event.data);
    else if (event.type === "drone.entered") entered(event.data);
    else if (event.type === "drone.ended") ended(event.data);
  });
});
server.listen(Number(process.env.PORT ?? 8080), () => console.log(`listening on ${server.address().port}`));

Используемые маршруты

Данные в гайде

Обновлено:

Вопросы об этом гайде

Насколько точна позиция дрона?

Это оценка по открытым сообщениям, погрешность указана в position.accuracy_km. Путь в ahead вероятный, не точный. Поле preliminary всегда true.

Можно следить за несколькими городами?

Да, у каждого адреса до 20 зон: города с радиусом, точки с радиусом или {"moldova": true}. Каждый дрон приходит один раз на зону.

Это официальная система оповещения?

Нет. Это оценки Satelit. Всегда следуйте указаниям властей; официальные инциденты приходят отдельно, как drone.incident.