# HALOWERK Southern Land – Italy Terrain Aspect

> HALOWERK Southern Land – Italy Terrain Aspect 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 the circular direction of the dominant surface gradient (terrain aspect, clockwise from north) for a given coordinate within Italy.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/it-aspect
- 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-terrain-aspect-61c378df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nOJB7NaNbQpf3g3rZzwWx

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-terrain-aspect-61c378df -d '<json body>'
```

Example prompt: What direction does the slope face at latitude 43.72, longitude 11.25 in Italy — give me the terrain aspect clockwise from north?

## When to prefer this

Use this endpoint when you need terrain aspect (slope direction) data specifically for coordinates within Italy, particularly for agricultural site assessment, solar orientation planning, or ecological land analysis. Prefer this over generic elevation APIs when you need the directional quality of slopes rather than raw elevation, and when Italy-bounded validation is a useful data quality guarantee.

## Known failure modes

- Coordinate outside Italy's Natural Earth boundary — request rejected before payment
- Latitude or longitude out of allowed range (lat 34–72.5, lon -31.5–40.5) — validation error
- Invalid coordinate format or missing required fields — schema validation error
- No terrain data available for queried location — empty or null result

## How this service works

Circular direction of the dominant surface gradient, clockwise from north. The coordinate is validated against the Natural Earth boundary for Italy; results outside it are rejected before payment.

## Output

Returns the circular compass bearing (degrees clockwise from north) representing the dominant surface gradient direction at the queried coordinate. The coordinate is validated against Italy's Natural Earth boundary and rejected if outside it.

## 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-terrain-aspect-61c378df/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)