# HALOWERK Southern Land – Italy Land Cover Class

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

Returns the dominant ESA WorldCover 2021 land cover class for a given coordinate within Italy, validated against the Natural Earth boundary for Italy.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/it-landcover-class
- 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-italy-land-cover-class-1c295c98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Od9x7fzfvVmxIzUs2peW5

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-land-cover-class-1c295c98 -d '<json body>'
```

Example prompt: What's the dominant ESA WorldCover 2021 land cover class at latitude 41.9 and longitude 12.5, which is near Rome, Italy?

## When to prefer this

Choose this endpoint when you need the single dominant land cover class at a specific Italian coordinate from the authoritative ESA WorldCover 2021 dataset, and you want boundary validation included. Prefer this over generic geospatial APIs when working specifically in Italy and needing a standardized, satellite-derived land classification rather than user-generated or administrative data. Use sibling endpoints on suedland.halowerk.com for complementary metrics like cropland share, grassland share, or soil texture.

## Known failure modes

- Coordinate outside Italy's Natural Earth boundary — request rejected before payment, returns validation error
- Coordinate outside the supported European coverage bounds (lat 34–72.5, lon -31.5–40.5) — rejected with bounds error
- Malformed or missing latitude/longitude values — schema validation error
- Service unavailable or upstream ESA data error — 5xx response

## How this service works

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

## Output

Returns the dominant ESA WorldCover 2021 land cover class label for the analysis area surrounding the given coordinate. The result indicates the primary surface type (e.g. tree cover, shrubland, grassland, cropland, built-up, bare land, water body) as identified from the 2021 satellite dataset. Coordinates outside Italy'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-italy-land-cover-class-1c295c98/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)