ken-all

ken-all copied to clipboard

概要

日本郵便の提供する郵便番号データ(通称KEN_ALL.CSV)をパースし、使いやすい形に変換するコマンドラインツールです。

主に以下のような処理を行います。

• 複数行に分割された行を結合します
• SHIFT_JIS を UTF-8に変換します
• 半角カナを全角カナに変換します
• 全角数字、記号を半角に変換します
• データとして使いにくいレコードを加工します(加工処理詳細参照)
• CSV形式をJSON形式、TSV形式に変換できます

インストール

Macユーザーの場合

homebrew を使って下記のようにインストールできます。

$ brew tap inouet/ken-all
$ brew install ken-all

go ユーザーの場合

$ go get github.com/inouet/ken-all

バイナリのダウンロード

Releases からダウンロード

コマンドの使い方

データを取得して解凍

$ wget --quiet https://www.post.japanpost.jp/zipcode/dl/kogaki/zip/ken_all.zip

$ unzip ken_all.zip

住所データをJSON形式に変換

$ ken-all address KEN_ALL.CSV -t json

{"region_id":"01101","zip":"0600000","pref_kana":"ホッカイドウ","city_kana":"サッポロシチュウオウク","town_kana":"","pref":"北海道","city":"札幌市中央区","town":"","update_status":"0","update_reason":"0","pref_code":"01"}
{"region_id":"01101","zip":"0640941","pref_kana":"ホッカイドウ","city_kana":"サッポロシチュウオウク","town_kana":"アサヒガオカ","pref":"北海道","city":"札幌市中央区","town":"旭ケ丘","update_status":"0","update_reason":"0","pref_code":"01"}
{"region_id":"01101","zip":"0600041","pref_kana":"ホッカイドウ","city_kana":"サッポロシチュウオウク","town_kana":"オオドオリヒガシ","pref":"北海道","city":"札幌市中央区","town":"大通東","update_status":"0","update_reason":"0","pref_code":"01"}
{"region_id":"01101","zip":"0600042","pref_kana":"ホッカイドウ","city_kana":"サッポロシチュウオウク","town_kana":"オオドオリニシ","pref":"北海道","city":"札幌市中央区","town":"大通西","update_status":"0","update_reason":"0","pref_code":"01"}
{"region_id":"01101","zip":"0640820","pref_kana":"ホッカイドウ","city_kana":"サッポロシチュウオウク","town_kana":"オオドオリニシ","pref":"北海道","city":"札幌市中央区","town":"大通西","update_status":"0","update_reason":"0","pref_code":"01"}
{"region_id":"01101","zip":"0600031","pref_kana":"ホッカイドウ","city_kana":"サッポロシチュウオウク","town_kana":"キタ1ジョウヒガシ","pref":"北海道","city":"札幌市中央区","town":"北一条東","update_status":"0","update_reason":"0","pref_code":"01"}
 :

事業所データをJSON形式に変換

$ ken-all office JIGYOSYO.CSV -t json

{"jis_code":"01101","kana":"(カブ) ニホンケイザイシンブンシヤ サツポロシシヤ","name":"株式会社 日本経済新聞社 札幌支社","pref":"北海道","city":"札幌市中央区","town":"北一条西","address":"6丁目1-2アーバンネット札幌ビル2F","zip7":"0608621","zip5":"060  ","post_office":"札幌中央","type":"0","is_multi":"0","update_status":"0","pref_code":"01"}
  :

詳しくは helpを参照ください

Usage:
  ken-all [flags]
  ken-all [command]

Available Commands:
  address     Convert KEN_ALL.CSV into other format.
  help        Help about any command
  office      Convert JIGYOSYO.CSV into other format.

Flags:
  -h, --help   help for ken-all

加工処理詳細

日本郵便の提供するCSVの特徴として、町域名が38文字を超える場合複数行に分かれています。 まずはこれを1行にした上で下記のような処理を行います。

町域名に特定の文字列が入る場合は空文字に変換します

例

• 以下に掲載がない場合
• ○○一円 (一円を除く）
• ○○の次に番地がくる場合

加工前

加工後

町域名が X（A、B）の形式の場合、X、XA、XB の3行に展開します

ただし、括弧内の文字が地名以外と思われるものは削除しています

例

• 「その他」、「地階・階層不明」、「全域」、「成田国際空港内」など特定のワードを含むもの
• 「132〜156」、「367番地」 など番地と思われるもの

加工前

加工後

岩手県の地割表記は削除します

例: 「越中畑64地割〜越中畑66地割」は「越中畑」に変換します

加工前

加工後

参考

• 郵便番号データダウンロード
• 郵便番号データの説明