# LION Location Solar Enrichment

> LION Location Solar Enrichment is a paid API for AI agents from lion-x402.lionmaster-operations.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns geocoded location data enriched with solar irradiation potential, terrain elevation, building characteristics, land use, flood exposure, road access, and amenity density for a given address or coordinate.

## Facts

- Endpoint: GET https://lion-x402.lionmaster-operations.workers.dev/api/x402/location-solar-enrichment-json
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lion-location-solar-enrichment-a8ae6ce7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7QWJN0Xi-Y2JZNRXsg_Uu

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 lion-location-solar-enrichment-a8ae6ce7
```

Example prompt: What's the solar energy potential and site profile for the Googleplex at 1600 Amphitheatre Parkway, Mountain View, CA — I need annual irradiation, optimal panel tilt, building info, and flood risk.

## When to prefer this

Use this endpoint when you need a comprehensive, multi-dimensional site assessment combining solar potential, terrain, building, flood, land use, and amenity data in a single call without API key management. Ideal for real estate screening, solar feasibility studies, site selection workflows, and urban analytics where pay-per-call pricing is preferable to subscription overhead.

## Known failure modes

- Location cannot be geocoded — unrecognized or ambiguous address returns resolved:false
- PVGIS coverage gap — solar data unavailable for polar or ocean locations
- Payment not sent — endpoint returns HTTP 402 requiring USDC payment on Base
- Rate or payload errors from underlying OSM/Open-Elevation APIs
- Low confidence score when building/terrain data is sparse for rural areas

## How this service works

Keyless off-chain and on-chain data for AI agents. No API key, no signup - payment is the only gate. Pay-per-call in USDC on Base via x402.

## Output

A JSON object containing: geocoded coordinates and place metadata, annual solar irradiation (kWh/m²) and optimal PV yield from PVGIS, optimal tilt angle, terrain elevation, building dimensions and type, flood exposure band, dominant land use, nearest road name and class, and counts of nearby amenities by category (food, health, retail, transit, education, recreation). Also includes confidence score, attribution sources, and a timestamp.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lat": {
       "type": "number"
      },
      "lon": {
       "type": "number"
      },
      "address": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "site": {
   "building": {
    "levels": 3,
    "height_m": 18,
    "distance_m": 0,
    "building_type": "commercial",
    "footprint_area_m2": 8211
   },
   "land_use": {
    "classes_nearby": [
     "commercial",
     "grass"
    ],
    "dominant_class": "commercial"
   },
   "road_access": {
    "road_name": "Charleston Road",
    "distance_m": 35,
    "nearest_road_class": "service"
   },
   "flood_exposure": {
    "basis": "coarse heuristic (elevation + distance-to-water); NOT a flood certification",
    "elevation_m": 9,
    "exposure_band": "low",
    "distance_to_water_m": 1200
   },
   "amenity_density": {
    "food": 11,
    "health": 0,
    "retail": 1,
    "transit": 2,
    "education": 0,
    "recreation": 17
   }
  },
  "as_of": "2026-06-02T00:00:00.000Z",
  "solar": {
   "source": "PVGIS",
   "optimal_tilt_deg": 30,
   "annual_irradiation_kwh_m2": 1850.4,
   "optimal_pv_yield_kwh_per_kwp": 1620.2
  },
  "geocode": {
   "lat": 37.4221,
   "lon": -122.0841,
   "importance": 0.55,
   "place_rank": 30,
   "place_type": "company",
   "place_class": "office",
   "bounding_box": [
    37.4218,
    37.4224,
    -122.0846,
    -122.0836
   ],
   "country_code": "us"
  },
  "terrain": {
   "elevation_m": 9
  },
  "asset_id": "LION_LOCATION_SOLAR_001",
  "resolved": true,
  "confidence": 0.9,
  "attribution": [
   "OpenStreetMap contributors (ODbL)",
   "Open-Elevation",
   "EU PVGIS"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lion-location-solar-enrichment-a8ae6ce7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lion-x402.lionmaster-operations.workers.dev](https://www.zero.xyz/host/lion-x402.lionmaster-operations.workers.dev/llms.txt)