# HALOWERK Southern Land Portugal Aspect

> HALOWERK Southern Land Portugal 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-13).

Returns the dominant surface slope direction (aspect) in degrees clockwise from north for a given coordinate within Portugal.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/pt-aspect
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-southern-land-portugal-aspect-76111e69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-Lj9GbtyjsTOy5xoUMd_A

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-portugal-aspect-76111e69 -d '<json body>'
```

Example prompt: What direction does the terrain face at latitude 38.72, longitude -9.14 in Portugal? I need the dominant surface aspect in degrees clockwise from north.

## When to prefer this

Use this endpoint when you need terrain aspect (slope-facing direction) specifically for coordinates within Portugal, especially as part of a broader land suitability, agricultural planning, or environmental analysis workflow. It is pre-validated against the Portugal boundary, ensuring you are not charged for out-of-bounds requests. Prefer it over generic DEM APIs when you need a cost-effective, pay-per-call micro-service for Portugal-specific terrain analysis.

## Known failure modes

- Coordinate outside Portugal boundary — rejected with an error before payment is processed
- Latitude or longitude outside valid European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Invalid or missing coordinate fields — request rejected
- Network timeout or service unavailability

## How this service works

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

## Output

A numeric value representing the circular direction of the dominant surface gradient in degrees (0–360, clockwise from north), reflecting the primary facing direction of the terrain at the queried coordinate within Portugal. Coordinates outside the Portugal boundary 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-portugal-aspect-76111e69/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)