Resources

Requesting data

This request specifies what data you want from Solargis.

Request type: POST

Endpoint: https://api.solargis.com/data-request/tmy

Request parameters overview

• site: Latitude (-90 to 90), longitude (-180 to 180), optional name
• timeStep: Enum (PT1M, PT15M, PT60M)
• utcOffset: Optional timezone offset (e.g., "+01:00")
• outputFormats: SOLARGIS_JSON, SOLARGIS_CSV, SAM, HELIOSCOPE
• terrainShading: Boolean (default: false)
• environment: albedo (array), horizon (azimuth/height)
• gtiConfiguration: mounting type/azimuth
• splitOutputByYear: Booleat (default:false)

Requesting status

This request specifies what status your request is in. Can be queued, processing, or success/error.

When the status ends up in the success state, you will also receive the data in a file.

Request type: GET

Endpoint: https://api.solargis.com/data-request/tmy/{requestId}/

• Retrieve generated TMY data in various formats (e.g., for third-party apps).

Data download

TMY API has a special endpoint, where the requested data can be obtained directly in response (and not in a file). You need to define the output format at the end of the endpoint URL as you can only request one output format in this case.

Request type: GET

Endpoint: https://api.solargis.com/tmy/data-request/{requestid}/{outputFormat}