Skip to content
HALOWERK

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-code

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
pointsarrayNoCoordinates to encode.
codesarrayNoFull or short Plus Codes to decode.
code_lengthintegerNoDigits for encoding (even below 10; 10 ≈ 14 m, 11 ≈ 3 m).
referenceobjectNoReference 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."
    }
  }
}

Open original schema

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

All endpoints in this hub →