الواجهة مترجمة بالكامل، وكذلك كل صفحة مكتوبة: الدليل والمقالات التعليمية ومقالات البيانات والمدونة. ما يبقى بالفارسية هو ما يأتي من مصدر البيانات نفسه: أسماء المدن والمطارات وشركات الطيران والطائرات، والملاحظات المخزَّنة معها. ستظهر هذه بالفارسية إلى أن توفّر الواجهة البرمجية حقلاً عربياً لها.

API آسمان‌جو العام

كل ما يعرضه هذا الموقع يأتي من نقاط النهاية هذه؛ والصفحات نفسها ليست إلا قارئًا لها. جميعها للقراءة فقط، وجميعها تُعيد JSON إلا حيث كُتب خلاف ذلك، ولا يطلب أي منها مفتاحًا. وجذرها https://asemanjoo.ir .

ما تحصل عليه ليس ملكًا عامًا

استجابة هذه النقاط هي البيانات نفسها التي في ملفات التنزيل وتسري عليها الشروط نفسها: ذكر المصدر، وشرط «المشاركة بالمثل» في ODbL، ومنع إدراج المنشأ/الوجهة في قاعدة بيانات أخرى. صفحة الرخصة يقول بالضبط ما المسموح وما غير المسموح.

حد المعدّل

  • بلا مفتاح120 طلبًا في الدقيقةيُحتسب على أساس شبكة عنوان الإنترنت، لا على أساس المتصفح.
  • بجلسة المستخدم في هذا الموقع نفسه300 طلب في الدقيقةللصفحات التي يقرأها الموقع نفسه خلف حسابك.
  • بمفتاح APIحصة منفصلة لكل مفتاحيُطلَب المفتاح عبر صفحة الاتصال وتُحدَّد حصته هناك؛ وترويسة الطلب هي X-API-Key.

كل استجابة تحمل ثلاث ترويسات X-RateLimit-Limit، X-RateLimit-Remaining و X-RateLimit-Reset موجود؛ وحين تنفد الحصة يكون الرد 429 و Retry-After يقول كم ثانية عليك الانتظار. النافذة دقيقة واحدة وتُحسب من جديد مع بداية كل دقيقة.

الإصدار والاستقرار

  • كل عنوان تحت ‎/api/‎ يستجيب أيضًا ببادئة ‎/api/v1/‎؛ إنه التنفيذ نفسه، فلن يفترق الاثنان أبدًا.
  • حذف عنوان، أو تغيير اسم معامل، أو تبدّل قيمته الافتراضية، كلها مقفلة في ملف اختبار؛ وتغييرها يجب أن يكون متعمَّدًا وقابلًا للمراجعة.
  • تُحفظ استجابة النقاط الثقيلة مدةً ولها ترويسة ETag؛ فإن أرسلت ‎If-None-Match‎ تلقّيت استجابة 304 وبقيت نسختك السابقة صالحة.
  • الطلب عابر النطاقات من المتصفح لا يُقبل إلا من asemanjoo.ir نفسه؛ ولأي استخدام آخر، اقرأ من جهة الخادم.

قبل أن تأخذ رقمًا على محمل الجد

  • «غير معلوم» يعني أننا لا نعرف، ويأتي في استجابة JSON بقيمة فارغة (null) — لا بصفر. والسرعة صفر والارتفاع صفر، حيث لم يقل المرسل شيئًا، هما «غير معلوم» لا «صفر».
  • لكل مبدأ ومقصد رحلة رتبةُ مصدر: 0 يعني لا شيء، 10 يعني جدول رموز النداء في adsbdb، 20 يعني ادعاءً لم يُسجَّل مصدره، 30 يعني الجدول الزمني للرحلات و40 يعني رصدنا نحن على الأرض. الرتبة 10 هي الأضعف: رمز النداء الواحد يطير عدة مسارات في اليوم الواحد وذلك الجدول يحتفظ بمسار واحد لكل رمز نداء.
  • يُحفَظ مسار الرحلات نقطة بنقطة 30 يومًا، وسطر الرحلة نفسه سنة واحدة؛ أما التجميعات اليومية فلا تُمحى. أي أن «لم تكن هناك رحلة» و«لم نعد نحتفظ بها» شيئان مختلفان.
  • تغطيتنا هي تغطية المستقبِلات التطوعية، لا تغطية السماء. حيث لا مستقبِل، لا رحلة — وهذا يظهر في إحصاءات المطارات قليلة المستقبِلات.
  • الالتزام بالمواعيد والوقت المجدول متاحان لأقلية من الرحلات فقط، فهي عيّنة لا إحصاء شامل.

