Advertise request KVP encoding Advertise request XML encoding mandatory

Figure 15: Advertise element in XMLSpy notation 11.2 Advertise operation request 11.2.1 Advertise request parameters This table also specifies the UML model data type, source of values, and multiplicity of each listed parameter, plus the meaning to servers when each optional parameter is not included in the operation request. Although some values listed in the “Name” column appear to contain spaces, they shall not contain spaces. Table 7 — Parameters in Advertise operation request Name a Definition Data type and values Multiplicity and use service Service type identifier Character String type, not empty Value is OWS type abbreviation “SAS” One mandatory version Specification version for operation Character String type, not empty Value is specified by each Implementation Specification and Schemas version One mandatory FeatureOfInterest see Subclause 9 String One mandatory OperationArea see Subclause 9 complex One mandatory AlertFrequency Frequency the alerts will be send in “alerts per second” double One mandatory DesiredPublicationExp iration see Subclause 9 String One mandatory AlertMessageStructure see Subclause 9 complex One mandatory a The name capitalization rules being used here are specified in Subclause 11.6.2 of [OGC 05-008]. The “Multiplicity and use” columns in all tables specify the optionality of each listed parameter and data structure in the Advertise operation request. All the “mandatory” parameters and data structures shall be implemented by all SAS clients, using a specified values. Similarly, all the “mandatory” parameters and data structures shall be implemented by all SAS servers, checking that each request parameter or data structure is received with any specified values.

11.2.2 Advertise request KVP encoding

KVP encoding is not supported. 26 Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved.

11.2.3 Advertise request XML encoding mandatory

All SAS servers shall implement HTTP POST transfer of the Advertise operation request, using XML encoding only. The following schema fragment specifies the contents and structure of an Advertise operation request encoded in XML: See annex B sasAdvertise.xsd. EXAMPLE An example Advertise operation request XML encoded for HTTP POST is: ?xml version=1.0 encoding=UTF-8? Advertise xmlns = http:www.opengis.netsas xmlns:xsi = http:www.w3.org2001XMLSchema- instance xsi:schemaLocation = http:www.opengis.netsas ..sasAll.xsd xmlns:swe = http:www.opengis.netswe service = SAS version = 1.0.0 FeatureOfInterest Name Muenster Name Description The temperature is measured by a sensor which is mounted at a weather station located on the roof of the IFGI in Muenster Description FeatureOfInterest OperationArea swe:GeoLocation swe:longitude swe:Quantity 51.96 swe:Quantity swe:longitude swe:latitude swe:Quantity 7.607 swe:Quantity swe:latitude swe:altitude swe:Quantity 78 swe:Quantity swe:altitude swe:GeoLocation OperationArea AlertMessageStructure QuantityProperty Content definition = urn:ogc:temperature uom = urn:ogc:foo:degree_Celsius min = max = 40 QuantityProperty AlertMessageStructure AlertFrequency 0.1 AlertFrequency DesiredPublicationExpiration 2007-10-30T00:00:00Z DesiredPublicationExpiration Advertise Listing 3: Example Advertise 11.3 Advertise operation response 11.3.1 Normal response parameters The normal response to a valid Advertise operation request shall be an AdvertiseResponse . More precisely, a response from the Advertise operation shall include the parts shown in the following figure. Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. 27 Figure 16: AdvertiseResponse element in XMLSpy notation Figure 17: AdvertiseResponse element in UML notation Table 8: Parameters in AdvertiseResponse Name Definition Data type and values Multiplicity and use expires Defines the time until the option to advertise will expire. This enables SAS to close abandoned MUCs. Double; the value follows ISO 8601:2000, i.e. YYYY-MM- DDTHH-MM-SS+- hh:mm One mandatory PublicationID Unique identifier, provided by SAS ID One mandatory 28 Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. XMPPURI Subscription endpoint where the sensor has to register using XMPP to publish alerts URI One mandatory

11.3.2 Normal response XML encoding