Yoshiki KURIHARA > HTTP-MobileAgent-Plugin-Locator-0.04 > HTTP::MobileAgent::Plugin::Locator

Download:
HTTP-MobileAgent-Plugin-Locator-0.04.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.04   Source  

NAME ^

HTTP::MobileAgent::Plugin::Locator - Handling mobile location information plugin for HTTP::MobileAgent

SYNOPSIS ^

    use CGI;
    use HTTP::MobileAgent;
    use HTTP::MobileAgent::Plugin::Locator;

    $q = CGI->new;
    $agent = HTTP::MobileAgent->new;

    # get location is Geo::Coordinates::Converter::Point instance formatted wgs84
    # ./t/* has many examples.
    $location = $agent->get_location( $q );
    # or
    $location = $agent->get_location( { lat => '35.21.03.342',
                                        lon => '138.34.45.725',
                                        geo => 'wgs84' } );
    # or
    $location = $agent->get_location( $q, { locator => $LOCATOR_GPS } );

    # get latitude and longitude
    print "lat is " . $location->lat;
    print "lng is " . $location->lng;

METHODS ^

get_location([params], $option_ref);

return Geo::Coordinates::Converter::Point instance formatted if specify gps or basic location parameters sent from carrier. The parameters are different by each carrier.

This method accepts a CGI-ish object (an object with 'param' method, e.g. CGI.pm, Apache::Request, Plack::Request) or a hashref of query parameters.

$option_ref->{locator}

select locator class algorithm option.

$LOCATOR_AUTO_FROM_COMPLIANT auto detect locator from gps compliant. This is default.

$LOCATOR_AUTO auto detect locator class from params.

$LOCATOR_GPS select GPS class.

$LOCATOR_BASIC select BasicLocation class.

gps_compliant()

returns if the agent is GPS compliant.

CLASSES ^

HTTP::MobileAgent::Plugin::Locator::DoCoMo::BasicLocation

for iArea data support.

HTTP::MobileAgent::Plugin::Locator::DoCoMo::GPS

for GPS data support.

HTTP::MobileAgent::Plugin::Locator::EZweb::BasicLocation

for basic location information data support.

HTTP::MobileAgent::Plugin::Locator::EZweb::GPS

for EZnavi data support.

HTTP::MobileAgent::Plugin::Locator::SoftBank::BasicLocation

for basic location information data support.

HTTP::MobileAgent::Plugin::Locator::SoftBank::GPS

for GPS data support.

HTTP::MobileAgent::Plugin::Locator::Willcom::BasicLocation

for basic location information data support.

EXAMPLES ^

There is request template using Template in eg directory and mod_rewrite configuration for ezweb extraordinary parameter handling.

COOK BOOK ^

HOW DO I GET iArea area code.
    use Geo::Coordinates::Converter::iArea;
    my $areacode = $agent->get_location($q)->converter('iarea')->areacode;
HOW DO I GET geohash.
    use Geo::Coordinates::Converter::Format::GeoHash;
    my $geohash = $ma->get_location(
        { lat => '35.21.03.342', lon => '138.34.45.725', geo => 'wgs84' },
    )->converter('wgs84', 'geohash')->geohash;

AUTHOR ^

Yoshiki Kurihara <kurihara __at__ cpan.org> with many feedbacks and changes from:

  Tokuhiro Matsuno E<lt>tokuhirom __at__ gmail.comE<gt>
  Masahiro Chiba E<lt>chiba __at__ geminium.comE<gt>

SEE ALSO ^

HTTP::MobileAgent, Geo::Coordinates::Converter, Geo::Coordinates::Converter::Point, Geo::Coordinates::Converter::iArea, http://coderepos.org/share/log/lang/perl/HTTP-MobileAgent-Plugin-Locator/

LICENCE ^

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

syntax highlighting: