Docs / Schemas / geolocation / 0.3.0

Geolocation 0.3.0

Represent a geographic feature. Defines a subset of GeoJSON (RFC 7946) optimized for predictable parsing and indexing. It restricts the root to a single 'Feature', supports all fixed-depth geometries (Point, Polygon, Multi-types), and enforces flat properties to prevent recursion and nesting attacks.

This is an older version of geolocation.

The latest version is 0.8.0. Releases before 0.7.0 use the $id https://dorsalhub.com/schemas/open/geolocation and are served by DorsalHub.

$id

https://dorsalhub.com/schemas/open/geolocation

Latest

https://oatschema.org/geolocation

Versions

Source

v0.3.0 on GitHub

Schema

geolocation.json Raw

{    "x-license": {        "id": "Apache-2.0",        "notice": "Copyright 2025-2026 Dorsal Hub LTD",        "url": "https://github.com/dorsalhub/open-validation-schemas/blob/main/LICENSE"    },    "$schema": "https://json-schema.org/draft/2020-12/schema",    "$id": "https://dorsalhub.com/schemas/open/geolocation",    "title": "Geolocation",    "version": "0.3.0",    "description": "Represent a geographic feature. Defines a subset of GeoJSON (RFC 7946) optimized for predictable parsing and indexing. It restricts the root to a single 'Feature', supports all fixed-depth geometries (Point, Polygon, Multi-types), and enforces flat properties to prevent recursion and nesting attacks.",    "type": "object",    "properties": {        "type": {            "const": "Feature"        },        "id": {            "description": "A unique identifier for the feature.",            "anyOf": [                { "type": "string", "maxLength": 128 },                { "type": "number" }            ]        },        "bbox": { "$ref": "#/$defs/bbox" },        "geometry": {            "description": "The geometry of the feature. Uses WGS 84 coordinate reference system.",            "anyOf": [                { "type": "null" },                {                    "title": "Point",                    "type": "object",                    "properties": {                        "type": { "const": "Point" },                        "coordinates": { "$ref": "#/$defs/position" },                        "bbox": { "$ref": "#/$defs/bbox" }                    },                    "required": ["type", "coordinates"],                    "additionalProperties": { "$ref": "#/$defs/foreign-member" }                },                {                    "title": "LineString",                    "type": "object",                    "properties": {                        "type": { "const": "LineString" },                        "coordinates": {                            "type": "array",                            "items": { "$ref": "#/$defs/position" },                            "minItems": 2,                            "maxItems": 10000                        },                        "bbox": { "$ref": "#/$defs/bbox" }                    },                    "required": ["type", "coordinates"],                    "additionalProperties": { "$ref": "#/$defs/foreign-member" }                },                {                    "title": "Polygon",                    "type": "object",                    "properties": {                        "type": { "const": "Polygon" },                        "coordinates": { "$ref": "#/$defs/polygon-coords" },                        "bbox": { "$ref": "#/$defs/bbox" }                    },                    "required": ["type", "coordinates"],                    "additionalProperties": { "$ref": "#/$defs/foreign-member" }                },                {                    "title": "MultiPoint",                    "type": "object",                    "properties": {                        "type": { "const": "MultiPoint" },                        "coordinates": {                            "type": "array",                            "items": { "$ref": "#/$defs/position" },                            "maxItems": 10000                        },                        "bbox": { "$ref": "#/$defs/bbox" }                    },                    "required": ["type", "coordinates"],                    "additionalProperties": { "$ref": "#/$defs/foreign-member" }                },                {                    "title": "MultiPolygon",                    "type": "object",                    "properties": {                        "type": { "const": "MultiPolygon" },                        "coordinates": {                            "type": "array",                            "items": { "$ref": "#/$defs/polygon-coords" },                            "maxItems": 1000                        },                        "bbox": { "$ref": "#/$defs/bbox" }                    },                    "required": ["type", "coordinates"],                    "additionalProperties": { "$ref": "#/$defs/foreign-member" }                }            ]        },        "properties": {            "description": "An object containing additional properties of the feature. Can be null.",            "anyOf": [                { "type": "null" },                {                    "type": "object",                    "properties": {                        "timestamp": {                            "type": "string",                            "format": "date-time",                            "maxLength": 128                        },                        "camera_make": {                            "type": "string",                            "maxLength": 128                        },                        "camera_model": {                            "type": "string",                            "maxLength": 128                        }                    },                    "maxProperties": 100,                    "additionalProperties": { "$ref": "#/$defs/foreign-member" }                }            ]        }    },    "required": [        "type",        "geometry",        "properties"    ],    "additionalProperties": { "$ref": "#/$defs/foreign-member" },    "$defs": {        "position": {            "type": "array",            "items": { "type": "number" },            "minItems": 2,            "maxItems": 3,            "description": "A single position [longitude, latitude, optional altitude]."        },        "linear-ring": {            "type": "array",            "items": { "$ref": "#/$defs/position" },            "minItems": 4,            "maxItems": 10000        },        "polygon-coords": {            "type": "array",            "items": { "$ref": "#/$defs/linear-ring" },            "maxItems": 100        },        "bbox": {            "description": "A bounding box array (RFC 7946, Section 5).",            "type": "array",            "items": { "type": "number" },            "minItems": 4,            "maxItems": 6        },       "foreign-member": {            "description": "Constrained definition of RFC 7946 Foreign Members.",            "anyOf": [                { "type": "string", "maxLength": 2048 },                { "type": "number" },                { "type": "boolean" },                { "type": "null" },                {                     "type": "array",                     "maxItems": 100,                    "items": {                         "anyOf": [                             { "type": "string", "maxLength": 1024 },                             { "type": "number" },                             { "type": "boolean" }                        ]                    }                },                {                     "type": "object",                     "maxProperties": 20,                    "additionalProperties": {                        "anyOf": [                            { "type": "string", "maxLength": 2048 },                            { "type": "number" },                            { "type": "boolean" },                            { "type": "null" }                        ]                    }                }            ]        }    }}