سماء هذه اللحظة

  • /api/flights

    كل رحلة تُرى في هذه اللحظة داخل الإطار المطلوب. الصفوف مصفوفات لا كائنات كي تبقى خفيفة؛ وترتيب الحقول هو ما تقرؤه خريطة الموقع نفسها.

    south, north, west, east, since, limit

  • /api/stats/live

    عدد الرحلات المتتبَّعة الآن — رقم واحد، لمن لا يريد سواه.

  • /api/stats/world

    صورة العالم في هذه اللحظة: أكثر نقاط المغادرة والوجهات والشركات والطُّرز ازدحامًا بين الرحلات في الجو.

  • /api/nearest

    أقرب الرحلات إلى نقطة، مع المسافة بالكيلومترات.

    lat, lon, radius_km, limit, ground

  • /api/overhead

    ما يمرّ فوق نقطة ما — أي سؤال «ما هذه الطائرة التي فوق رأسي».

    lat, lon, radius_km, limit

  • /api/density

    كثافة الحركة في إطار الرؤية، لرسم طبقة الكثافة.

    south, north, west, east, nx, ny

  • /api/top

    الرحلات التي لديها أكبر عدد من الزوّار على هذا الموقع الآن.

  • /api/flights/emergency

    الرحلات التي تبثّ رمز الاستجابة 7500 أو 7600 أو 7700. غالبًا ما تكون القائمة فارغة، وهذا في ذاته جواب.

  • /api/feed/events.rss

    قائمة الطوارئ نفسها بصيغة RSS، لقارئ الأخبار.

رحلة واحدة

  • /api/flight/{flight_id}

    كل شيء عن رحلة واحدة: المعرّف، الهيكل، المسار، الأثر المسجَّل والصور.

    with_trail

  • /api/flight/{flight_id}/live

    الجزء المباشر وحده من الرحلة نفسها، لحين تكون الصفحة مفتوحة ولا تحتاج إلا إلى التحديث.

  • /api/flight/{flight_id}/eta

    الوقت المقدَّر للوصول. هو تقديرنا من السرعة والمسافة، لا إعلان شركة الطيران.

  • /api/flight/{flight_id}/geojson

    أثر الرحلة نفسها بصيغة GeoJSON، لوضعه على أي خريطة أخرى.

  • /api/flight/{flight_id}/playback

    إعادة عرض لأثر الرحلة من مخزننا، نقطةً نقطة.

    max_points

  • /api/flight/{flight_id}/history

    الرحلات السابقة برقم الرحلة نفسه — «متى تهبط هذه الرحلة عادةً».

    limit

  • /api/replay

    إعادة عرض لإطار من الخريطة في مدة زمنية ماضية.

    south, north, west, east, start, minutes, max_flights, stream

  • /api/replay/export

    تصدير إعادة العرض نفسها إلى ملف GeoJSON أو CSV — للتدقيق والبحث، لا فيديو.

    south, north, west, east, start, minutes, max_flights, format

  • /api/replay/airport/{iata}

    إعادة عرض للرحلات التي هبطت في هذا المطار أو أقلعت منه خلال مدة زمنية — والاختيار بحسب الرحلة لا بحسب الإطار الجغرافي، كي لا تسقط من إعادة العرض رحلةٌ تخرج من الإطار.

    start, minutes, max_flights

