kintone 郵便番号・住所ルックアップ検索アプリ

#郵便番号による住所検索

郵便番号による住所検索は、既に「[郵便番号検索プラス](http://www.momoyama.org/kintone/plugin/zip2addr)」というプラグインで実現されています。
これは、Google Map Apiを使用しているということです。

今回は、郵便番号データをアプリに取り込んで、郵便番号検索と住所検索をしてみます。
[ルックアップコピー項目編集プラグイン](http://qiita.com/rex0220/items/7fd6279c04346952221f)と[ルックアップ選択条件プラグイン](http://qiita.com/rex0220/items/6d40f02069e2d386f336)を使用します。

#郵便番号アプリの作成

[郵便番号データダウンロード](http://www.post.japanpost.jp/zipcode/download.html)
元になる郵便番号と住所データは、日本郵便が公開しているcsvデータを使います。
読み仮名の種類によって、３種類（半角カナ２種類、ローマ字）ありますが、今回はローマ字を使います。
半角カナが必要な場合は、半角カナデータをダウンロードします。

全国版だと１２万件あり、csvデータをzip形式にして公開しています。
これをダウンロードして、kintone アプリに読み込めるように１０万件以下で分割します。
郵便番号１つに対して複数の住所データがありますので、郵便番号をユニークキーには出来ません。
項目は、都道府県のみドロップダウンとして、他は文字形式にしました。

用途によっては、住所の項目を連結したり、データ内の空白を削除するなど加工が必要かもしれません。

※郵便番号データについては、日本郵便で下記の記述があります。
　郵便番号データに限っては日本郵便株式会社は著作権を主張しません。自由に配布していただいて結構です。

**※[kintone 郵便番号データ（カナとローマ字）の作成](http://qiita.com/rex0220/items/f40fa6651afa817b9c66)で、（カナとローマ字）版を作成しました。**


読み込んだ郵便番号データ
![yubin01.png](https://qiita-image-store.s3.amazonaws.com/0/100572/9b89218f-dd25-84ef-2082-692d8dc44109.png)


#郵便番号検索アプリ

単純なルックアップで、郵便番号で住所を検索するアプリを設定してみます。
郵便番号をキーに、住所をコピーします。
![yubin02.png](https://qiita-image-store.s3.amazonaws.com/0/100572/9cec83ac-808c-f638-bf29-fd969c5066b5.png)

これだと住所を編集できませんので、[ルックアップコピー項目編集プラグイン](http://qiita.com/rex0220/items/7fd6279c04346952221f)で編集可能に設定します。


![yubin03.png](https://qiita-image-store.s3.amazonaws.com/0/100572/d46f4a91-34fb-87ea-201d-0655eef22700.png)

編集可能になった住所項目
![yubin04.png](https://qiita-image-store.s3.amazonaws.com/0/100572/a03a09ef-fe64-9fdc-1028-1803ffcbb9ca.png)

これで、郵便番号で住所を検索・編集することができました。
使用手順としては、
・郵便番号を指定して、住所をルックアップ検索
・住所欄に足りない分を入力

#郵便番号・住所検索アプリ
次に[ルックアップ選択条件プラグイン](http://qiita.com/rex0220/items/6d40f02069e2d386f336)を使って、郵便番号と住所検索ができるアプリを作成してみます。

ルックアップ選択条件プラグインでは、ルックアップキーにユニークキーが必要なので、レコード番号（郵便ID）を使います。

![yubin11.png](https://qiita-image-store.s3.amazonaws.com/0/100572/7376c76a-c5b5-3e0b-253d-1ce5c069b479.png)

##ルックアップ選択条件プラグインの設定

![yubin12.png](https://qiita-image-store.s3.amazonaws.com/0/100572/7aa6b375-2390-0ac0-0b32-df80e24b4488.png)

ルックアップ選択条件プラグインの選択条件
郵便番号、都道府県、住所１、住所２を指定します。

![yubin13.png](https://qiita-image-store.s3.amazonaws.com/0/100572/665ed323-12ea-3ef5-a415-34b9916dbbac.png)


##ルックアップコピー項目編集プラグインの設定
コピー項目を編集可能に設定します。

![yubin14.png](https://qiita-image-store.s3.amazonaws.com/0/100572/f1346e0b-eee8-77d2-32b7-037555f09128.png)

##郵便番号による住所検索

郵便番号を入力して、「取得」ボタンをクリックすると該当のデータが表示されます。
![yubin15.png](https://qiita-image-store.s3.amazonaws.com/0/100572/b05fd056-65c6-5cee-d341-ea3c6bdd99e1.png)

住所の取得結果
![yubin16.png](https://qiita-image-store.s3.amazonaws.com/0/100572/f84a7fb1-0916-8687-5d39-cceaf1f59349.png)

##住所の一部指定による検索

東京都、中央区を指定して検索

![yubin17a.png](https://qiita-image-store.s3.amazonaws.com/0/100572/b8553ff4-246e-dba6-7f6c-51777fb1a256.png)

ルックアップ検索表示
東京都中央区の郵便番号が一覧表示されます。

![yubin17.png](https://qiita-image-store.s3.amazonaws.com/0/100572/993bdc13-e672-dd6b-b7d6-5a91f7030cc2.png)

住所２に銀座を指定して検索

![yubin18a.png](https://qiita-image-store.s3.amazonaws.com/0/100572/d864d544-cbf4-4e9a-6c76-512e98746b48.png)


ルックアップ検索表示
各都道府県の銀座が表示されます。

![yubin18.png](https://qiita-image-store.s3.amazonaws.com/0/100572/972b9904-9b30-ce9f-4cbe-fd442fb24cea.png)

#課題

郵便番号データは、年１回程度の頻度で更新されるようなので、最新に保つためには、
定期的に更新する必要があります。