Fields

type constant "Feature" required
id string | number

A unique identifier for the feature.
- string: at most 128 characters
bbox bbox
geometry null | object required

The geometry of the feature. Uses WGS 84 coordinate reference system.
Any of these forms:
1. null
2. Point object
  - type constant "Point" required
  - coordinates position required
  - bbox bbox
  - * foreign-member
    
    Any other key.
3. LineString object
  - type constant "LineString" required
  - coordinates array of position required
    - 2 to 10000 items
  - bbox bbox
  - * foreign-member
    
    Any other key.
4. Polygon object
  - type constant "Polygon" required
  - coordinates polygon-coords required
  - bbox bbox
  - * foreign-member
    
    Any other key.
5. MultiPoint object
  - type constant "MultiPoint" required
  - coordinates array of position required
    - at most 10000 items
  - bbox bbox
  - * foreign-member
    
    Any other key.
6. MultiPolygon object
  - type constant "MultiPolygon" required
  - coordinates array of polygon-coords required
    - at most 1000 items
  - bbox bbox
  - * foreign-member
    
    Any other key.
properties null | object required

An object containing additional properties of the feature. Can be null.
Any of these forms:
1. null
2. object
  - at most 100 properties
  - timestamp string
    - at most 128 characters
    - format date-time
  - camera_make string
    - at most 128 characters
  - camera_model string
    - at most 128 characters
  - * foreign-member
    
    Any other key.
* foreign-member

Any other key.

Definitions

position array of number

A single position [longitude, latitude, optional altitude].
- 2 to 3 items
linear-ring array of position
- 4 to 10000 items
polygon-coords array of linear-ring
- at most 100 items
bbox array of number

A bounding box array (RFC 7946, Section 5).
- 4 to 6 items
foreign-member string | number | boolean | null | array of string | number | boolean | object

Constrained definition of RFC 7946 Foreign Members.
Any of these forms:
1. string
  - at most 2048 characters
2. number
3. boolean
4. null
5. array of string | number | boolean
  - at most 100 items
  - each string: at most 1024 characters
6. object
  - at most 20 properties
  - * string | number | boolean | null
    
    Any other key.
    - string: at most 2048 characters