مطار

  • /api/airports

    قائمة المطارات بالاسم الفارسي والإحداثيات وعدد الحركات.

    fields, format

  • /api/airports.csv

    القائمة نفسها بصيغة CSV، لجدول البيانات.

  • /api/airports/bbox

    المطارات داخل إطار، للخريطة.

    south, north, west, east, limit

  • /api/airports/compare

    مطاران جنبًا إلى جنب، بالأرقام نفسها التي تعرضها صفحة المقارنة.

    a, b, days

  • /api/airports/disruptions

    ترتيب عالمي وإقليمي للمطارات استنادًا إلى مؤشّر لحظي للاضطراب والتأخير وإلغاء الرحلات.

    hours, limit, region

  • /api/airport/{iata}

    مطار واحد: الاسم والإحداثيات والمدارج والطقس والإحصاءات الأخيرة.

  • /api/airport/{iata}/full

    الأجوبة الأربعة أعلاه — المطار، واللوحة، والإحصاءات، والتوقّعات — في طلب واحد.

    kind, days, board_before, board_after, stats_days, radius_km

  • /api/airport/{iata}/board

    لوحة وصول ومغادرة المطار نفسه.

    kind, before, after

  • /api/airport/{iata}/stats

    السلسلة الزمنية لحركة المطار، يومًا بيوم.

    days

  • /api/airport/{iata}/delay

    حالة تأخير المطار، في هذه اللحظة وخلال المدة الأخيرة — مع حالة «غير معروف» الصريحة حين تكون العيّنة قليلة.

    days, hours

  • /api/airport/{iata}/routes

    أكثر وجهات المطار نفسه تكرارًا في المدة الأخيرة.

    days, limit

  • /api/airport/{iata}/ground

    الطائرات التي تُرى في هذه اللحظة على أرض ذلك المطار.

    radius_km, limit

  • /api/airport/{iata}/departures.xml

    تغذية RSS لمغادرات المطار نفسه — لوحة المغادرة ذاتها، للاشتراك بها في قارئ أخبار دون حساب.

  • /api/airport/{iata}/departures.json

    التغذية نفسها بصيغة JSON Feed 1.1، للمستهلك المبرمج.

  • /api/airport/{iata}/trails

    آثار الوصول والمغادرة الأخيرة للمطار نفسه، مكثَّفة وجاهزة للعرض على الخريطة (E-274).

    days

المسار والشركة والطراز والبلد والطائرة

  • /api/routes

    كل المسارات ذات الحركة، صفحة بصفحة بمؤشر مفتاحي (cursor).

    cursor, limit

  • /api/route/{orig}/{dest}

    مسار واحد: عدد الرحلات والهبوطات والهياكل التي تطيره.

  • /api/route/{orig}/{dest}/geojson

    المسار نفسه بصيغة GeoJSON.

  • /api/city/{slug}

    مدينة واحدة: مطاراتها وحركتها المجمَّعة وأكثر الوجهات ازدحامًا.

    days

  • /api/city-pair/{orig}/{dest}

    كل أزواج المطارات بين مدينتين، مجموعة في استجابة واحدة.

    days

  • /api/route/{orig}/{dest}/trails

    الآثار الأخيرة لرحلات هذا المسار نفسه، مكثَّفة وجاهزة للعرض على الخريطة (E-46).

    days

  • /api/route/{orig}/{dest}/path

    المسار المعتاد لهذا الخط، محسوبًا من وسيط المسارات الأخيرة — لا مسار رحلة بعينها (L-90).

    days

  • /api/route/{orig}/{dest}/seasonality

    النمط الموسمي لهذا المسار موزّعًا على أشهر التقويم الشمسي، من سجل stats_daily_route الدائم (L-92).

  • /api/busiest

    أكثر المطارات والمسارات ازدحامًا في الثلاثين يومًا الماضية، في استجابة واحدة.

  • /api/busiest/airports.csv

    ترتيب المطارات نفسه بصيغة CSV.

  • /api/busiest/routes.csv

    ترتيب المسارات نفسه بصيغة CSV.

  • /api/stats/extremes

    أطول المسارات وأقصرها التي رأيناها.

    limit, min_flights

  • /api/airlines

    قائمة شركات الطيران بالاسم الفارسي وعدد الرحلات.

  • /api/airline/{iata}

    شركة طيران واحدة: الأسطول والوجهات وعدد الرحلات.

    days

  • /api/airline/{iata}/history

    إحصاءات الشركة نفسها في مدة تحدّدها أنت.

    start, end

  • /api/types

    قائمة أنواع الطائرات بعدد الرحلات.

  • /api/type/{code}

    نوع طائرة واحد: الهياكل المرصودة وأكثر المسارات استخدامًا.

    days

  • /api/countries

    قائمة البلدان بعدد المطارات وحركة السير.

  • /api/country/{code}

    رحلات بلد ومطاراته.

    days

  • /api/aircraft/{reg}

    هيكل واحد بحسب رقم التسجيل: المواصفات والرحلات الأخيرة.

    days

  • /api/aircraft/{reg}/history

    رحلات الهيكل نفسه في مدة تحدّدها أنت.

    start, end, limit

