# HALOWERK Southern Land – Italy Solar Orientation Index

> HALOWERK Southern Land – Italy Solar Orientation Index is a paid API for AI agents from suedland.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns a south-facing slope orientation index derived from aspect and slope for a given coordinate within Italy.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/it-solar-orientation
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-southern-land-italy-solar-orientation-index-9e92733d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0FosPH2xJIk7kAC22arF2

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 halowerk-southern-land-italy-solar-orientation-index-9e92733d -d '<json body>'
```

Example prompt: What's the south-facing slope orientation index for the location at latitude 43.72, longitude 11.25 in Tuscany? I want to know how solar-favorable that hillside is.

## When to prefer this

Choose this endpoint when you need a computed south-facing slope orientation score specifically for locations within Italy, as it validates coordinates against Italy's official boundary before charging. It is ideal for site suitability analysis for solar panels, vineyards, agrivoltaics, or agritourism where southern aspect is a key variable. Prefer this over generic DEM or aspect APIs when you need a pre-computed orientation index rather than raw elevation or aspect values, and when Italy-specific geographic validation and micropayment-per-call pricing are acceptable.

## Known failure modes

- Coordinate outside Italy boundary — rejected with geographic validation error and no charge
- Latitude or longitude out of allowed range (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Payment failure via x402 protocol — request not processed
- Network timeout or upstream terrain data unavailability — service error response
- Malformed input JSON — 400-level validation error

## How this service works

South-facing slope orientation index derived from aspect and slope. The coordinate is validated against the Natural Earth boundary for Italy; results outside it are rejected before payment.

## Output

A numeric south-facing slope orientation index derived from the terrain's aspect and slope at the queried coordinate. Higher values indicate terrain that is more favorably oriented toward the south, implying greater solar exposure. Coordinates outside the Natural Earth boundary for Italy are rejected before any charge is applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "number",
   "maximum": 72.5,
   "minimum": 34,
   "description": "WGS84 latitude inside the published European coverage."
  },
  "longitude": {
   "type": "number",
   "maximum": 40.5,
   "minimum": -31.5,
   "description": "WGS84 longitude inside the published European coverage."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-southern-land-italy-solar-orientation-index-9e92733d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from suedland.halowerk.com](https://www.zero.xyz/host/suedland.halowerk.com/llms.txt)