1. CEOS Open Search Best Practices Doug Newman (NASA ECHO) CWIC January 2014

2. The CEOS best practices 1.Conform to the Open Search Specification 2.Conform to the OGC Specification 3.Take pertinent ideas from ESIP best practices 4.Add our own recommendations Such as, Make best attempt at coercing clients to provide client ids Extend ESIP ‘two step’ idea to link IDN dataset -> CWIC granule searching Embrace hypermedia Navigation by ‘self’, ‘next’, ‘prev’ Media types Achieve a ‘programmatic client’ where possible. Relevance Utilizing the parameter extension for better clarity of service Spatial (MBR) and temporal (Dublin Core) extent representation

3. How it will look in theory

4. Visualization HTTP Response CWIC Dataset 1 CWIC Dataset 2 Metadata Link Data Link Search Link Metadata Link Data Link Search Link HTTP GET Request IDN CWIC OSDD HTTP Response Granule 1 Granule 2 Metadata Link Data Link Browse Link Metadata Link Data Link Browse Link HTTP GET Request CWIC OSDD for dataset 1

5. Open Search Descriptor Document ‘We essentially ignore everything except the URL element’ Chris Lynnes, ESIP Winter 2014 IDN - one OSDD exposing CWIC datasets (dynamic*) CWIC one OSDD for general granule queries one OSDD per dataset (dynamic*) for IDN coupling Obtain OSDD by URL with mandatory client id parameter Should we exercise draft 2 of the Open Search parameter extension? * Dynamic with respect to client id HTTP GET domain/opensearch/resource(s)/descriptor_document.xml?clientId=d

6. Request HTTP GET domain/opensearch/resource(s).atom Free text os:searchTerms datasets.atom?keyword=MODIS Spatial geo:box, (geo:geometry) granules.atom?boundingBox=-180.0,-90.0,180.0,90.0 granules.atom?geometry=POINT (-5 -5) granules.atom?geometry=LINESTRING (5 5, 4 4) granules.atom?geometry=POLYGON ((30 10, 10 20, 40 40, 30 10)) Temporal time:startTime, time:endTime datasets.atom?startTime=2001-01-01T22:00:00Z datasets.atom?endTime=2001-01-01T22:00:00Z Traversal os:pageNumber, os:numberOfResults granules.atom?pageNumber=1&numberOfResults=10

7. Response (1 of 3) Navigation 3404 10 2

8. Response (2 of 3) Navigation … http://idn.gov/opensearch/datasets/1234 bar.gov/opensearch/granules/d escriptorDocument?datasetId=1234&client=d … …

9. Response (2 of 3) Content ID – resolvable URI cwic.gov/foo?uid=Landsat_8:LC81240182014014LGN00 Spatial Extent – MBR bounding box -1.05426 104.36788 1.04721 106.41068 Temporal Extent – Dublin Core date 2014-01-14T03:11:45Z/2014-01-14T03:12:17Z Links – Data: – Metadata: – Browse: – Documentation: – Alternate:

10. Challenges Maintaining coupling between IDN and CWIC Interpretation of existing Open Search implementations Handling specification divergence Programmatic client from specification- compliant implementations Should we use the parameter extension? Ranking

11. Questions