Formulas for

Solar Potential

Weather1 credit/cellSheets · Excel
=VERVE("solarpotential", 37.7749, -122.4194, "field", "coordinates.latitude")

Estimate PV yield per location. Returns usable sunlight hours and best direction — Sheets or Excel.

It's one of 250+ live sources you reach with a single =VERVE() function — served from APIVerve's production data engine, billed at 1 credit per resolved cell, and refreshed on whatever cadence you set. No API keys to wrangle, no scripts, no exports.

A real example — the input you type, and the values you can pull from it. Click any cell to see the formula behind it.

solarpotential.xlsxsample data
C2fx=VERVE("solarpotential", A2, B2, "field", "coordinates.latitude")
A
B
C
D
E
1
Lat
Lon
Coordinates › Latitude
Coordinates › Longitude
Usable Hours › Avg Daily Usable Sunlight Hours
2
37.7749
-122.4194
37.7749
-122.4194
12.19
3
4
click any cell to see its formula1 credit / cell

Conditions per location

Put your cities in a column and fill =VERVE("solarpotential", 37.7749, -122.4194, "field", "coordinates.latitude") beside them — every row shows live conditions, so an ops or travel sheet reflects the real world, not last week.

Logistics & scheduling

Gate a plan on the weather: read the forecast into a cell and let an IF formula flag rows that need a backup date.

Auto-refreshing board

Set the sheet to refresh on a schedule and Solar Potential keeps a status board current without anyone re-typing a thing.

The same function works in both apps — install once, sign in with your key, and type it into any cell.

Google SheetsAdd-on

Install from the Workspace Marketplace, then drop the formula into a cell. Autocomplete suggests the source and its fields.

=VERVE("solarpotential", 37.7749, -122.4194, "field", "coordinates.latitude")
Microsoft ExcelAdd-in

Same source, same arguments, same key — in Excel on desktop, the web, or mobile. Excel namespaces it as VERVE.CALL. Drag to fill a whole column.

=VERVE.CALL("solarpotential", 37.7749, -122.4194, "field", "coordinates.latitude")

Add a field name as the last argument to land just that value in the cell.

  • Coordinates › Latitude
    =VERVE("solarpotential", 37.7749, -122.4194, "field", "coordinates.latitude")
  • Coordinates › Longitude
    =VERVE("solarpotential", 37.7749, -122.4194, "field", "coordinates.longitude")
  • Usable Hours › Avg Daily Usable Sunlight Hours
    =VERVE("solarpotential", 37.7749, -122.4194, "field", "usableHours.avgDailyUsableSunlightHours")
  • Usable Hours › Yearly Usable Sunlight Hours RawPremium
    =VERVE("solarpotential", 37.7749, -122.4194, "field", "usableHours.yearlyUsableSunlightHoursRaw")
  • Usable Hours › Adjusted Yearly Usable Sunlight HoursPremium
    =VERVE("solarpotential", 37.7749, -122.4194, "field", "usableHours.adjustedYearlyUsableSunlightHours")
  • Best Direction
    =VERVE("solarpotential", 37.7749, -122.4194, "field", "bestDirection")
  • Cloud FactorPremium
    =VERVE("solarpotential", 37.7749, -122.4194, "field", "cloudFactor")
  • Disclaimer
    =VERVE("solarpotential", 37.7749, -122.4194, "field", "disclaimer")

Premium marks data included on paid plans. On the Free plan a marked field is withheld and a marked input is ignored — either way the cell reads #PREMIUM(name) instead of a value, so a gated answer can never be mistaken for a real one. Everything unmarked works on every plan. Compare plans

Solar Potential, answered

Everything you need to wire it into a sheet.

How do I pull Solar Potential into Google Sheets?
Install the VerveSheets add-on, sign in once with your key, and type =VERVE("solarpotential", 37.7749, -122.4194, "field", "coordinates.latitude") into any cell. The "field" argument names the value you want back, so the cell resolves to a single number or string you can chart, sort, or feed into another formula.
What data can I pull from Solar Potential?
Solar Potential returns coordinates.latitude, coordinates.longitude, usableHours.avgDailyUsableSunlightHours, bestDirection and disclaimer — name any one of them as the "field" argument and that value lands in the cell. Leave the field out and the whole record spills into a two-column table instead.
Which Solar Potential fields need a paid plan?
usableHours.yearlyUsableSunlightHoursRaw, usableHours.adjustedYearlyUsableSunlightHours and cloudFactor are included from the Starter plan up. On the Free plan the cell returns #PREMIUM(field) rather than a wrong or empty value, so it's always obvious which one to upgrade for. Every other field works on Free.
Can I fill a whole column of Solar Potential at once?
Yes. Put your lat values down a column and point the formula at the range — A2:A50 instead of A2 — and one call returns a value for every row. Dragging the formula down works too, but the range form is a single billed call per column rather than one per cell.
How many credits does each Solar Potential cell cost?
Each resolved cell costs 1 credit. A cell only re-bills when it actually refreshes, so a sheet you aren't touching doesn't keep charging.
Does Solar Potential work in Excel as well as Google Sheets?
Yes — same arguments, same key, same fields. Excel namespaces custom functions, so the call is =VERVE.CALL() there and =VERVE() in Google Sheets; nothing else about it changes.

Put Solar Potential in your next spreadsheet. Add the extension, paste the formula, and the cell keeps itself current.

Scaling up?

Volume pricing, custom SLAs, and dedicated support for high-traffic teams.

Contact sales