# HALOWERK Southern Land – Portugal Tree Cover Share

> HALOWERK Southern Land – Portugal Tree Cover 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-15).

Returns the share of ESA WorldCover 2021 pixels classified as tree cover for a given coordinate within Portugal.

## Facts

- Endpoint: POST https://suedland.halowerk.com/v1/pt-tree-cover-share
- 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-tree-cover-share-b06ee1bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IuCXYWP3MVR57EsRtJ8EP

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-tree-cover-share-b06ee1bf -d '<json body>'
```

Example prompt: What share of the land around latitude 38.7 and longitude -9.15 in Portugal is classified as tree cover according to ESA WorldCover 2021?

## When to prefer this

Use this endpoint when you need ESA WorldCover 2021-based tree cover share specifically for a point location within Portugal. It is preferable when you require a validated, pay-per-call micro-service with built-in boundary enforcement so you only get results for confirmed Portuguese territory. Choose sibling endpoints on the same platform for complementary land-cover classes (cropland, grassland) or soil/terrain attributes at the same location.

## Known failure modes

- Coordinate outside Portugal boundary — rejected before payment with a boundary validation error
- Coordinate within European bounding box but outside Portugal — rejected by Natural Earth boundary check
- Latitude or longitude outside the declared European coverage range (lat 34–72.5, lon -31.5–40.5) — schema validation error
- Network or upstream data service unavailability — server error response

## How this service works

Share of ESA WorldCover 2021 pixels classified as tree cover. The coordinate is validated against the Natural Earth boundary for Portugal; results outside it are rejected before payment.

## Output

A numeric share (fraction or percentage) of ESA WorldCover 2021 pixels classified as tree cover within the analysis area surrounding the given coordinate. Coordinates outside the Natural Earth boundary for Portugal are rejected before 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-portugal-tree-cover-share-b06ee1bf/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)