# HALOWERK Southern Land – Portugal Dominant Land Cover Class

> HALOWERK Southern Land – Portugal Dominant Land Cover Class 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 dominant ESA WorldCover 2021 land cover class for a given coordinate within Portugal's boundary.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/pt-landcover-class
- 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-portugal-dominant-land-cover-class-01e5dc40
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Tu7pQ_T5aq-lFSydjXoE-

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-dominant-land-cover-class-01e5dc40 -d '<json body>'
```

Example prompt: What's the dominant ESA WorldCover 2021 land cover class at latitude 38.72, longitude -9.14 in Portugal?

## When to prefer this

Use this endpoint when you need the single most representative land cover category at a specific Portuguese location according to the authoritative ESA WorldCover 2021 dataset. Prefer this over cropland-share or grassland-share endpoints when you need a holistic dominant class label rather than a fractional breakdown of a specific class. Ideal for land suitability assessments, environmental reporting, and site classification within Portugal.

## Known failure modes

- Coordinate outside Portugal's Natural Earth boundary — request rejected with validation error
- Latitude or longitude outside published European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Invalid coordinate format — input parsing error
- Payment failure — x402 payment not confirmed, request not processed

## How this service works

Dominant ESA WorldCover 2021 class in the analysis area. The coordinate is validated against the Natural Earth boundary for Portugal; results outside it are rejected before payment.

## Output

A single dominant ESA WorldCover 2021 land cover class label (e.g. Tree cover, Shrubland, Grassland, Cropland, Built-up, Bare/sparse vegetation, Snow and ice, Permanent water bodies, Herbaceous wetland, Mangroves, Moss and lichen) for the analysis area centered on the provided coordinate. Coordinates outside Portugal's Natural Earth boundary are rejected before processing.

## 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-dominant-land-cover-class-01e5dc40/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)