Developer

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

Тема

Цвет акцента

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

Войти

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

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

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

Гайд · Node.js 18+

Оповещение о землетрясении до волны

Satelit сам обнаруживает глубокие землетрясения Вранчи в первые секунды. Волне, которая трясёт, нужно около минуты до Кишинёва. В этом промежутке вебхук earthquake.early приходит на ваш сервер. Проверено на 84 реальных землетрясениях с 2014 года: все с магнитудой 5 и больше получили оповещение через 17–24 секунды после начала, то есть за 35–44 секунды до волны S в Кишинёве.

Работает на
Node.js 18+
Один запуск
0 кредитов
В месяц
0 кредитов
Настройка
15 мин
$ CITY=chisinau MIN_INTENSITY=3 PORT=8080 node quake_alert.mjsEARTHQUAKE ALERT: Vrancea, M 5.5 (estimate, +-0.28). S wave in chisinau in 44 s, estimated intensity IV.

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

  1. Добавьте адрес своего сервера в панели с событиями earthquake.early и earthquake. Для первого нужен план Pro или выше.
  2. Скрипт проверяет подпись из Satelit-Signature и отвечает 200 раньше всего остального.
  3. Берёт ваш город из data.moldova и считает оставшиеся секунды по s_wave_at, а не по моменту отправки.
  4. Сразу сообщает в канал, затем ещё раз при stage: 2, с лучшей оценкой. Локализованное землетрясение приходит как earthquake.

Сколько стоит: Вебхуки не расходуют кредиты. earthquake.early доступен на планах Pro, Business и Enterprise; earthquake, после локализации, на любом плане с вебхуками. На плане Start вебхуков нет.

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

bash
export SATELIT_WEBHOOK_SECRET=whsec_...
export TELEGRAM_TOKEN=... TELEGRAM_CHAT=@canalul_tau
CITY=chisinau MIN_INTENSITY=3 PORT=8080 node quake_alert.mjs

Что выводит

stdout
EARTHQUAKE ALERT: Vrancea, M 5.5 (estimate, +-0.28). S wave in chisinau in 44 s, estimated intensity IV.

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

quake_alert.mjs
#!/usr/bin/env node
// Receives earthquake.early from Satelit (Pro, Business, Enterprise): a deep Vrancea earthquake seen about 20 seconds
// after it starts, tens of seconds before its S wave reaches Moldova. Checks the signature, works out the seconds left
// for your town and tells your channel at once. The located earthquake follows as `earthquake`.
//   SATELIT_WEBHOOK_SECRET=... CITY=chisinau MIN_INTENSITY=3 PORT=8080 node quake_alert.mjs
//   TELEGRAM_TOKEN=... TELEGRAM_CHAT=@your_channel   (without them the alert is printed)
// Put it behind HTTPS and add the address in the dashboard with the events earthquake.early and earthquake.
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 CITY = process.env.CITY ?? "chisinau";
const MIN_INTENSITY = Number(process.env.MIN_INTENSITY ?? 3);
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;
  // no waiting on Telegram's answer: every second counts, and a failed post must not stop the next alert
  fetch(`https://api.telegram.org/bot${TELEGRAM_TOKEN}/sendMessage`, {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify({ chat_id: TELEGRAM_CHAT, text }),
  }).catch((e) => console.error(`telegram: ${e.message}`));
}

function early(data) {
  const town = data.moldova.find((t) => t.key === CITY) ?? data.strongest;
  if (town.intensity_estimate < MIN_INTENSITY) return;
  // the seconds left now, from the wave's own arrival time: the event took a moment to reach us
  const left = Math.max(0, Math.round((new Date(town.s_wave_at) - Date.now()) / 1000));
  const head = data.stage === 1 ? "EARTHQUAKE ALERT" : "Earthquake alert, updated";
  tell(`${head}: Vrancea, M ${data.magnitude_estimate} (estimate, +-${data.magnitude_sd}). ` +
    `S wave in ${town.key} in ${left} s, estimated intensity ${town.intensity_roman}. Preliminary. ${data.attribution}`);
}

function located(data) {
  tell(`Earthquake located: M ${data.magnitude} ${data.region}, depth ${data.depth_km} km. ` +
    `Estimated in ${data.moldova.strongest_in_name}: ${data.moldova.intensity_roman}. ${data.url}`);
}

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 === "earthquake.early") early(event.data);
    else if (event.type === "earthquake") located(event.data);
  });
});
server.listen(Number(process.env.PORT ?? 8080), () => console.log(`listening on ${server.address().port}`));

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

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

Обновлено:

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

Насколько рано приходит оповещение?

Примерно через 20 секунд после начала глубокого землетрясения во Вранче. Волна S доходит до Кагула примерно за 46 секунд, до Кишинёва за 57–66, так что остаётся около 24 и 35–44 секунд.

Насколько точна магнитуда в оповещении?

Это оценка по первым секундам землетрясения со стандартным отклонением 0,24–0,28. Выше магнитуды 6 это нижняя граница: первые секунды сильного землетрясения не показывают всей его величины. Поле preliminary всегда true.

О каких землетрясениях раннего оповещения нет?

О тех, что не глубокие и не из Вранчи: коровое землетрясение или толчок из другой зоны приходит только как earthquake, после локализации. Это не официальная система предупреждения.