Ortwerk
maidenhead
Implements the IARU Maidenhead locator grid: field 20°×10° (A–R), square 2°×1° (0–9), subsquare 5′×2.5′ (a–x), extended square (0–9) and extended subsquare (a–x). Encoding uses exact decimal arithmetic so points on cell borders fall into the correct cell; decoding returns the south-west and north-east corners and the cell centre. The optional path computes the ellipsoidal distance (Vincenty, WGS84) and initial and reverse bearing between the two cell centres.
POST https://ort.halowerk.com/v1/maidenheadInputs
| Field | Type | Required | Description |
|---|---|---|---|
| points | array | No | |
| locators | array | No | |
| precision | integer | No | Characters of the generated locators. |
| path | object | No | Two locators for distance and bearing. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"points": {
"type": "array",
"maxItems": 1000,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
}
}
}
},
"locators": {
"type": "array",
"maxItems": 1000,
"items": {
"type": "string",
"minLength": 2,
"maxLength": 10
}
},
"precision": {
"type": "integer",
"enum": [
2,
4,
6,
8,
10
],
"default": 6,
"description": "Characters of the generated locators."
},
"path": {
"type": "object",
"additionalProperties": false,
"required": [
"from",
"to"
],
"properties": {
"from": {
"type": "string",
"minLength": 2,
"maxLength": 10
},
"to": {
"type": "string",
"minLength": 2,
"maxLength": 10
}
},
"description": "Two locators for distance and bearing."
}
}
}Published input example
{
"points": [
{
"lat": 52.212,
"lon": 7.042
}
],
"path": {
"from": "JO32",
"to": "JN58td"
}
}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
- Ortwerk0.01 USDC
area coverage
POSThttps://ort.halowerk.com/v1/area-coverageRuns one multi-source Dijkstra from all origins (Routing runs on HALOWERK's own graph of the German road and path network built from OpenStreetMap (Geofabrik germany-latest.osm.pbf, data until 2026-11-12, ODbL 1.0; 25 million nodes, edges a
- Ortwerk0.004 USDC
autobahn roadworks
POSThttps://ort.halowerk.com/v1/autobahn-roadworksFetches live roadworks (long- and short-term) and closures per motorway from the public Autobahn App API of Die Autobahn GmbH des Bundes (no key; https://verkehr.autobahn.de/o/autobahn). The free-text periods are parsed into concrete interv
- Ortwerk0.004 USDC
avalanche bulletin
POSThttps://ort.halowerk.com/v1/avalanche-bulletinFresh official WSL SLF CAAMLv6 JSON for one Swiss warning region, in de/en/fr/it with explicit actual-language fallback. Includes the complete unmodified bulletin, all elevation/aspect/time distinctions, publication and validity times, sour