Skip to content
HALOWERK

Bildwerk

map georeference

Least-squares affine fit x = a0 + a1·col + a2·row, y = b0 + b1·col + b2·row to at least 3 control points (pixel corner convention; x = lon, y = lat for geographic EPSG). Returns residuals, RMSE, corners, a world file (.tfw) and a deflate RGB GeoTIFF (GeoTIFF 1.0, OGC 19-008r4: PixelScale/Tiepoint or ModelTransformation, PixelIsArea, EPSG GeoKey), downscaled to max_side if needed. Affine only: large residuals mean wrong points or a projection change.

POST https://bild.halowerk.com/v1/map-georeference

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoImage (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB.
image_urlstringNoOr a public image URL.
control_pointsarrayYesControl points: px = column, py = row (original pixels) and map x, y.
epsgintegerYesEPSG code of x/y (4326/4258 are lon/lat).
max_sideintegerNoLong side of the GeoTIFF; larger maps are downscaled (the transform is adjusted).
outputstringNoworldfile_only skips the GeoTIFF and returns only transform, residuals and world file.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "control_points",
    "epsg"
  ],
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "Image (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Or a public image URL."
    },
    "control_points": {
      "type": "array",
      "minItems": 3,
      "maxItems": 100,
      "description": "Control points: px = column, py = row (original pixels) and map x, y.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "px",
          "py",
          "x",
          "y"
        ],
        "properties": {
          "px": {
            "type": "number"
          },
          "py": {
            "type": "number"
          },
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "id": {
            "type": "string",
            "maxLength": 40
          }
        }
      }
    },
    "epsg": {
      "type": "integer",
      "enum": [
        2056,
        3857,
        4258,
        4326,
        25832,
        25833,
        27700,
        31467,
        31468,
        32632,
        32633
      ],
      "description": "EPSG code of x/y (4326/4258 are lon/lat)."
    },
    "max_side": {
      "type": "integer",
      "minimum": 64,
      "maximum": 4096,
      "default": 1600,
      "description": "Long side of the GeoTIFF; larger maps are downscaled (the transform is adjusted)."
    },
    "output": {
      "type": "string",
      "enum": [
        "geotiff",
        "worldfile_only"
      ],
      "default": "geotiff",
      "description": "worldfile_only skips the GeoTIFF and returns only transform, residuals and world file."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAEAAAAAwAgMAAADcJZSMAAAACVBMVEXw6tiIpbxUgq7RR9vqAAAACXBIWXMAAAsTAAALEwEAmpwYAAAALElEQVQokWNgYHRggANGEJsuAqFhU0PhIGxqKKYAw8A4jGFUYDCER+ggTR8AspgtoXey9kgAAAAASUVORK5CYII=",
  "epsg": 25832,
  "control_points": [
    {
      "px": 8,
      "py": 8,
      "x": 500000,
      "y": 5600400
    },
    {
      "px": 56,
      "py": 8,
      "x": 500480,
      "y": 5600400
    },
    {
      "px": 8,
      "py": 40,
      "x": 500000,
      "y": 5600080
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →