Positioning

DatatypeDraftv1.0.0-rc.2

A positioning: how a position was obtained and how accurate it is. It holds the method, the time, the accuracy in metres and what the position rests on. The accuracy is absolute positional accuracy, as in ISO 19157.

https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Positioning.json

Fields

  • method
    Code fromcore/positioning_methods

    How the position was obtained, such as surveyed, gnss_rtk or digitized.

  • horizontalAccuracy
    numberat least 0

    The horizontal accuracy, in metres: the true position is within this distance of the coordinates, at the confidence level. For a shape, it applies to each position.

  • verticalAccuracy
    numberat least 0

    The accuracy of the height, in metres: the true height is within this distance of the stated height, at the confidence level.

  • confidenceLevel
    numbermore than 0

    The confidence level of the accuracies, in percent, such as 95. Leave it out when the origin of the accuracy does not state it.

  • determinedAt
    date-time (RFC 3339)

    When the position was obtained.

  • evidence
    Id ofEvidence

    The evidence that the position rests on, such as a survey.

  • citation
    DatatypeCitation

    The published work or dataset that the position comes from, with its edition.

  • description
    text

    Anything else about how the position was obtained, in words.

Links

Points at Records whose ids this record holds, with the field that holds each.

Held by Records that embed this one, with their field that holds it.

Examples

An id that another example defines opens that record.

Example 3

{
  "method": "digitized",
  "horizontalAccuracy": 5,
  "citation": {
    "title": "Orthophoto of Red Deer County",
    "edition": "2025"
  },
  "description": "Traced from the orthophoto at a scale of 1:2,000."
}
Show 2 more examples

Example 1

{
  "method": "unknown"
}

Example 2

{
  "method": "gnss_rtk",
  "horizontalAccuracy": 0.02,
  "verticalAccuracy": 0.03,
  "confidenceLevel": 95,
  "determinedAt": "2026-07-02T10:15:00-06:00"
}

Changes and file

Changes

  1. 0.1.0 First version.

Schema file

Show the JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Positioning.json",
  "title": "Positioning",
  "description": "A positioning: how a position was obtained and how accurate it is. It holds the method, the time, the accuracy in metres and what the position rests on. The accuracy is absolute positional accuracy, as in ISO 19157.",
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "pattern": "^[a-z0-9]+(_[a-z0-9]+)*(\\.[a-z0-9]+(_[a-z0-9]+)*)*$",
      "x-ods-vocabulary": "core/positioning_methods",
      "description": "How the position was obtained, such as `surveyed`, `gnss_rtk` or `digitized`."
    },
    "horizontalAccuracy": {
      "type": "number",
      "minimum": 0,
      "description": "The horizontal accuracy, in metres: the true position is within this distance of the coordinates, at the confidence level. For a shape, it applies to each position."
    },
    "verticalAccuracy": {
      "type": "number",
      "minimum": 0,
      "description": "The accuracy of the height, in metres: the true height is within this distance of the stated height, at the confidence level."
    },
    "confidenceLevel": {
      "type": "number",
      "exclusiveMinimum": 0,
      "exclusiveMaximum": 100,
      "description": "The confidence level of the accuracies, in percent, such as 95. Leave it out when the origin of the accuracy does not state it."
    },
    "determinedAt": {
      "type": "string",
      "format": "date-time",
      "description": "When the position was obtained."
    },
    "evidence": {
      "type": "string",
      "minLength": 1,
      "x-ods-ref": "Evidence",
      "description": "The evidence that the position rests on, such as a survey."
    },
    "citation": {
      "$ref": "Citation.json",
      "description": "The published work or dataset that the position comes from, with its edition."
    },
    "description": {
      "type": "string",
      "description": "Anything else about how the position was obtained, in words."
    }
  },
  "patternProperties": {
    "^x-": {}
  },
  "unevaluatedProperties": false,
  "examples": [
    {
      "method": "unknown"
    },
    {
      "method": "gnss_rtk",
      "horizontalAccuracy": 0.02,
      "verticalAccuracy": 0.03,
      "confidenceLevel": 95,
      "determinedAt": "2026-07-02T10:15:00-06:00"
    },
    {
      "method": "digitized",
      "horizontalAccuracy": 5,
      "citation": {
        "title": "Orthophoto of Red Deer County",
        "edition": "2025"
      },
      "description": "Traced from the orthophoto at a scale of 1:2,000."
    }
  ],
  "x-ods-status": "draft",
  "x-ods-kind": "datatype",
  "x-ods-module": "core",
  "x-ods-changes": {
    "0.1.0": "First version."
  }
}