Method: getRegions

• HTTP request
• Query parameters
• Request body
• Response body

Get contrail prediction as polygon regions.

If successful, the response will be a GeoJSON containing a FeatureCollection with the following format:

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

Flight levels are given in hectofeet with values between 270 and 440 inclusive. Severity levels are given as an integer between 1 and 4 inclusive. The higher the value, the more severe the contrail.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
time	string Required. Time of request [int: unix epoch; str: ISO 8601]
flightLevel[]	integer Optional. Flight levels in hectofeet. Valid values range from 270 to 440 (inclusive).
threshold	integer Optional. Minimum severity level threshold. Valid values range from 1 to 4 (inclusive). Setting this field returns only regions with severity >= threshold.
aircraftClass	string Optional. Aircraft class. Currently only 'default' is supported.

Request body

The request body must be empty.

Response body

If successful, the response is a generic HTTP response whose format is defined by the method.