بازیابی تشخیص‌ها

GET https://contrails.googleapis.com/v2/detections : ردیابی ردپاها را با فرمت GeoJSON LineString دریافت کنید.

در صورت موفقیت، پاسخ یک FeatureCollection با فرمت GeoJSON خواهد بود. توجه داشته باشید که اگر محدوده زمانی خارج از محدوده باشد (مثلاً جستجوی ردپای شناسایی‌شده در آینده)، می‌توان یک FeatureCollection خالی برگرداند. علاوه بر این، تضمینی وجود ندارد که تشخیص‌ها سازگار باشند زیرا مدل‌های تشخیص به‌روزرسانی می‌شوند و داده‌ها دوباره پر می‌شوند.

پارامترهای پرس و جو

پارامترها
start_time

string

الزامی. زمان شروع درخواست.

قالب: رشته تاریخ و زمان ISO 8601

مثال: 2026-01-20T21:00:00Z

end_time

string

الزامی. زمان پایان درخواست (شامل). توجه داشته باشید که end_time نمی‌تواند بیش از ۲۴ ساعت از start_time بیشتر باشد.

قالب: رشته تاریخ و زمان ISO 8601

مثال: 2026-01-20T22:00:00Z

satellite_origins[]

string

اختیاری. مقادیر معتبر عبارتند از GOES-EAST-FULL-DISK ، HIMAWARI-FULL-DISK و MTG-000-FULL-DISK که به ترتیب نشان‌دهنده ماهواره‌های GOES_EAST، Himawari و MTG هستند.

در صورت ارائه، این نقطه پایانی فقط ردپاهای شناسایی‌شده از ماهواره‌های مشخص‌شده در satellite_origins را برمی‌گرداند.

در صورت عدم ارائه، ردپاهای شناسایی‌شده از همه ارائه‌دهندگان داده‌های ماهواره‌ای مربوطه را برمی‌گرداند.

قالب: آرایه رشته‌ای

مثال: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

مثال‌ها

  • برای بازیابی تمام ردیابی‌های ردپا برای یک نقطه زمانی خاص:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections",
  params={"start_time": "2026-01-27T12:00:00Z",
          "end_time": "2026-01-27T12:10:00Z"},
  headers={"x-goog-api-key": API_KEY},
)

  • برای بازیابی ردیابی ردپاها برای یک نقطه زمانی خاص، محدود به ردیابی‌های هیماواری:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections",
  params={"start_time": "2026-01-27T12:00:00Z",
          "end_time": "2026-01-27T12:10:00Z",
          "satellite_origins": ["HIMAWARI-FULL-DISK"]}
  headers={"x-goog-api-key": API_KEY},
)

    یا در CURL:

    curl "https://contrails.sandbox.googleapis.com/v2/detections?\
key=API_KEY&\
start_time=2026-01-27T12:00:00Z&\
end_time=2026-01-27T12:10:00Z&\
satellite_origins=HIMAWARI-FULL-DISK"

یک پاسخ موفق با ردهای شناسایی‌شده چیزی شبیه به این خواهد بود:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            105.36386108398438,
            -1.7198446989059448
          ],
          [
            105.7318115234375,
            -2.5787696838378906
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}