NAME

WebService::SOS - a module for interfacing with an OpenGIS Sensor Observation Service (SOS)

SYNOPSIS

 use WebService::SOS;

 my $sosclient = WebService::SOS->new( server_url => 'http://someserver.com/path/to/sos/server' );

 my $cap = $sosclient->GetCapabilities();

 my $desc = $sosclient->DescribeSensor($procedure);

 my $obs = $sosclient->GetObservation($offering,$observedProperty,$beginTime,$endTime);

DESCRIPTION

This module provides methods for interfacing with an OpenGIS Sensor Observation Service (SOS).

• GetCapabilities
  • get the capabillities
• DescribeSensor
  • describe a sensor
• GetObservation
  • get an observation

METHODS

new(%args)

 $sosclient = WebService::SOS->new( server_url => 'http://somehost.com/path/to/sos/server' );

options:

server_url - full url to the sos web service server (required)

method - can be "post" (default) or "get"

debug - set to 1 to get some debugging output on STDERR

GetCapabilities()

 $cap = $sosclient->GetCapabilities();

this method takes no options

DescribeSensor($procedure)

 $desc = $sosclient->DescribeSensor($procedure);

options:

$procedure - the sensor to query (AllowedValues are specified in response from GetCapabilities())

GetObservation($offering,$observedProperty,$beginTime,$endTime)

options:

$offering - the sensor to query (AllowedValues are specified in response from GetCapabilities())

$observedProperty - the property to query for (AllowedValues are specified in response from GetCapabilities())

$beginTime - the start of the time range for which you want to query (in ISO 8601 date and time format)

$endTime - the end of the time range for which you want to query (in ISO 8601 date and time format)

ERRORS

This module clucks on all errors.

SEE ALSO

http://www.opengeospatial.org/standards/sos - documentation on the OpenGIS SOS standard

http://www.iso.org/iso/date_and_time_format - ISO 8601 date and time format

SOURCE REPOSITORY

http://github.com/jamescdavis/WebService-SOS

AUTHOR

James C. Davis, <jdavis@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2011 by James C. Davis

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.