Introduction Change Requests | OGC

Ordering Services for Earth Observation Products Interface Standard OGC 06-141r6 127 Copyright © 2012 Open Geospatial Consortium 9 GetOptions Operation

9.1 Introduction

This operation allows getting the possible options for preparing an EO products order or subscribing to EO products or submitting an order from a tasking request. Depending on the input parameters, this operation works in different ways: – Options by product identifiers Basic use case: order options are queried on product identifier basis. – Options by collection identifier Due to the fact that the collection identifiers can refer either a product collection or a subscription, 2 cases have been identified: – Product collection: In this case the operation returns options for ordering products from that collection. All products shall have the same options, otherwise an exception is thrown. – Subscription: Subscription options returned. – Options by tasking identifier When the tasking identifier is specified i.e.ID, which can refer to either a feasibility study or task submitted to SPS instance linked to this Ordering service, the operation returns the options available for ordering products starting from the acquisitions corresponding to the provided ID. The ID can refer different type of requests: – Precisely identifier acquisitions, i.e. acquisitions are identified by their key attributes e.g.: orbit and start and stop equator crossing times OR UTC start and stop times etc. – Coverage request, i.e. acquisitions are specified via the definition of the area to cover and the related time frame. – Standing request, similar to the previous one, but the coverage is performed several times with a defined periodicity. Returned options are structured in array of groups, each identified by the productOrderOptionsId and representing a valid combination of options e.g. one group can specify the options for getting a level 1 product, another group specifies options for getting another level 1 product, another for level 2 product, etc.. Each group includes mainly the following attributes: – Delivery options – Payment options – Scene selection options not applicable for subscriptions – Extensible list of options e.g.: processing level, product format. This list can be product specific and then the identifier of the product can be optionally specified. In case the client is an application provided with a user interface, then this operation is basically called for building the form where the user has to insert the values for finalizing the order. In this case, it is suggested to show the items in the same order as they are specified in the GetOptionsResponse message, and if there are several values for the same item, show the first item first. For example, when showing the delivery options, the client has to show the first instance of productDeliveryOptionsdeliveryMethod with the first instance of Ordering Services for Earth Observation Products Interface Standard OGC 06-141r6 128 Copyright © 2012 Open Geospatial Consortium productDeliveryOptionspackageMedium

9.2 Requirements