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

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.