GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  HTTP::MOBILEAGENT::PLUGIN::LOCATOR (3)

.ds Aq ’

NAME

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

CONTENTS

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], CW$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.

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 226: Expected text after =item, not a bullet
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 HTTP::MOBILEAGENT::PLUGIN::LOCATOR (3) 2011-02-08

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.