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.