Method: getRegions

الحصول على توقّعات مسارات التكاثف على شكل مناطق مضلّعات

إذا كانت الاستجابة ناجحة، سيكون الردّ عبارة عن GeoJSON يحتوي على FeatureCollection بالشكل التالي:

{
  "type": "FeatureCollection",
  "features": [
      {
        "type": "Feature",
        "properties": {
            "time": "<ISO 8601 datetime>",
            "flightLevel": <int>,
            "threshold": <int>,
            "forecast_reference_time": "<ISO 8601 datetime>"
        },
        "geometry": {
          "type": "MultiPolygon",
          "coordinates": [...]
        }
      }
  ]
}

يتم تقديم مستويات الطيران بالمتر المكعب بقيم تتراوح بين 270 و440 متر مكعب. يتم تقديم مستويات الخطورة كعدد صحيح يتراوح بين 1 و4. وكلما ارتفعت القيمة، زادت شدة مسار التكاثف.

طلب HTTP

GET https://contrails.googleapis.com/v2/regions

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات طلب البحث

المعلمات
time

string

مطلوب. وقت الطلب [int: epoch unix؛ str: ISO 8601]

flightLevel[]

integer

اختياريّ. مستويات الطيران بالمتر تتراوح القيم الصالحة بين 270 و440 (شاملة).

threshold

integer

اختياريّ. الحد الأدنى لمستوى الخطورة تتراوح القيم الصالحة بين 1 و4 (شاملة). يؤدي ضبط هذا الحقل إلى عرض المناطق التي تكون خطورتها أكبر من أو تساوي الحدّ الأدنى فقط.

aircraftClass

string

اختياريّ. فئة الطائرة لا تتوفّر حاليًا سوى القيمة "default".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، تكون استجابة HTTP عامة يتم تحديد تنسيقها من خلال الطريقة.