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

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

در صورت موفقیت، پاسخ یک FeatureCollection با فرمت GeoJSON خواهد بود.

مختصات برگشتی، طول و عرض جغرافیایی نقاط انتهایی تشخیص خطی شده هستند که از منظر ماهواره بر روی سطح زمین تصویر می‌شوند. برای تشخیص‌های GOES، مختصات برگشتی به صورت اختیاری شامل مقادیر ارتفاع تخمینی نیز می‌شوند.

جستجوی تشخیص‌هایی با محدوده زمانی خارج از محدوده، مانند یک زمان مشخص که در آینده است، یک 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

Optional. Valid values are GOES-EAST-FULL-DISK , HIMAWARI-FULL-DISK , and MTG-000-FULL-DISK , representing the GOES_EAST, Himawari and MTG satellites, respectively.

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

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

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

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

bounds[]

string

اختیاری. فهرستی از جفت‌های رشته‌ای، که هر کدام باید در قالب "عرض جغرافیایی، طول جغرافیایی" باشند و رئوس یک چندضلعی محصورکننده را مشخص کنند.

در صورت وجود، حداقل سه bounds باید مشخص شود. مرزها باید یک چندضلعی معتبر تشکیل دهند (مثلاً بدون رأس تکراری، بدون تقاطع خودبه‌خودی)

در صورت وجود، این نقطه پایانی فقط ردپاهای شناسایی‌شده‌ای را برمی‌گرداند که با هر بخشی از چندضلعی مرزی تلاقی می‌کنند.

وقتی ردپاها وجود نداشته باشند، صرف نظر از موقعیت مکانی، ردپاهای شناسایی شده را برمی‌گرداند.

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

مثال: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

مثال‌ها

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

    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",
          "bounds": ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]},
  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.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"

    پاسخ GeoJSON برای این درخواست، داده‌های شناسایی ردپا از ماهواره‌های هیماواری را برای محدوده زمانی درخواستی فهرست می‌کند:

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-01-27T12: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-01-27T12:10:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}