Collections extent: outdated multi extent description and pointing to GitHub rather than beta.schemas

[jerstlouis]

The schema at http://beta.schemas.opengis.net/ogcapi/common/part2/0.1/collections/openapi/schemas/extent.yaml does not include the clarifications on how multiple extents bbox should be interpreted. (Same applies for https://github.com/opengeospatial/ogcapi-coverages/blob/master/standard/openapi/schemas/common-geodata/extent.yaml in Coverages)

The latest bbox clarifications are included in Features:

https://github.com/opengeospatial/ogcapi-features/blob/master/core/openapi/schemas/extent.yaml#L23

[ghobona]

The schema at beta.schemas.opengis.net is a snapshot of the OGC API - Common schemas as they were when OGC API - EDR was published. We needed a frozen/static version of the schema because it was referenced by the approved OGC API - EDR 1.0.0 Standard. So we placed the OGC API - Common schema in the beta.schemas.opengis.net repository, and labelled it as 0.1.

When OGC API - Common - Part 1 and 2 are published as approved standards, their schema will be placed on the main schemas.opengis.net site and labeled as 1.0.0.

[ghobona]

In other words, the OGC API - Common SWG should continue to use and update the schema that is on the SWG's GitHub repository.

[jerstlouis]

Thanks @ghobona . I think other draft specification also reference the beta schema though (that is how I got there: Common or Coverages) -- I thought the intent was to have something more up to date that can be referenced from somewhere else than GitHub repositories.

[ghobona]

We couldn't have an approved standard (EDR) reference a changing schema, so we mitigated that through the beta schema repo and the v0.1 labelling.

I will let the other OGC API SWGs know that they should use the OGC API - Common schema that is in the GitHub repo. Thanks.

[jerstlouis]

@ghobona @cmheazel There is still a valid issue to address so let's please keep this open:

• The schema at https://github.com/opengeospatial/ogcapi-common/blob/master/api_modules/extent/schemas/extent.yaml needs to be updated to reflect the changes in Features (sorry that was not clear from my original description)
• The references to beta.schemas.opengis.net in Common - Part 2 should be changed to point to GitHub

[jerstlouis]

@ghobona Could we please re-open the issue to address the above?

[ghobona]

Reopened at the request of @jerstlouis.

[cmheazel]

The Extent schema is now equivalent to the Extent schema in the Master branch of the OGC API - Features GitHub repository. The only difference is that the explanatory text in the Features version has not been carried over into the Common version.

[cmheazel]

Note: schema URIs will be updated at the next stable baseline.