action meteosource_map_map_get {
  label: "Returns PNG weather map for given area and variable"
  description: "## PNG weather forecast maps for given area and variable\n\n### Area specification\nThere are two ways to specify geographical area you need for your map:\n1. Specify `X` and `Y` coordinates and zoom level `Z` of desired tile in <a href=\"https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection/\" rel=\"nofollow\" target=\"_blank\">Google Maps Tile notation</a>.\n2. Specify latitude and longitude bounds of the area you want to cover.\n\n### Notes\n* The resulting PNG maps are **always** in <a href=\"https://epsg.io/3857\" rel=\"nofollow\" target=\"_blank\">Google Mercator projection (EPSG:3857)</a>.\n* As Meteosource only covers areas between latitudes 80° and -80°, you can only request maps within these bounds, when specifying the latitude and longitude boundaries. When specifying the area using Google Maps Tile notation, the regions outside our supported latitudes will be fully transparent.\n* The finest resolution is not available for maps covering very large regions. The resulting map will be automatically downscaled in this case, to guarantee high-speed responses.\n* Weather maps are only supported for forecasts, not for archive data.\n"
  provider: meteosource
  method: GET
  path: "/map"
  encoding: json
  input: {
    type: "object"
    properties: {
      datetime: {
        type: "string"
        description: "There are two ways to specify date and time for your map:\n\n1. Datetime in `YYYY-MM-DDTHH:MM` format and `UTC` timezone, e.g. `2021-08-24T12:00`\n2. Offset from current time in `[+-]<minutes|hours|days>` format, e.g. `+10minutes`, `-2hours` or `+1days`\n"
      }
      key: {
        type: "string"
        description: "Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header."
      }
      max_lat: {
        type: "string"
        description: "Maximal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2.\n"
      }
      max_lon: {
        type: "string"
        description: "Maximal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2\n"
      }
      min_lat: {
        type: "string"
        description: "Minimal latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.2\n"
      }
      min_lon: {
        type: "string"
        description: "Minimal longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.2\n"
      }
      tile_x: {
        type: "integer"
        description: "The X coordinate of Google Maps tile"
      }
      tile_y: {
        type: "integer"
        description: "The Y coordinate of Google Maps tile"
      }
      tile_zoom: {
        type: "integer"
        description: "The zoom level of Google Maps tile"
      }
      variable: {
        type: "string"
        description: "Name of the variable for your map. Available values are:\n\n* `temperature`: Temperature 2 metres above ground\n* `feels_like_temperature`: Feels like temperature\n* `clouds`: Percentage of sky covered by clouds\n* `precipitation`: Total precipitation amount accumulated since last hour\n* `wind_speed`: Wind speed 10 metres above the ground\n* `wind_gust`: Wind gust speed\n* `pressure`: Atmospheric pressure at mean sea level\n* `humidity`: Relative humidity\n* `wave_height`: Wave height\n* `wave_period`: Wave period\n* `sea_temperature`: Sea temperature (available only for +-24 hours)\n* `air_quality`: Air quality index\n* `ozone_surface`: Ozone at surface level\n* `ozone_total`: Total column ozone\n* `no2`: Nitrogen dioxide at surface level\n* `pm2.5`: Particulate matter d < 2.5 µm (PM2.5)\n"
      }
    }
    required: ["datetime", "variable"]
    additionalProperties: false
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}