إحصاءات وتنزيلات

  • /api/stats/daily

    العدد اليومي للرحلات والمسارات والمطارات والطُّرز. مع format=csv يعطي الشيء نفسه بصيغة CSV.

    days, format

  • /api/stats/world/series

    السلسلة الزمنية للعدد العالمي للرحلات، عيّنة كل خمس دقائق — حتى سبعة أيام مضت. الفترة التي لم يأخذ فيها المجمِّع أي عيّنة تبقى فارغة؛ ولا تُستكمَل بأي قيمة بدلًا منها.

    hours

  • /api/download/datasets

    قائمة قابلة للقراءة آليًا بمجموعات البيانات المتاحة للتنزيل: أسماء الأعمدة والعنوان ونص الرخصة لكل منها.

  • /api/download/{dataset}.csv

    إحدى التجميعات اليومية أو السنوية بصيغة CSV، بترويسة تحمل وقت الإنشاء والرخصة داخل الملف نفسه. `days` يحدّ التجميعات اليومية فقط؛ أما السنوية فتعطي كامل المدة المسجَّلة.

    days

بحث

  • /api/search

    بحث واحد يشمل المطارات والشركات والرحلات والمسارات وأرقام التسجيل.

    q

  • /api/search/suggest

    اقتراح قصير أثناء الكتابة.

    q, limit

  • /api/search/advanced

    بحث بمرشّحات مركّبة: الشركة، والطراز، والارتفاع، والسرعة، والمطار.

    airline, aircraft_type, orig, dest, min_alt, max_alt, min_spd, max_spd, ground, limit

  • /api/search/history

    البحث عن رقم رحلة أو رمز نداء أو تسجيل ضمن مدى تاريخي — حتى سنة مضت.

    q, from, to, limit

الطقس والمجال الجوي والمصادر

  • /api/wx/hazard

    تحذيرات أرصاد الطيران (SIGMET/AIRMET) داخل إطار العرض.

    south, north, west, east, limit

  • /api/tfr

    قيود الطيران المؤقتة الأمريكية السارية (TFR) داخل الإطار، مع النوع (رياضي/خطر/أمني/فضائي/VIP/تجمّع مسيّرات/خاص) ونطاق سريانها الزمني.

    south, north, west, east, limit

  • /api/oceanic-tracks

    المسارات المحيطية المنظَّمة السارية في هذه اللحظة (NAT-OTS وPACOTS وAUS-OTS) مع مصدر كل نظام وجملة حالة واحدة.

  • /api/wx/turbulence

    طبقة المطبّات: تقرير الطيار (PIREP، «مُبلَّغ عنه») وقصّ الرياح النموذجي بين مستويين متجاورين («مُقدَّر») داخل إطار العرض — طبقتان فرعيتان منفصلتان.

    south, north, west, east, limit

  • /api/airspace/fir

    حدود مناطق معلومات الطيران (FIR) داخل الإطار.

    south, north, west, east, zoom, limit

  • /api/airspace/at

    في أي منطقة معلومات طيران تقع هذه النقطة.

    lat, lon

  • /api/map/ground

    معينات الملاحة والمدارج داخل الإطار، للطبقة الأرضية من الخريطة.

    south, north, west, east, runways, limit

  • /api/sources

    الحالة المباشرة لمصادر البيانات: أيّها يستجيب وكم حصة كلٍّ منها.

    hours

