Geo-Coder-Ja - README

NAME

Geo::Coder::Ja - geocoder.ja library module for Perl

SYNOPSIS

use Geo::Coder::Ja;

      my $geocoder = Geo::Coder::Ja->new(
          dbpath     => '/usr/local/share/geocoderja', # required
          load_level => DB_AUTO,  # optional. default DB_AUTO
          encoding   => 'UTF-8',  # optional. default 'SHIFT_JIS'
      );
      # same as $geocoder->geocode($location);
      my $location = $geocoder->geocode(location => $location);
      # $location->{latitude}
      # $location->{longitude}
      # $location->{address}
      # $location->{address_kana}

DESCRIPTION

This module is an interface for geocoder.ja library. It is available at: http://www.postlbs.org/postlbs-cms/ja/geocoder

METHODS
new(%options)
It should be called with following arguments (items with default value are optional)

      dbpath     => geocoder.ja's database files directory
      load_level => load level. must be DB_AUTO, DB_JUKYO, DB_GAIKU, DB_AZA, DB_CHO or DB_GYOSEI.
      encoding   => default 'SHIFT_JIS'. must be 'UTF-8', 'EUC-JP' or 'SHIFT_JIS'.

Returns an instance of this module.

geocode(%param)
geocode(location => $location) or geocode(postcode => $postcode) are supported.

Get latitude/longitude from the address or postcode.

Returns a hashref, contains the following fields:

      latitude
      longitude
      address
      address_kana

Returns undef if multiple candidates or failure.

encoding([$encoding])
Set/get encoding. $encoding must be 'UTF-8', 'EUC-JP' or 'SHIFT_JIS'.

AUTHOR

Jiro Nishiguchi <jiro@cpan.org>

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