blog @kimromi

郵便番号から住所を取得するgemを書いた(ローマ字あり)

2016-04-09 Sat

郵便番号から住所を取得するgemを書きました。いろいろなgemを探してみたのですが、ローマ字に対応していなかったので、ローマ字表記にも対応しています。

https://github.com/kimromi/jp_zip_code

使い方

address = JpZipCode.search '100-0001'

address.pref_code     # => 13
address.pref_kanji    # => 東京都
address.city_kanji    # => 千代田区
address.town_kanji    # => 千代田
address.pref_kana     # => トウキョウト
address.city_kana     # => チヨダク
address.town_kana     # => チヨダ
address.pref_roman    # => Tokyo-To
address.city_roman    # => Chiyoda-Ku
address.town_roman    # => Chiyoda
address.zip_code      # => 1000001

JpZipCode.search '1000001'  # ハイフンなしOK
JpZipCode.search 1000001    # 数値OK

郵便番号データはjsonで格納しています。情報が古くなってきて、更新したくなった場合に以下でjsonを更新できます。(ちょっと時間かかります)

JpZipCode.update

郵便番号データ参照元

郵便番号情報の参照元は日本郵便です。以下のページからファイルを取得しています。

漢字、カタカナのデータ

読み仮名データの促音・拗音を小書きで表記するもの(zip形式) : 日本郵政

ローマ字のデータ

住所の郵便番号(ローマ字・zip形式)

所感

30歳にして初めてgemを公開しました。自分が担当しているサービスでも使っていくつもりなので、しっかりメンテナンスしていこうと思います。 TravisCIのテスト結果とかCode Climateのバッチとかつけるのが楽しかったです。これからもいろいろ書いてくぞ!