العمق: الالتزام بالمواعيد وسلامة البيانات وإيران

  • /api/punctuality

    المطارات التي تبلغ عيّنة مغادراتها حدّ النشر الأدنى، مع نافذة البيانات الحقيقية. ولا تُعاد أي نسبة مئوية — البسط والمقام منفصلان، كي لا تصل إلى القارئ حصة بلا عيّنتها.

  • /api/punctuality/{iata}

    الانضباط الزمني لمطار: لوحة اليوم مقابل المتوسط، منحنى الساعة المحلية، ترتيب الشركات، وعدد ما استبعده حدّ العيّنة الأدنى.

  • /api/airport/{iata}/conditions

    تنبؤ المطار (TAF) وتحذيرات المسار النشطة (SIGMET) ضمن نطاقه. منفصل عن صفحة المطار، لأن عمر التحذير ساعات لا ثلاثون يومًا.

    radius_km

  • /api/aircraft/{reg}/activity

    سجلّ ثلاثين يومًا لطائرة واحدة: كم رحلة في كل يوم ومن أي المطارات. واليوم الصفر يعني يومًا نظرنا فيه فلم نرَ شيئًا.

  • /api/aircraft/{reg}/distance

    مجموع المسافة التي رصدها آسمان‌جو من طائرة واحدة — لا مسافة عمر تلك الطائرة. ونطاق الرصد وعدد الأيام غير المجمَّعة يأتيان في الاستجابة نفسها، لأن الرقم لا يُقرأ بدونهما.

  • /api/aircraft/{reg}/utilization

    إنتاجية طائرة واحدة: متوسط ساعات الطيران في اليوم ومتوسط التوقف الأرضي بين رحلتين، خلال المدة المعطاة. والطائرة التي لها رحلات مسجَّلة في أقل من خمسة أيام مختلفة لا تحصل على رقم.

    days

  • /api/airline/{iata}/fleet-utilization

    الإنتاجية نفسها، لكامل أسطول شركة طيران: صف لكل رقم تسجيل، إضافة إلى متوسط الأسطول على ما بلغ منها حدّ العيّنة الأدنى.

    days, limit

  • /api/airline/{iata}/fleet

    الطائرات التي رأيناها لهذه الشركة — لا الأسطول الرسمي — مع ما إذا كانت كل واحدة في الجو الآن أم على الأرض، وإن كانت على الأرض فمتى وأين رُصدت آخر مرة. وأي تسجيل ظلّ متوقفًا طوال المدة ليس في هذه القائمة.

    days, limit

  • /api/airline/{iata}/operated-by

    للرحلات المباعة تحت رمز هذه الشركة: مشغّلها الفعلي حين يختلف عن الشركة نفسها — علامة تأجير رطب. تابع قراءته عبر `/api/operator/{icao}`.

    days

  • /api/operator/{icao}

    المشغّل الفعلي لأسطول بدل بائع التذاكر — بالشكل نفسه لـ `/api/airline/{iata}`، لكن �ستنادًا إلى من شغّل الطائرة فعلًا، لا إلى الرمز الذي بيعت تحته التذكرة.

    days

  • /api/airline/{iata}/fleet-wikidata

    مصدر ثانٍ مستقل للسؤال نفسه: الطائرات التي تعرفها ويكي بيانات (لا مستقبِلاتنا) لهذه الشركة. وهذا أيضًا ليس الأسطول الرسمي — فويكي بيانات تسجّل الطائرات البارزة واحدة واحدة لا الأسطول كاملًا، فالعدّ حدّ أدنى لا حدّ أقصى.

    limit

  • /api/type/{code}/sectors

    ما المسافات التي يقطعها هذا الطراز: الوسيط، والتشتّت، ونطاقات مسافة ثابتة كي يمكن مقارنة طرازين معًا.

  • /api/type/{code}/live

    إحصاء لحظي لهذا الطراز: كم طائرة من هذا الطراز تُرى في السماء الآن — من جدول الخادم المباشر ذاته، لا من عدّ خريطة المتصفح المحدود بسقف الاتصال.

  • /api/emergency/history

    أرشيف رموز الطوارئ (٧٥٠٠/٧٦٠٠/٧٧٠٠) مع بداية التسجيل. ونهاية الحدث تعني أن الطائرة لم تعد ترسل ذلك الرمز — ولا تقول شيئًا عن مصيرها.

  • /api/digest/today

    ملخّص اليوم منذ منتصف الليل في طهران: عدد الرحلات، وأكثر المسارات ازدحامًا، وأطول وأقصر رحلة مرصودة، ورموز الطوارئ اليوم. قد يكون أي قسم فارغًا — أي أننا لم نلتقط شيئًا اليوم، لا أن الاستعلام أخفق.

  • /api/data-health

    ما يعرفه الموقع عن نفسه: نسبة الرحلات التي لها مسار وارتفاع وتسجيل، وتوافر المجمِّع، ونصيب كل مصدر. «لم يُقَس» و«سليم» جوابان مختلفان.

    days

  • /api/iran/today

    سماء إيران من منتصف الليل بتوقيت طهران حتى هذه اللحظة. ما رأيناه، لا ما طار — التغطية ليست متجانسة.

  • /api/iran/airports

    مطارات إيران مع المدرج والارتفاع ومعينات الملاحة. أعمدة المرجع مفصولة عن عمود ما رُصد.

  • /api/iran/network

    أزواج المدن الداخلية مرتَّبة بحسب الرحلات المرصودة، والاتجاهان يُحسبان واحدًا. يُعاد كلٌّ من الحدّ الأدنى للعيّنة وما استبعده.

  • /api/iran/fleet

    الطائرات المسجّلة في إيران التي رأيناها. «لم تُرصد» تعني أننا لم نسمعها؛ ولا يُستنتج من ذلك توقّفها على الأرض.

