JpPrefecture
https://rubygems.org/gems/jp_prefecture
jp_prefecture とは
都道府県コードと都道府県名を変換するライブラリです。
JIS X 0402 で定義されている都道府県コードをベースに、 ゼロから始まるものはゼロを削除して使用しています。
北海道: 01 -> 1
東京都: 13 -> 13
また、Rails のプラグインとして使用することもできます。
インストール
以下の行を Gemfile
に記述してから:
gem 'jp_prefecture'
bundle
を実行してください。
または、手動でインストールしてください:
$ gem install jp_prefecture
使い方
ライブラリの読み込み
require 'jp_prefecture'
都道府県コードから都道府県を検索
単純に都道府県コードを渡すと、都道府県コードから都道府県を検索します:
pref = JpPrefecture::Prefecture.find 13
# => #<JpPrefecture::Prefecture:0x007fd0a3d43fe8 @code=13, @name="東京都", @name_e="Tokyo">
pref.code
# => 13
pref.name
# => "東京都"
pref.name_e
# => "Tokyo"
以下のように渡すことも可能です:
JpPrefecture::Prefecture.find code: 13
都道府県名から都道府県を検索
JpPrefecture::Prefecture.find name: "東京都"
# => #<JpPrefecture::Prefecture:0x007ff672271800 @code=13, @name="東京都", @name_e="Tokyo">
JpPrefecture::Prefecture.find name: "Tokyo"
# => #<JpPrefecture::Prefecture:0x007fb3c2828b10 @code=13, @name="東京都", @name_e="Tokyo">
JpPrefecture::Prefecture.find name: "tokyo"
# => #<JpPrefecture::Prefecture:0x007f965c0c5a40 @code=13, @name="東京都", @name_e="Tokyo">
都道府県の一覧を取得
JpPrefecture::Prefecture.all
# => [#<JpPrefecture::Prefecture:0x007fd0a3d78d38 @code=1, @name="北海道", @name_e="Hokkaido">, ...]
Rails(ActiveRecord) で使用する
ActiveRecord::Base
を継承した Model で、都道府県コードを扱うことができます。
app/models/place.rb:
class Place < ActiveRecord::Base
# prefecture_code:integer
include JpPrefecture
jp_prefecture :prefecture_code
end
prefecture
というメソッドが生成され、都道府県コード、都道府県名が参照できるようになります:
place = Place.new
place.prefecture_code = 13
place.prefecture.name
# => "東京都"
生成されるメソッド名は method_name
というオプションで指定することができます:
# model
jp_prefecture :prefecture_code, method_name: :pref
place = Place.new
place.prefecture_code = 13
place.pref.name
# => "東京都"
テンプレートで使用する
collection_select
を使用して、都道府県のセレクトボックスを生成することができます。:
f.collection_select :prefecture_code, JpPrefecture::Prefecture.all, :code, :name
# 英語表記で出力
f.collection_select :prefecture_code, JpPrefecture::Prefecture.all, :code, :name_e
マイグレーション
カラムのタイプは integer
か string
で作成してください。
マイグレーションのサンプル:
class AddPrefectureCodeToPlaces < ActiveRecord::Migration
def change
add_column :places, :prefecture_code, :integer
end
end
都道府県のマッピング情報を変更する
デフォルトのマッピング情報以外のものを使用したい場合、以下のようにカスタマイズされた マッピングデータを指定することができます:
custom_mapping_path = "..." # /path/to/mapping_data
JpPrefecture.setup do |config|
config.mapping_data = YAML.load_file custom_mapping_path
end
マッピングデータのフォーマットについては prefecture.yml を参考にしてください。
ドキュメント
http://rdoc.info/github/chocoby/jp_prefecture/master/frames/index
TODO
GitHub の Issues を参照してください。
対象バージョン
- Ruby: 1.9.3 / 2.0.0 以上
- Rails: 3.2 系の最新
Ruby 1.8.7 のサポートは v0.1.1 で終了しました。
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
GitHub
https://github.com/chocoby/jp_prefecture