openreferral / api-specification

This is the working repository for Open Referral's Human Services Data API protocols.
https://openreferral.readthedocs.io/en/latest/hsda/
Other
29 stars 13 forks source link

Search services by taxonomy. #76

Closed kinlane closed 9 months ago

kinlane commented 6 years ago

This was submitted via a document by ISS:

Can you retrieve a list of services in more than child taxon, but excluding other child taxons? Ie under “childcare” you may have “general”, “special needs”, “before school”, “after school”. If a user wanted general + before, but did not need to see special or after school, would that require 2 taxon requests or just one?

kinlane commented 6 years ago

Also: Consider adding parameters for taxonomy, accreditation, jurisdictional support (eg veteran cards, low income support), geographic location, max distance from user, transport options etc.

NeilMcKLogic commented 5 years ago

I recommend a more simple boolean search parameter to indicate "search in child taxonomy terms" with possible values of True or False. Then you simply search at the most granular term for which you want results and for which the child terms are also relevant. Further, one should be able to supply more than one taxonomy term in which to search and then be able to indicate how they should be "booleaned" together: AND or OR.

These two different parameters in practice work very well in combination with each other in a multitude of different use cases I contributed to in the "real world".

kinlane commented 5 years ago

Will be applying the boolean search as part of the search service by taxonomy interface. Thanks @NeilMcKechnie

mrshll1001 commented 9 months ago

We will be arching this repository soon. We're closing this issue because we believe it has been conclusively addressed as part of work on the main HSDS standard.

In this case, the HSDS 3.0 /services endpoint may be queried with optional taxonomy and taxonomy_id parameters