القياسات الخام للأسطول: الرياح، وسلامة تحديد الموقع، والنيّة

  • /api/wx/wind

    رياح وحرارة قاستها الطائرات نفسها، خليةً خليةً بدرجة واحدة — لا تنبّؤ. وتعود ثلاثة أرقام منفصلة للريح: الاتجاه المتّجهي (متوسط ٣٥٠ و٠١٠ درجة هو ٠٠٠ لا ١٨٠)، والسرعة العددية، وطول المتّجه الذي يقول كم كانت الريح منتظمة. والخلية التي لم يقس فيها أحد ريحًا هي «غير معروفة» لا «هادئة».

    south, north, west, east, band, hours, min_wind, limit

  • /api/gnss/integrity

    حيث أبلغت الطائرات عن فقدان موقعها الساتلي، على شبكة بنصف درجة. كل عدّ يأتي بمقامه الخاص؛ خانة بقراءات صفر ليس لها معدّل وليست سماءً صافية، بل هي عمانا. تقول coverage كم ساعة من التاريخ في هذا الجدول أصلًا.

    south, north, west, east, hours, min_readings, limit

  • /api/gnss/integrity/series

    الأرقام نفسها، ساعة بساعة بدل خانة بخانة. الساعة التي لم تكن فيها رحلة داخل الإطار لا صف لها أصلًا — هي فراغ، لا حفرة صفر؛ وملؤها يرسم انقطاع المجمِّع على أنه تحسّن مفاجئ في السماء.

    south, north, west, east, hours

  • /api/flight/{flight_id}/intent

    الارتفاع والرمز الذي اختاره الطيار على امتداد رحلة واحدة، سطر لكل تغيير. الرحلة غير الموجودة تحصل على 404 والرحلة الموجودة بلا أحداث تحصل على قائمة فارغة — كي لا يختلط «لم نسمع شيئًا» بـ«لا توجد رحلة كهذه».

    limit

  • /api/airport/{iata}/stand

    أقرب موقف مرسوم على الخريطة إلى نقطة على الأرض. هو تقدير لا تخصيص: لا مصدر يقول على أي موقف تقف الطائرة. وخارج نصف القطر تكون الإجابة null، لا أقرب موقف في أي مكان. الهندسة من OpenStreetMap وبموجب ODbL.

    lat, lon, max_m

  • /api/airport/{iata}/stand/by-ref

    موقع موقف الطائرة من رقم البوابة أو الموقف المكتوب في جدول الرحلة. هي مطابقة اسم لا تخمين مسافة؛ وغياب المطابقة الدقيقة يعني أن stand يساوي null، لا أقرب موقف. الهندسة من OpenStreetMap وبموجب ODbL.

    ref

  • /api/military

    الرحلات التي صنّفتها قاعدة بيانات الهياكل في شبكة المستقبِلات على أنها عسكرية. هذا تصنيف المصدر الأعلى، لا حكم آسمان‌جو، وهو غير مدموج مع تخمين رمز النداء وبادئة طراز الطائرة في مرشِّح الخريطة. وهو عالمي وبلا أي مرشِّح جغرافي. والعمود الفارغ يعني «غير معروف» لا صفرًا — والمسار غير المعروف أمر عادي في هذه القائمة. [[E-284]]: يحمل كل صف إضافةً إلى ذلك block_country وblock_military — إشارة مستقلة مستمدة من مجال عنوان ICAO ذي الأربعة والعشرين بت، منفصلة عن العمود الرئيسي وبلا دمج؛ ويشرحها block_basis.

    days, limit

  • /api/coverage/grid

    خريطة تغطية رصدنا نحن: كل خلية 5×5 درجات مع عدد السجلات المسجَّلة وعدد الطائرات الفريدة ووسم «بلا تغطية/عيّنة قليلة/عيّنة كثيفة». والخلية التي لا سجل لها في هذه المدة هي «بلا تغطية» لا «بلا حركة» — فغياب المستقبِل وغياب الرحلة لا يمكن تمييزهما، وهذا الاستعلام لا يعدّهما شيئًا واحدًا. وsparsest يسمّي أقل عشر خلايا عيّنةً.

    hours

