Method: getRegions

取得 contrail 預測結果,並以多邊形區域呈現。

如果成功,回應會是 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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
time

string

必要欄位。要求時間 [int: Unix 紀元;str: ISO 8601]

flightLevel[]

integer

選用設定。飛行高度 (公尺)。有效值介於 270 到 440 之間 (含 270 和 440)。

threshold

integer

選用設定。最低嚴重性門檻。有效值介於 1 到 4 (含首尾)。設定這個欄位後,系統只會傳回嚴重程度大於或等於閾值的區域。

aircraftClass

string

選用設定。飛機類別。目前僅支援「預設」選項。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應會是一般 HTTP 回應,其格式由方法定義。