Ortwerk
plus code
Own implementation of the Open Location Code specification (github.com/google/open-location-code, Apache-2.0) with integer arithmetic; degrees are converted with exact decimal arithmetic, so the official encoding, decoding, validity and short-code test data (2026) pass completely. Returns the code area (south-west and north-east corner, centre, approximate cell size in metres). Short codes are recovered to the nearest matching full code around the reference point; full codes can be shortened.
POST https://ort.halowerk.com/v1/plus-codeInputs
| Field | Type | Required | Description |
|---|---|---|---|
| points | array | No | Coordinates to encode. |
| codes | array | No | Full or short Plus Codes to decode. |
| code_length | integer | No | Digits for encoding (even below 10; 10 ≈ 14 m, 11 ≈ 3 m). |
| reference | object | No | Reference point for shortening and recovering short codes. |
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
}
}
},
"description": "Coordinates to encode."
},
"codes": {
"type": "array",
"maxItems": 1000,
"items": {
"type": "string",
"minLength": 2,
"maxLength": 20
},
"description": "Full or short Plus Codes to decode."
},
"code_length": {
"type": "integer",
"minimum": 2,
"maximum": 15,
"default": 10,
"description": "Digits for encoding (even below 10; 10 ≈ 14 m, 11 ≈ 3 m)."
},
"reference": {
"type": "object",
"additionalProperties": false,
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
}
},
"description": "Reference point for shortening and recovering short codes."
}
}
}Published input example
{
"points": [
{
"lat": 52.212,
"lon": 7.042
}
],
"codes": [
"9F4794QR+"
],
"reference": {
"lat": 52.21,
"lon": 7.04
}
}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