Location
DatatypeDraftv1.0.0-rc.2
A location: one place, as a point with the heights that matter for it. A location can also state the place in other ways, such as a legal land description or a distance along a line, and a place that has no coordinates has only those. Coordinates are in GeoJSON order (x, y): longitude then latitude for EPSG:4326 (RFC 7946).
https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Location.json
Fields
pointobject, fields belowThe point, as a GeoJSON Point. Leave it out when the place has no coordinates: a reader does not make a point for it.
typeRequiredAlways"Point"Always
Point, as in GeoJSON.coordinatesRequired
crsrelativeHeightnumberThe height above the local ground, in metres (for example a receiver at 1.5 m).
absoluteHeightnumberThe height above the vertical datum of the crs, in metres.
positioningHow the point was obtained and how accurate it is.
geographicIdentifiersOther ways to state the place, such as a legal land description, a parcel id or a civic address.
linearReferenceThe place as a distance along a line, such as a kilometre post on a pipeline.
originalThe dataset that the point was converted from, and what the conversion changed.
- At least one of
point,geographicIdentifiersorlinearReference.
Forms
A value of this schema takes one of these forms.
Links
Held by Records that embed this one, with their field that holds it.
- ConditionEntitylocationA state of the surroundings over an area and a time, such as the ambient sound, the terrain, the weather or the water. Its properties come from a quantities vocabulary; which list holds it (ambient, terrain, weather or hydrology) says what sort it is.
- EvidenceEntitylocationOne observation, measured or calculated: what was observed, of which record, by which instrument or algorithm, over which interval, and the result. As in ISO 19156 (Observations and measurements).
- FeatureEntitylocationA natural or built object with a place and properties, such as a wellsite, a dwelling or a road. As in ISO 19101. A feature where a framework judges effects is a receptor and has a receptor class.
- GroupPartlocationFeatures that a project evaluates together as one unit, such as wellsites close to each other. A group has no sources of its own: its members carry them.
- PathPartEnd.locationEvent.locationA route from one place to another, with its line and the ordered events along it, such as a sound path from a source to a receptor or a plume's trajectory.
- ProjectEntitylocationA piece of work on one or more features, with its activities and groups. It refers to its features by id; the features themselves live in context.
- SourcePartlocationA part of a feature that emits, such as a compressor, an engine, a stack or an outfall. As in ISO 14224:2016, levels 6 to 8. A source can hold smaller sources, such as a compressor's engine and cooler.
- StructurePartlocationA built form, such as a building, a wall or a barrier. As in IFC (ISO 16739).
Examples
An id that another example defines opens that record.
Example 3
{
"point": {
"type": "Point",
"coordinates": [
-113.815,
52.268,
912.4
]
},
"crs": {
"code": "EPSG:4617",
"name": "NAD83(CSRS)",
"verticalDatum": "CGVD2013",
"verticalCode": "EPSG:6647",
"coordinateEpoch": 2010
},
"absoluteHeight": 912.4,
"positioning": {
"method": "gnss_rtk",
"horizontalAccuracy": 0.02,
"verticalAccuracy": 0.03,
"confidenceLevel": 95,
"determinedAt": "2026-07-02T10:15:00-06:00"
},
"geographicIdentifiers": [
{
"type": "legal_land_description",
"scheme": "ca.dls",
"value": "04-12-038-27W4"
}
],
"linearReference": {
"line": "feature-pipeline",
"distance": {
"amount": 12.4,
"unit": "km"
}
}
}Show 3 more examplesHide the other examples
Example 1
{
"point": {
"type": "Point",
"coordinates": [
-114.0719,
51.0447
]
},
"relativeHeight": 1.5
}Example 2
{
"point": {
"type": "Point",
"coordinates": [
-114.0719,
51.0447,
1045.2
]
},
"crs": {
"epsgCode": 4326,
"verticalDatum": "CGVD2013"
},
"absoluteHeight": 1045.2
}Example 4
{
"geographicIdentifiers": [
{
"type": "legal_land_description",
"scheme": "ca.dls",
"value": "04-12-038-27W4"
}
]
}Changes and file
Changes
- 0.1.0 First version.
Schema file
Show the JSON SchemaHide the JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Location.json",
"title": "Location",
"description": "A location: one place, as a point with the heights that matter for it. A location can also state the place in other ways, such as a legal land description or a distance along a line, and a place that has no coordinates has only those. Coordinates are in GeoJSON order (x, y): longitude then latitude for EPSG:4326 (RFC 7946).",
"type": "object",
"properties": {
"point": {
"type": "object",
"properties": {
"type": {
"const": "Point",
"description": "Always `Point`, as in GeoJSON."
},
"coordinates": {
"$ref": "Geometry.json#/$defs/Position"
}
},
"required": [
"type",
"coordinates"
],
"description": "The point, as a GeoJSON Point. Leave it out when the place has no coordinates: a reader does not make a point for it.",
"patternProperties": {
"^x-": {}
},
"unevaluatedProperties": false
},
"crs": {
"$ref": "Crs.json"
},
"relativeHeight": {
"type": "number",
"description": "The height above the local ground, in metres (for example a receiver at 1.5 m)."
},
"absoluteHeight": {
"type": "number",
"description": "The height above the vertical datum of the crs, in metres."
},
"positioning": {
"$ref": "Positioning.json",
"description": "How the point was obtained and how accurate it is."
},
"geographicIdentifiers": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "GeographicIdentifier.json"
},
"description": "Other ways to state the place, such as a legal land description, a parcel id or a civic address."
},
"linearReference": {
"$ref": "LinearReference.json",
"description": "The place as a distance along a line, such as a kilometre post on a pipeline."
},
"original": {
"$ref": "Original.json",
"description": "The dataset that the point was converted from, and what the conversion changed."
}
},
"anyOf": [
{
"properties": {
"point": true
},
"required": [
"point"
]
},
{
"properties": {
"geographicIdentifiers": true
},
"required": [
"geographicIdentifiers"
]
},
{
"properties": {
"linearReference": true
},
"required": [
"linearReference"
]
}
],
"patternProperties": {
"^x-": {}
},
"unevaluatedProperties": false,
"examples": [
{
"point": {
"type": "Point",
"coordinates": [
-114.0719,
51.0447
]
},
"relativeHeight": 1.5
},
{
"point": {
"type": "Point",
"coordinates": [
-114.0719,
51.0447,
1045.2
]
},
"crs": {
"epsgCode": 4326,
"verticalDatum": "CGVD2013"
},
"absoluteHeight": 1045.2
},
{
"point": {
"type": "Point",
"coordinates": [
-113.815,
52.268,
912.4
]
},
"crs": {
"code": "EPSG:4617",
"name": "NAD83(CSRS)",
"verticalDatum": "CGVD2013",
"verticalCode": "EPSG:6647",
"coordinateEpoch": 2010
},
"absoluteHeight": 912.4,
"positioning": {
"method": "gnss_rtk",
"horizontalAccuracy": 0.02,
"verticalAccuracy": 0.03,
"confidenceLevel": 95,
"determinedAt": "2026-07-02T10:15:00-06:00"
},
"geographicIdentifiers": [
{
"type": "legal_land_description",
"scheme": "ca.dls",
"value": "04-12-038-27W4"
}
],
"linearReference": {
"line": "feature-pipeline",
"distance": {
"amount": 12.4,
"unit": "km"
}
}
},
{
"geographicIdentifiers": [
{
"type": "legal_land_description",
"scheme": "ca.dls",
"value": "04-12-038-27W4"
}
]
}
],
"x-ods-status": "draft",
"x-ods-kind": "datatype",
"x-ods-module": "core",
"x-ods-changes": {
"0.1.0": "First version."
}
}