34
Copyright © 2014 Open Geospatial Consortium
o in case of subscriptions it returns the possible parameters to set for
specifying the scope of the subscription e.g.: area of interest, expiration date, etc..
See §7.3.3.
Submit, which allows either submitting an order of products from EO catalogue
or subscribing to a subscription see §7.4.3. This operation is “asynchronous” meaning that it starts the activation of the
ordering process and returns a quick acknowledge reporting whether the submitted order has been accepted or not.
To verify whether the order has been successfully completed and to retrieve produced products, dedicated operations have to be called later on.
GetStatus, which allows to retrieve either the status of submitted orders or the
status of subscribed subscriptions see §7.4.3.
DescribeResultAccess, which allows accessing the ordered products ready for
download see §7.5.3.
Cancel allows either to ask the cancellation of an already submitted order or to
unsubscribe a subscription see §7.4.3. This operation is “asynchronous” meaning that it starts the activation of the
cancellation process and returns a quick acknowledge reporting whether the cancellation request has been accepted or not. To understand whether the order
has been actually cancelled, the GetStatus operation has to be called later on.
6.2 Resource View of ROSEO
From “Resource” perspective, this specification is composed of the following resources:
Service Metadata: It describes the service capabilities, supported operations,
supported collections, and other service capabilities see §7.2. The following HTTP methods are supported:
o GET : it returns the service metadata of the server.
Order Options: it specifies all possible valid combinations of options for
ordering a specific product, or for ordering products of a specified EO Product collection or for subscribing to a subscription see §7.3.
The following HTTP methods are supported: o
GET options{eo:identifier}: it returns the order options possible for that
product. Same as GetOptions in the RPC view.
eo:identifier is the identifier of a EO Product as specified in OGC 13-026. eo refers to the following namespace:
35
Copyright © 2014 Open Geospatial Consortium
http:a9.com-opensearchextensionseo1.0 o
GET options{collection identifier}: it returns the order options possible
for all products of that collection. Same as GetOptions in the RPC view.
o GET options{subscription identifier}: it returns the order options
possible for subscribing to that subscription. Same as GetOptions in the RPC view.
Order: it is an order submitted by the client. It includes the ordered products with
the selected options in case of Product Orders, or a single subscription with the selected subscription options see §7.4.
The following HTTP methods are supported: o
POST order: it creates an order from the XML payload provided in the message body. The operation return the URL of the created order. Same as
Submit in the RPC view.
o GET order{order identifier}: it returns the XML representation of the
order with the specified identifier. Order status information are returned with order itself. Same as GetStatus in the RPC view.
o GET order?{filter expression}: it returns the XML representation of the
list of orders complying with the specified filter expression. Order status information are returned with order itself. Same as GetStatus in the RPC
view.
o DELETE order{order identifier}: it triggers cancellation of the order
having the specified identifier. Same as Cancel in the RPC view. For verifying whether the order has been actually cancelled, the GET method
on the same identifier has to be called in order to check the current order status.
Order Item: it is not a resource on its own, but it is a sub-element of an order: it
is a single item ordered within a previously submitted order see §7.4. The following HTTP methods are supported:
o GET order{order identifier}{order item identifier}: it returns the XML
representation of the order item within the specified order. Order status information are returned with order itself. Similar to GetStatus in the RPC
view, but it adds also the possibility to select the items within an order.
Ordered Product: it is a single EO product delivered by an order. In case of
Product Orders there is a 1:1 mapping between order item and EO Product; in case of subscription order, plenty of products in different time instants are
delivered from a single order item see §7.5.
The following HTTP methods are supported: o
GET order{order identifier}file: it returns the list of all product download URLs delivered for that order. Similar to
DescribeResultAccess in the RPC view.
36
Copyright © 2014 Open Geospatial Consortium
o GET order{order identifier}file?{filter expression}: it returns the list of
all product download URLs delivered for that order since a specified date time. Similar to DescribeResultAccess in the RPC view.
o GET order{order identifier}{order item identifier}file: it returns the
ordered product file.
6.3 Essential Use-cases 6.3.1 Ordering from catalogue of EO Products
