NAME
    WWW::YahooJapan::KanaAddress - translating the address in Japan into
    kana.

SYNOPSIS
        use WWW::YahooJapan::KanaAddress;

        my $yahoo = WWW::YahooJapan::KanaAddress->new();
        print $yahoo->search('山梨県', '鰍沢町', '鳥屋'), "\n";

    results:

        やまなしけんかじかざわちょうとや

DESCRIPTION
    This class translates the address written in Kanji into Kana by using
    Yahoo! Japan Maps.

  Methods
    my $yahoo = WWW::YahooJapan::KanaAddress->new( ua => 'your
    LWP::UserAgent');
        a constructor. You can set a LWP::UserAgent object if you want.

    my ($kana_ken, $kana_shiku, $kana_choaza) = $yahoo->search($ken, $shiku,
    $choaza);
        search kana by Yahoo!Japan Maps. The arguments and return values
        must be unicode strings. ( You can no longer use euc-jp encoded
        strings from 0.20. )

        $ken
          Prefecture in Japan, should be ended with '都' or '道' or '府' or
          '県'.

        $shiku
          Name of city and district, should be ended with '市' or '区' or '町'
          or '村'.

        $choaza
          The rest of the string of address. It might contain '町' and '字'.

        You can use a vague address to some degree. For example:

            print $yahoo->search('茨城県', '龍ヶ崎市', '米町'), "\n";
            print $yahoo->search('茨城県', '龍崎市', '米町'), "\n";
            print $yahoo->search('茨城県', '竜が崎市', '米町'), "\n";

        These sentences output the same result. This is a function of
        Yahoo!Japan Maps.

CONFIGURATION AND ENVIRONMENT
    WWW::YahooJapan::KanaAddress requires no configuration files or
    environment variables.

DEPENDENCIES
    LWP::UserAgent, and Yahoo!Japan :-p

INCOMPATIBILITIES
    None reported.

BUGS AND LIMITATIONS
    No bugs have been reported.

    Please report any bugs or feature requests to "hiratara@cpan.org", or
    through the web interface at <http://rt.cpan.org>.

AUTHOR
    Masahiro Honma "<hiratara@cpan.org>"

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