{"contractVersion":"parcelops.connector.v1","name":"pvgis","displayName":"PVGIS Solar Resource & PV Yield","description":"How much sun a site actually gets, and what a solar array on it would produce, for any point on earth. From PVGIS, the European Commission Joint Research Centre model built on satellite and reanalysis solar data. Give a latitude and longitude and get modelled annual and monthly output for a grid-connected photovoltaic system at a chosen size, tilt, azimuth, module technology, and loss assumption, or ask PVGIS to pick the optimal tilt and azimuth. Also returns long-term monthly irradiation and the average daily irradiance curve for a month. This is solar-farm and rooftop feasibility screening from a model, not an on-site measurement, a bankable yield assessment, or an interconnection study.","tags":["solar","solar-farm","photovoltaic","irradiation","renewable-energy","siting","worldwide"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"PVGIS — Photovoltaic Geographical Information System (European Commission, Joint Research Centre)","sourceUrl":"https://re.jrc.ec.europa.eu/api/v5_2","apiBaseUrl":"https://re.jrc.ec.europa.eu/api/v5_2","documentationUrl":"https://joint-research-centre.ec.europa.eu/photovoltaic-geographical-information-system-pvgis_en"},"freshness":{"status":"declared","value":{"mode":"static","notes":"Long-term climatological averages over a fixed year range, not a live or forecast feed. PVGIS republishes on its own version schedule."}},"coverage":{"geographic":{"status":"declared","value":["Worldwide point queries, with the radiation database selected by location","A point over open sea is refused by PVGIS rather than modelled"]},"temporal":{"status":"declared","value":{"start":"2005","notes":"Year range depends on the radiation database PVGIS picks: PVGIS-NSRDB covers 2005-2015 over the Americas, PVGIS-SARAH2 covers 2005-2020 over Europe and Africa. Each response names the database and its year range."}}},"methods":{"total":4,"items":[{"name":"calculatePvPerformance","description":"Model annual and monthly output of a solar array at a point, size, tilt, and azimuth.","notes":"Monthly rows plus an annual summary; defaults: 1 kWp, 14% loss.","requiredParams":["lat","lon"],"inputSchema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"peakpower":{"type":"number","minimum":0.001,"maximum":100000000},"loss":{"type":"number","minimum":0,"maximum":100},"angle":{"type":"number","minimum":0,"maximum":90},"aspect":{"type":"number","minimum":-180,"maximum":180},"optimalangles":{"type":"boolean"},"mountingplace":{"type":"string","enum":["free","building"]},"pvtechchoice":{"type":"string","enum":["crystSi","CIS","CdTe","Unknown"]}},"required":["lat","lon"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"static","notes":"Long-term climatological averages over a fixed year range, not a live or forecast feed. PVGIS republishes on its own version schedule."},"scope":"connector"},"entities":{"status":"declared","value":["pv-system-yield"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"peakPower":"kWp","systemLoss":"percent","slope":"degrees from horizontal","azimuth":"degrees, 0 = south","E_d":"kWh/day","E_y":"kWh/year","E_m":"kWh/month","H(i)_d":"kWh/m2/day","H(i)_m":"kWh/m2/month","H(i)_y":"kWh/m2/year","SD_m":"kWh/month","SD_y":"kWh/year","l_aoi":"percent","l_spec":"percent","l_tg":"percent","l_total":"percent"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["PVGIS is © European Union. Reproduction is authorised provided the source is acknowledged, so republished results must credit PVGIS / EU JRC.","Values are modelled from satellite and reanalysis data. They are not measured on-site irradiance and carry year-to-year variability, which PVGIS reports as a standard deviation.","Yield figures assume the system parameters supplied. They do not account for shading beyond terrain horizon, soiling, curtailment, or degradation.","The upstream limit is 30 calls per second per IP; results are cached for a day and an overloaded service answers 529 rather than returning data.","Hourly time series and typical-meteorological-year downloads are deliberately not exposed: at roughly 1 MB per location they do not fit a tool response."]},{"name":"getMonthlyRadiation","description":"Return long-term monthly solar irradiation at a point, flat or on a tilted plane.","notes":"One row per year/month; omit angle for horizontal irradiation.","requiredParams":["lat","lon"],"inputSchema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"angle":{"type":"number","minimum":0,"maximum":90},"aspect":{"type":"number","minimum":-180,"maximum":180},"startyear":{"type":"integer","minimum":2005,"maximum":2030},"endyear":{"type":"integer","minimum":2005,"maximum":2030}},"required":["lat","lon"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"static","notes":"Long-term climatological averages over a fixed year range, not a live or forecast feed. PVGIS republishes on its own version schedule."},"scope":"connector"},"entities":{"status":"declared","value":["monthly-irradiation"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"slope":"degrees from horizontal","azimuth":"degrees, 0 = south","H(h)_m":"kWh/m2/month","H(i)_m":"kWh/m2/month","H(s)_m":"kWh/m2/month","Hd(h)_m":"kWh/m2/month","Hd(i)_m":"kWh/m2/month","SD_m":"kWh/m2/month"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["PVGIS is © European Union. Reproduction is authorised provided the source is acknowledged, so republished results must credit PVGIS / EU JRC.","Values are modelled from satellite and reanalysis data. They are not measured on-site irradiance and carry year-to-year variability, which PVGIS reports as a standard deviation.","Yield figures assume the system parameters supplied. They do not account for shading beyond terrain horizon, soiling, curtailment, or degradation.","The upstream limit is 30 calls per second per IP; results are cached for a day and an overloaded service answers 529 rather than returning data.","Hourly time series and typical-meteorological-year downloads are deliberately not exposed: at roughly 1 MB per location they do not fit a tool response."]},{"name":"getDailyRadiationProfile","description":"Return the average hourly irradiance curve for one month at a point.","notes":"Hourly rows; month 1-12, or 0 for all; localtime=false returns UTC.","requiredParams":["lat","lon"],"inputSchema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"month":{"type":"integer","minimum":0,"maximum":12},"angle":{"type":"number","minimum":0,"maximum":90},"aspect":{"type":"number","minimum":-180,"maximum":180},"localtime":{"type":"boolean"}},"required":["lat","lon"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"static","notes":"Long-term climatological averages over a fixed year range, not a live or forecast feed. PVGIS republishes on its own version schedule."},"scope":"connector"},"entities":{"status":"declared","value":["daily-irradiance-profile"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"slope":"degrees from horizontal","azimuth":"degrees, 0 = south","G(i)":"W/m2","Gb(i)":"W/m2","Gd(i)":"W/m2","Gr(i)":"W/m2","H_sun":"degrees","T2m":"degrees Celsius","WS10m":"m/s"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["PVGIS is © European Union. Reproduction is authorised provided the source is acknowledged, so republished results must credit PVGIS / EU JRC.","Values are modelled from satellite and reanalysis data. They are not measured on-site irradiance and carry year-to-year variability, which PVGIS reports as a standard deviation.","Yield figures assume the system parameters supplied. They do not account for shading beyond terrain horizon, soiling, curtailment, or degradation.","The upstream limit is 30 calls per second per IP; results are cached for a day and an overloaded service answers 529 rather than returning data.","Hourly time series and typical-meteorological-year downloads are deliberately not exposed: at roughly 1 MB per location they do not fit a tool response."]},{"name":"getServiceInfo","description":"Return endpoints, coverage, angle conventions, and what this model does not answer.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"static","notes":"Long-term climatological averages over a fixed year range, not a live or forecast feed. PVGIS republishes on its own version schedule."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["PVGIS is © European Union. Reproduction is authorised provided the source is acknowledged, so republished results must credit PVGIS / EU JRC.","Values are modelled from satellite and reanalysis data. They are not measured on-site irradiance and carry year-to-year variability, which PVGIS reports as a standard deviation.","Yield figures assume the system parameters supplied. They do not account for shading beyond terrain horizon, soiling, curtailment, or degradation.","The upstream limit is 30 calls per second per IP; results are cached for a day and an overloaded service answers 529 rather than returning data.","Hourly time series and typical-meteorological-year downloads are deliberately not exposed: at roughly 1 MB per location they do not fit a tool response."]}]},"caveats":["PVGIS is © European Union. Reproduction is authorised provided the source is acknowledged, so republished results must credit PVGIS / EU JRC.","Values are modelled from satellite and reanalysis data. They are not measured on-site irradiance and carry year-to-year variability, which PVGIS reports as a standard deviation.","Yield figures assume the system parameters supplied. They do not account for shading beyond terrain horizon, soiling, curtailment, or degradation.","The upstream limit is 30 calls per second per IP; results are cached for a day and an overloaded service answers 529 rather than returning data.","Hourly time series and typical-meteorological-year downloads are deliberately not exposed: at roughly 1 MB per location they do not fit a tool response."]}