opengeospatial / opengeospatial/CRS-JSON-Encoding
Definition of "usages" and "usage"
Nobody has claimed this yet.
- Dominant language
- Makefile
- Stars
- 0
- Forks
- 2
- Avg merge
- 1h 36m
- Merged PRs (30d)
- 3
Description
NOTE: Markdown does not support highlighting in color, so bold/italic has been used to highlight the material being discussed. This issue is extracted from the document submitted by Roger Lott at https://github.com/opengeospatial/CRS-JSON-Encoding/blob/main/ProjJson%20v0-7%20RL%202024-06-16.docx for discussion at the CRS SWG meeting OGC held during the Montreal June 2024 TC meeting.
"usages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"scope": { "type": "string" },
"area": { "type": "string" },
"bbox": { "$ref": "#/definitions/bbox" },
"vertical_extent": { "$ref": "#/definitions/vertical_extent" },
"temporal_extent": { "$ref": "#/definitions/temporal_extent" }
},
"additionalProperties": false
}
},
"$comment": "[RL] In ISO 19111 a usage must contain one scope and one extent. (See below for extent). The main geodetic entities (CRS, datum, all types of coordinate operation) should have at least one and may have many usages. Should the schema be something like Usage below?"
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"scope": { "type": "string" },
"extent": { "$ref": "#/definitions/extent" },
},
"required" : [ "scope", "extent" ],
"additionalProperties": false
}
},
"$comment": "[RL]In ISO 19111 a usage is optional but (in §8.1.4) at least one usage is recommended. If this is considered best practice for geodetic registries, should the cardinality of Usage in CRS JSON be 1:* ?"
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the linked ProjJson v0-7 document and the schema examples in this issue, then review the cited ISO 19111 requirements. Resolve how “usages” and “usage” should be defined, including required scope and extent fields and cardinality; done means the specification has an agreed schema and terminology.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- json
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100