# HALOWERK Southern Land – Italy Built-Up Share

> HALOWERK Southern Land – Italy Built-Up Share 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 share of ESA WorldCover 2021 pixels classified as built-up (urban/impervious surfaces) within an analysis area around a given coordinate in Italy.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/it-built-up-share
- 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-built-up-share-5bfb0491
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H3xtULiIazpCYDkrBG8zT

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-built-up-share-5bfb0491 -d '<json body>'
```

Example prompt: What share of the land around latitude 41.9028, longitude 12.4964 in Italy is classified as built-up according to ESA WorldCover 2021?

## When to prefer this

Choose this endpoint when you need a precise, pixel-level built-up land cover fraction for a specific point in Italy derived from the authoritative ESA WorldCover 2021 dataset. It is ideal for site assessment, urban/rural classification, real estate due diligence, agricultural land screening, or environmental analysis workflows focused on Italy. It is preferable over general land use APIs when you need ESA WorldCover 2021 specifically and want boundary validation to ensure the coordinate is legitimately within Italy before incurring any cost.

## Known failure modes

- Coordinate outside Italy's Natural Earth boundary — request rejected before payment, returns validation error
- Coordinate outside the broader European coverage bounds (lat 34–72.5, lon -31.5–40.5) — rejected as out of range
- Invalid or missing latitude/longitude — returns schema validation error
- Coordinate in a maritime or border edge case where boundary validation fails unexpectedly

## How this service works

Share of ESA WorldCover 2021 pixels classified as built-up. The coordinate is validated against the Natural Earth boundary for Italy; results outside it are rejected before payment.

## Output

A numeric share (fraction or percentage) representing the proportion of ESA WorldCover 2021 pixels in the analysis area around the given coordinate that are classified as built-up (urban/impervious surfaces). Only coordinates validated within Italy's Natural Earth boundary are accepted; out-of-boundary requests are rejected before any payment is charged.

## 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-built-up-share-5bfb0491/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)