إصدار API

  • /api/versions

    الإصدارات التي تستجيب لها هذه الخدمة، وأيها الإصدار الجاري، وتاريخ إهمال كل منها أو انتهاء الاستجابة له (وحتى يُحدَّد، null). والعميل الذي لا يُحدَّث مع الخدمة ينبغي أن ينادي تحت بادئة الإصدار الجاري نفسها: تحت /api/v1/ تُضاف الحقول، لكنها لا تُحذف ولا يتغيّر نوعها. والمسار بلا بادئة هو التطبيق نفسه لكنه لا يحمل هذا الالتزام، وهو مُعلَّم في هذه الاستجابة بـ stable: false.

ما لم يُوثَّق عمدًا

هذه العناوين تستجيب أيضًا، لكنها ليست واجهة عامة: فهي إما استقصاء تشغيلي، وإما أن استجابتها مرتبطة بجلستك، وإما أن صيغتها تخصّ خريطتنا نحن وتتغيّر معها. لا تبنِ عليها شيئًا.

  • /api/healthفحص تشغيلي؛ لمراقبة الخدمة لا للبيانات.
  • /api/health/liveفحص حياة الحاوية.
  • /api/health/readyفحص الجاهزية لموازن الحمل.
  • /api/health/deepفحص عميق للاعتماديات؛ مكلف ومكتوب للمشغّل.
  • /api/status-historyفحص تشغيلي؛ هو سجل توافر الخدمة نفسها (H-35)، لا بيانات عن الرحلات — خلف /status، مثل /api/health.
  • /api/ops/metricsمقاييس Prometheus، للمراقبة.
  • /api/noticeرسالة الموقع العامة؛ محتواها قرارنا نحن، لا بيانات.
  • /api/color-themeإعدادات السمة وألوان واجهة مستخدم الخريطة؛ وهي لواجهة الموقع الأمامية، لا للبيانات.
  • /api/paletteالطلاء الافتراضي للواجهة الذي اختاره المشغّل؛ وهو مثل /api/color-theme قرار مظهري خاص بالموقع نفسه، لا بيانات عن الرحلات.
  • /api/content/{slug}الكتلة النصية لصفحة ثابتة (K-29)؛ وهي للدمج في الصفحة نفسها التي تقرأ هذا الـ slug فقط، لا بيانات مستقلة.
  • /api/glossaryإضافات اللوحة وتصحيحاتها على المعجم الثابت (K-30)؛ وهي للدمج من جهة الخادم في `/glossary` فقط.
  • /api/faqالأسئلة المضافة من اللوحة (K-31)؛ وهي للدمج من جانب الخادم في `/faq` فقط.
  • /api/marksتعتمد استجابته على جلسة المستخدم المسجَّل، ولا معنى لها لغيره.
  • /api/streamبثّ SSE لخريطتنا نحن؛ شكل صفوفه يتغيّر مع الخريطة ولم نَعِد بثباته.
  • /api/sitemapمصنوع لمحرّكات البحث.
  • /api/sitemap/{name}الشيء نفسه، قسمًا قسمًا.
  • /api/public/coverage/gridانعكاس لـ `/api/coverage/grid` نفسه ضمن المجموعة الفرعية المُصدَّرة والموثّقة علنًا (G-143) — وشرحه في «/api-docs» لا هنا، كي لا تُشرح بيانة واحدة مرتين.
  • /api/public/sourcesانعكاس لـ `/api/sources` نفسه ضمن المجموعة الفرعية العامة نفسها — والشرح في «/api-docs».
  • /api/public/openapi.jsonوثيقة OpenAPI للمجموعة الفرعية العامة نفسها؛ هي بنية لا بيانات.
  • /api/public/docsواجهة Swagger UI للوثيقة نفسها؛ إنها صفحة، لا بيانات.

ملف، بدل السؤال

إن أردت تجميعًا جاهزًا لا استعلامًا حيًّا، صفحة التنزيل يعطي البيانات نفسها بصيغة CSV ويقول ما الذي حجبناه عمدًا. وقائمة المصادر العليا في صفحة مصادر البيانات .