# Google Solar API Building Insights via x402

> Google Solar API Building Insights via x402 is a paid API for AI agents from x402-endpoints.onrender.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns rooftop solar potential data (panel count, usable area, annual sunshine hours, carbon offset) for a building at given coordinates via the Google Maps Platform Solar API.

## Facts

- Endpoint: GET https://x402-endpoints.onrender.com/solar/building-insights
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-solar-api-building-insights-via-x402-eb6116d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K2Afsd-98QtR12laWujzA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability google-solar-api-building-insights-via-x402-eb6116d3
```

Example prompt: Can you check the rooftop solar potential for the building at latitude 48.139, longitude 11.566 — I want to know the max panel count, usable roof area, annual sunshine hours, and carbon offset factor? Use HIGH imagery quality.

## When to prefer this

Choose this endpoint when you need authoritative, Google-sourced solar potential data for a specific building by coordinate — especially for EU locations. Prefer this over generic solar estimators when you need structured data including panel count, roof area, sunshine hours, and carbon offset together in a single call. Useful for real estate analysis, sustainability reporting, or solar ROI calculations.

## Known failure modes

- No building found at or near the specified coordinate — returns empty or error response
- Imagery quality level requested (e.g. HIGH) not available for that location — may need to fall back to MEDIUM or BASE
- Coordinates outside covered regions (sparse coverage outside EU/NA) — no data returned
- Invalid lat/lon values — schema validation error
- Payment failure or insufficient USDC balance — 402 response before data is returned

## How this service works

Rooftop solar potential, panel capacity, sunshine hours and carbon offset by coordinate from the official Google Maps Platform Solar API — returns max panel count, usable roof area, annual sunshine hours and carbon-offset factor for the closest building. Worldwide partial coverage (EU well covered).

## Output

Returns solar building insights for the closest building to the given coordinate, including maximum panel count, usable roof area in square meters, annual sunshine hours, and a carbon offset factor — sourced from the Google Maps Platform Solar API. Coverage is worldwide with particularly strong coverage in the EU.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude of the building, e.g. 48.139"
      },
      "lon": {
       "type": "number",
       "description": "Longitude of the building, e.g. 11.566"
      },
      "quality": {
       "type": "string",
       "description": "Required imagery quality: HIGH | MEDIUM | BASE (default HIGH)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "buildings/...",
  "cached": false,
  "center": {
   "latitude": 48.1388,
   "longitude": 11.5658
  },
  "source": "Google Maps Platform Solar API (solar.googleapis.com)",
  "timestamp": "2026-06-25T12:00:00Z",
  "attribution": "Solar data © Google — Google Maps Platform Solar API",
  "postal_code": "80331",
  "region_code": "DE",
  "imagery_date": "2022-09-04",
  "imagery_quality": "HIGH",
  "solar_potential": {
   "panel_capacity_watts": 250,
   "max_array_area_meters2": 94.25,
   "max_array_panels_count": 48,
   "whole_roof_area_meters2": 194.63,
   "max_sunshine_hours_per_year": 1222.3,
   "carbon_offset_factor_kg_per_mwh": 475
  },
  "administrative_area": "Bayern"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-solar-api-building-insights-via-x402-eb6116d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-endpoints.onrender.com](https://www.zero.xyz/host/x402-endpoints.onrender.com/llms.txt)