HALOWERK Europe Land · Europe Built UP Share Parcel

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://euroland.halowerk.com/v1/europe-built-up-share-parcel", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "polygon": [
      [
        7.095,
        51.895
      ],
      [
        7.105,
        51.895
      ],
      [
        7.105,
        51.905
      ],
      [
        7.095,
        51.905
      ]
    ]
  }),
});
const data = await res.json();

curl -X POST \
  "https://euroland.halowerk.com/v1/europe-built-up-share-parcel" \
  -H "Content-Type: application/json" \
  -d '{"polygon":[[7.095,51.895],[7.105,51.895],[7.105,51.905],[7.095,51.905]]}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "authoritative_status": "preliminary_non_binding",
  "category": "europe-wide",
  "caveats": [
    "Preliminary geodata assessment; not a legally binding property, cadastral, planning, environmental or title search.",
    "Raster resolution and model uncertainty can be larger than the submitted site geometry.",
    "Material decisions require a current verification by the competent national or regional authority."
  ],
  "charged": true,
  "checked_at": "2026-09-03T00:00:00.000Z",
  "confidence": 0.81,
  "confidence_method": "Conservative minimum source-family baseline plus a bounded sample-count bonus; multi-source results receive a fixed integration penalty.",
  "data_date": "2021-12-31T23:59:59.000Z",
  "evidence": {
    "built-up-share": {
      "method": "documented source raster sample",
      "metric": "built-up-share",
      "name": "Built-up share",
      "sample_count": 1,
      "unit": "percent",
      "value": 1
    }
  },
  "evidence_classification": "derived_from_open_geodata",
  "facts": {
    "measurements": {
      "built-up-share": {
        "method": "documented source raster sample",
        "metric": "built-up-share",
        "name": "Built-up share",
        "sample_count": 1,
        "unit": "percent",
        "value": 1
      }
    }
  },
  "generated_at": "2026-09-03T00:00:00.000Z",
  "geometry": null,
  "limitations": [
    "Preliminary geodata assessment; not a legally binding property, cadastral, planning, environmental or title search.",
    "Raster resolution and model uncertainty can be larger than the submitted site geometry.",
    "Material decisions require a current verification by the competent national or regional authority."
  ],
  "payment": {
    "price_usdc": 0.001,
    "settled": true
  },
  "recommended_next_steps": [
    "Verify material findings with current cadastral, planning and environmental records from the competent authority.",
    "Commission a qualified on-site survey where parcel-scale conditions affect the decision."
  ],
  "result": "measurement_available",
  "risk_level": "not_applicable",
  "service": "europe-built-up-share-parcel",
  "service_id": "eli-0844",
  "sources": [
    {
      "attribution": "© ESA WorldCover project 2021 / Contains modified Copernicus Sentinel data (2021) processed by ESA WorldCover consortium.",
      "authority": "European Space Agency",
      "cache_policy": "Remote Cloud Optimized GeoTIFF byte ranges; no whole-dataset redistribution.",
      "caveats": [
        "Categorical remote-sensing map with classification uncertainty.",
        "Not a cadastral, planning-law or permit dataset."
      ],
      "commercial_use": true,
      "commercial_use_allowed": true,
      "coverage": "Global 2021 land-cover map; valid source tiles are required at the submitted geometry.",
      "data_date": "2021-12-31T23:59:59.000Z",
      "data_period": "2021 mapping year.",
      "dataset": "ESA WorldCover 2021",
      "freshness": "Historical 2021 v200 observation product; not a live land-use register.",
      "id": "esa-worldcover-2021",
      "license": "CC BY 4.0",
      "license_status": "verified",
      "license_verified_at": "2026-09-03",
      "name": "ESA WorldCover 2021",
      "provider": "European Space Agency",
      "purpose": "Current-suite land-cover classes and area shares.",
      "rate_limit": "ESA public object store; local timeout, retry and circuit breaker apply.",
      "redistribution": true,
      "resolution": "10 metres",
      "retrieved_at": "2026-09-03T00:00:00.000Z",
      "source_url": "https://esa-worldcover.s3.eu-central-1.amazonaws.com/v200/2021/map/",
      "terms_url": "https://esa-worldcover.org/en/data-access",
      "update_interval": "Annual historical product; version v200 is pinned for reproducible results.",
      "url": "https://esa-worldcover.s3.eu-central-1.amazonaws.com/v200/2021/map/",
      "version": "v200"
    }
  ],
  "status": "success",
  "summary": "Europe Built-up share: parcel sample: source-backed screening evidence was calculated successfully."
}