API קרבה להתרעות אוויר Online
Air-raid alerts and airborne objects near ONE border crossing. Anchor on a checkpoint (ppid), a coordinate pair or a city and get back only what is inside your radius (default 100 km): which regions are under alert, how far each is, and how close any tracked object currently is on a 1-5 proximity band. Regions are returned as ISO 3166-2 region_code, the same classifier the regional fuel data uses. DELIBERATELY NOT REAL-TIME: every response is a snapshot 1-3 minutes old with the lag re-randomised per request and stated in as_of/lag_min, and object coordinates are never returned - only distance, bearing and speed relative to your anchor. Source data is crowd/OSINT-derived and partly hand-moderated: a signal, never ground truth, and never a substitute for official air-raid warnings.
GET https://nakordoni.eu/api/v2/data/air-alerts
— מחלקת מכסה: cheap
| פרמטר | תיאור |
|---|---|
ppid | מזהה מעבר הגבול שאליו מעוגנת הבקשה, למשל id_94 — אתרו אותו באמצעות API מדריך מעברי הגבול. חלופה ל-lat/lon. |
lat | קו הרוחב של נקודת העוגן (חלופה ל-ppid) |
lon | קו האורך של נקודת העוגן (חלופה ל-ppid) |
city | שם העיר — חלופה ל-lat/lon, מומר לקואורדינטות |
country | קוד מדינה ISO-2, מבהיר את זהות העיר |
radius_km | רדיוס החיפוש בק"מ סביב נקודת העוגן (ברירת מחדל 100, מינימום 10, מקסימום 300). רצועת הקרבה 1-5 מותאמת לרדיוס זה: 5 = החמישית הקרובה ביותר, 1 = החמישית החיצונית ביותר. |
lang | קוד שפה (ברירת מחדל en) |
שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.
| שדה | תיאור |
|---|---|
data.anchor | What the radius was measured from: ppid, lat, lng, radius_km. |
data.as_of | Snapshot time — DELIBERATELY not real-time. lag_min states the delay, re-randomised per request, and lag_note explains it. |
data.alerts.count | Regions under alert inside the radius, with region_codes (ISO 3166-2) and items — each with its distance from the anchor. |
data.alerts.unresolved | Alerts that could not be placed on a region, with merged — how many overlapping ones were combined. |
data.targets.count | Tracked objects inside the radius, with items — distance, bearing, speed and a 1-5 proximity band ONLY. Coordinates are never returned. |
data.targets.by_type | Counts per object type, with tracked_total across the whole feed. |
data.attribution | Source labels you must display, with a note per source. |
data.labels | Localised UI strings, including the disclaimer — crowd/OSINT data, never a substitute for official air-raid warnings. |
curl "https://nakordoni.eu/api/v2/data/air-alerts?ppid=id_94&radius_km=100" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
עודכן