2025 Time Series and TMY API release notes

14.7.2025 v 1.18.2

TMY API update

• TMY API now supports GTI parameters in the request.

• TMY API now supports optional environmental albedo (one yearly or twelve monthly LTA values) and horizon parameters in the request. If you provide these in the request, they will be used in the GTI simulation and sent to you in the response as well. If you do not provide them, the system will use Solargis values instead.

• TMY API now supports terrain shading as a boolean value and time zone offset in the request.

• TMY API response now also sends albedo and horizon data (SOLARGIS_JSON format only)

• Below is the full JSON request reflecting the changes.

  {
    "latitude": 49.160155,
    "longitude": 19.852295,
    "timeStep": "PT15M",
    "tmyScenario": "P50",
    "siteName": "Pro example Site",
    "fileLabel": "offset",
    "utcOffset": "+05:00",
    "outputFormats": [
      "SOLARGIS_JSON",
      "SAM"
    ],
    "terrainShading": true,
    "environment": {
      "surfaceAlbedo": 0.12,
      "horizon": {
        "azimuth": [
          0
        ],
        "height": [
          0
        ]
      }
    },
    "gtiConfiguration": {
      "layout": {
        "azimuth": 180,
        "mounting": {
          "type": "FIXED_ONE_ANGLE_SEASONAL",
          "tilt": [
            {
              "dateOfChange": "03-21",
              "tilt": 30
            },
            {
              "dateOfChange": "09-21",
              "tilt": 50
            }
          ]
        }
      }
    }
  }