[sdw] Defining "convenience API" (#1243)

lvdbrink has just created a new issue for https://github.com/w3c/sdw:

== Defining "convenience API"  ==
The OGC Architecture Board has been trying to define the term "convenience API". I pointed them to the description in https://www.w3.org/TR/sdw-bp/#convenience-apis. This could be the basis of their definition, but it seemed from the discussion I had with them that they were looking for a somewhat less narrow definition. 

I re-read the BP myself and think that the descriptions under **Why** and **Intended outcome** provide good input for a definition. 

Some key quotes from the BP: 
> tailored to meet a specific goal; enabling a user to engage with complex data structures using (a set of) simple queries

> provides a coherent set of queries and operations, including spatial ones, that help users get working with the data quickly to achieve common tasks. The API provides both machine readable data and human readable HTML markup. The human-readable markup will also support search engine's Web crawlers to enable indexing of spatial data.

... And there's more under **Possible approach for implementation**, although these are perhaps too specific for a definition - they are more like suggestions on how to make a spatial data API convenient: 

> well documented and easy to understand, both in terms of the options to access / filter the data and of the data structures that are returned

> Return data in chunks fit for use in Web applications and as useful sets of information.

>  simplifying the geometries

>  overly small pieces of data are inconvenient to use

> Support queries for Spatial Things based on user needs

Do we still think all these are aspects of (spatial) convenience APIs? Is there more? 

Please view or discuss this issue at https://github.com/w3c/sdw/issues/1243 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Tuesday, 26 January 2021 12:59:00 UTC