action corrently_gsi_dispatch {
  label: "Dispatch (Green Energy Distribution Schedule)"
  description: "Dispatch of green energy has two aspects to consider:\n  - Availability of gerneration facility (depends on weather and installed capacity)\n  - Demand of energy\nUsing the green power index (GrünstromIndex) we have received a tool to automate distribution of energy in order to prevent redispatch situations. Doing this alows to opimize resource usage (tactical) and leverage data for investment planning (strategic).\n"
  provider: corrently
  method: GET
  path: "/gsi/dispatch"
  encoding: json
  input: {
    type: "object"
    properties: {
      key: {
        type: "string"
      }
      zip: {
        type: "string"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      avg_distance_km: {
        type: "number"
        description: "Averaged geospatial distance in kilometers between energy generation and usage at requested location."
      }
      dispatch_from: {
        type: "array"
        description: "List of current sources of green energy (into requested location)"
        items: {
          type: "object"
          properties: {
            energy: {
              type: "number"
              description: "Percentage of energy"
            }
            location: {
              type: "object"
              description: "GeoJSON encoded location of target or source of green energy."
            }
          }
        }
      }
      dispatch_target: {
        type: "array"
        description: "List of current targets of green energy (out of requested location)"
        items: {
          type: "object"
          additionalProperties: true
        }
      }
      postmix: {
        type: "object"
        description: "Green Energy Mix after dispatch of given city"
      }
      premix: {
        type: "object"
        description: "Green Energy Mix prior to dispatch of given city"
      }
      timeframe: {
        type: "object"
        description: "Evaluated timeframe for this request"
        properties: {
          end: {
            type: "integer"
            description: "Ending time of window evaluated for this request/dispatches."
          }
          start: {
            type: "integer"
            description: "Starting time of window evaluated in order to get dispatches"
          }
        }
      }
    }
  }
}