Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Abbreviation "OAPIF" offers potential for confusion #24

Open
jsaligoe opened this issue Jan 10, 2020 · 2 comments
Open

Abbreviation "OAPIF" offers potential for confusion #24

jsaligoe opened this issue Jan 10, 2020 · 2 comments

Comments

@jsaligoe
Copy link

The need for a shortened name for “OGC API Features” is apparent, and in the draft document “OAPIF” is used. However, this abbreviation is already used as the short name for the OGC API Features GDAL Driver https://gdal.org/drivers/vector/oapif.html and therefore could be confusing from a technical perspective to call it the same thing. Note also the discussion on naming convention provided in the implementation standard Abstract "That is, the title of this document in OGC is "OGC API - Features - Part 1:Core" and the title in ISO is "Geographic Information - Geospatial API for Features - Part 1: Core.""

For consideration, use a different abbreviation, such as "OGCAPI-F" or "GeoAPI-F".

@alexanderkotsev
Copy link
Contributor

Indeed, the name (OAPIF) that we use is not ideal. We would like to rely on the OGC for a shorter name and not introduce a new one ourselves. Proposals for OGC API names are already discussed in opengeospatial/ogcapi-common#35. Once the short names are officially confirmed by the OGC, we can go ahead and modify our document accordingly.

@heidivanparys
Copy link
Contributor

Still no resolution at OGC on the short names as far as I know. What we could do is spell the name out in the specification, or use the OGC document numbers as a reference (OGC 17-069r4, OGC 18-058, etc.). The use of OAPIF in the URIs is more tricky though.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants