HALOWERK Central Land · AT Solar Orientation

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://mitteleuropa.halowerk.com/v1/at-solar-orientation", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "latitude": 48.2082,
    "longitude": 16.3738
  }),
});
const data = await res.json();

curl -X POST \
  "https://mitteleuropa.halowerk.com/v1/at-solar-orientation" \
  -H "Content-Type: application/json" \
  -d '{"latitude":48.2082,"longitude":16.3738}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "authoritative_status": "preliminary_non_binding",
  "category": "country",
  "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.85,
  "confidence_method": "Conservative minimum source-family baseline plus a bounded sample-count bonus; multi-source results receive a fixed integration penalty.",
  "data_date": "2015-12-31T23:59:59.000Z",
  "evidence": {
    "solar-orientation": {
      "method": "documented source raster sample",
      "metric": "solar-orientation",
      "name": "Solar orientation index",
      "sample_count": 1,
      "unit": "index_0_100",
      "value": 1
    }
  },
  "evidence_classification": "derived_from_open_geodata",
  "facts": {
    "measurements": {
      "solar-orientation": {
        "method": "documented source raster sample",
        "metric": "solar-orientation",
        "name": "Solar orientation index",
        "sample_count": 1,
        "unit": "index_0_100",
        "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": "at-solar-orientation",
  "service_id": "eli-0383",
  "sources": [
    {
      "attribution": "© DLR e.V. 2010-2014 and © Airbus Defence and Space GmbH 2014-2018 provided under COPERNICUS by the European Union and ESA; all rights reserved.",
      "authority": "European Union Copernicus Programme / ESA / DLR / Airbus",
      "cache_policy": "HTTP byte ranges only; bounded 2 GB derived block cache, no whole-dataset copy.",
      "caveats": [
        "Digital surface model: vegetation and structures can raise the measured surface above bare earth.",
        "Values over water and source voids may be unavailable."
      ],
      "commercial_use": true,
      "commercial_use_allowed": true,
      "coverage": "Global land surface; requests are restricted to the 30 published European countries.",
      "data_date": "2015-12-31T23:59:59.000Z",
      "data_period": "TanDEM-X acquisition period 2011-2015; this is not a current-condition survey.",
      "dataset": "Copernicus DEM GLO-30 Full, Free & Open",
      "freshness": "Pinned COP-DEM-GLO-30-F product.",
      "id": "copernicus-dem-glo30-f",
      "license": "COP-DEM-GLO-30-F Full, Free & Open licence",
      "license_status": "verified",
      "license_verified_at": "2026-09-03",
      "name": "Copernicus DEM GLO-30 Full, Free & Open",
      "provider": "European Union Copernicus Programme / ESA / DLR / Airbus",
      "purpose": "Surface elevation and deterministic terrain derivatives.",
      "rate_limit": "AWS Open Data endpoint; local per-request timeout and circuit breaker apply.",
      "redistribution": true,
      "resolution": "30 metres",
      "retrieved_at": "2026-09-03T00:00:00.000Z",
      "source_url": "https://copernicus-dem-30m.s3.eu-central-1.amazonaws.com/",
      "terms_url": "https://dataspace.copernicus.eu/sites/default/files/media/files/2025-06/copernicus_contributing_mission_data_access_v2_cop_dem_licenses.pdf",
      "update_interval": "Provider product release based.",
      "url": "https://copernicus-dem-30m.s3.eu-central-1.amazonaws.com/",
      "version": "COP-DEM-GLO-30-F"
    }
  ],
  "status": "success",
  "summary": "Austria: Solar orientation index: source-backed screening evidence was calculated successfully."
}