NAME

WebService::Recruit::Jalan - A Interface for Jalan Web Service

SYNOPSIS

            

              
              
use WebService::Recruit::Jalan;
my $jalan = WebService::Recruit::Jalan->new();
$jalan->key( 'xxxxxxxxxxxxxx' );
my $res = $jalan->HotelSearchAdvance( s_area => '260502' );
my $list = $res->root->Hotel;
foreach my $hotel ( @$list ) {
    print "HotelID: ",   $hotel->HotelID, "\n";
    print "HotelName: ", $hotel->HotelName, "\n";
}
            
          

DESCRIPTION

This module is a interface for the Jalan Web Service, produced by Recruit Co., Ltd., Japan. It provides five API methods: "HotelSearchLite", "HotelSearchAdvance", "AreaSearch", "OnsenSearch" and "StockSearch".

METHODS

new

This is the constructor method for this class.

            

              
              
my $jalan = WebService::Recruit::Jalan->new();
            
          

This accepts optional parameters.

            

              
              
my $conf = { key => 'your_auth_key', utf8_flag => 1 };
my $jalan = WebService::Recruit::Jalan->new( %$conf );
            
          

key

A valid developer key is required to make a request.

            

              
              
$jalan->key( 'your_auth_key' );
            
          

HotelSearchLite

This makes a request for HotelSearchLite API. See WebService::Recruit::Jalan::HotelSearchLite for details.

            

              
              
my $res = $jalan->HotelSearchLite( s_area => '162612' );
            
          

HotelSearchAdvance

This makes a request for HotelSearchAdvance API. See WebService::Recruit::Jalan::GetLandmark for details.

            

              
              
my $res = $jalan->HotelSearchAdvance( s_area => '260502' );
            
          

AreaSearch

This makes a request for AreaSearch API. See WebService::Recruit::Jalan::AreaSearch for details.

            

              
              
my $res = $jalan->AreaSearch( reg => 15 );
            
          

OnsenSearch

This makes a request for OnsenSearch API. See WebService::Recruit::Jalan::OnsenSearch for details.

            

              
              
my $res = $jalan->OnsenSearch( s_area => '141602' );
            
          

StockSearch

This makes a request for StockSearch API. See WebService::Recruit::Jalan::StockSearch for details.

            

              
              
my $res = $jalan->StockSearch( lon_jgd => 139.758, lat_jgd => 35.666 );
            
          

utf8_flag / user_agent / lwp_useragent / http_lite

This modules uses XML::TreePP module internally. Following methods are available to configure it.

            

              
              
$jalan->utf8_flag( 1 );
$jalan->user_agent( 'Foo-Bar/1.0 ' );
$jalan->lwp_useragent( LWP::UserAgent->new() );
$jalan->http_lite( HTTP::Lite->new() );
            
          

SEE ALSO

http://jws.jalan.net/

AUTHOR

Yusuke Kawasaki http://www.kawa.net/

This module is unofficial and released by the author in person.

COPYRIGHT AND LICENSE

Copyright (c) 2007 Yusuke Kawasaki. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm WebService::Recruit::Jalan

perl -MCPAN -e shell
install WebService::Recruit::Jalan