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-georeferenceInputs
| Field | Type | Required | Description |
|---|---|---|---|
| image_base64 | string | No | Image (PNG/JPEG/WebP/GIF/TIFF/AVIF) as base64, ≤ 10 MB. |
| image_url | string | No | Or a public image URL. |
| control_points | array | Yes | Control points: px = column, py = row (original pixels) and map x, y. |
| epsg | integer | Yes | EPSG code of x/y (4326/4258 are lon/lat). |
| max_side | integer | No | Long side of the GeoTIFF; larger maps are downscaled (the transform is adjusted). |
| output | string | No | worldfile_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."
}
}
}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
- Bildwerk0.01 USDC
address plate blur
POSThttps://bild.halowerk.com/v1/address-plate-blurThe photo is read with Tesseract 5.3.4 (German + English, word boxes) at two scales and in sparse-text and block mode; small bright plaques with 1–5 dark characters (typical house-number signs) are additionally cut out and read one by one,
- Bildwerk0.003 USDC
ai disclosure metadata
POSThttps://bild.halowerk.com/v1/ai-disclosure-metadataChecks JPEG, PNG and WebP files for AI disclosure metadata: XMP DigitalSourceType and the IPTC Photo Metadata 2025.1 AI fields, C2PA/JUMBF stores (signatures are not validated), PNG text chunks and EXIF Software/UserComment, and returns a s
- Bildwerk0.008 USDC
animation to video
POSThttps://bild.halowerk.com/v1/animation-to-videoReads frame count, size, loop count and total duration from the file structure, then encodes with ffmpeg 6.1 in a child process under prlimit (no shell, empty environment, only the file protocol): GIF and APNG are demuxed natively, animated