【コピペOK】Googleスプレッドシートで郵便番号から住所を取得する方法

2023/11/12 23:342024/6/17 13:56

Home > TECH BLOG > 【コピペOK】Googleスプレッドシートで郵便番号から住所を取得する方法

📖

▎はじめに ▎郵便番号から住所を検索してみよう！▎GAS関数の解説郵便番号(postalCode)で zipcloud APIを呼び出す住所情報のJSON形式の文字列で取得する住所情報のJSONをオブジェクトに変換する関数の戻り値として住所の文字列を返す ▎郵便番号検索APIとはリクエストURL レスポンス ▎まとめ関連記事 [宣伝] GASプログラミング入門の教材 - Udemy

公開日：2023年11月13日　更新日：2023年11月13日

著者：藤澤勇樹(FUJISAWA Yuki)

▎はじめに

Googleスプレッドシートで、郵便番号から住所を取得したい！といった方に向けて、GASを使った方法を解説する記事です。本記事では、以下、スキルを得ることができます。

郵便番号から住所を検索する方法

GAS関数の作成方法

スプレッドシートからGAS関数を呼び出す方法

郵便番号検索APIとは何か

▎郵便番号から住所を検索してみよう！

Googleドライブを開く

スプレッドシートを作成する

GASエディタの起動する

“拡張機能”の”App Script”をクリック

に以下のコードをコピー＆ペーストする

スプレッドシートに”郵便番号”と”住所”の列を作成する

“住所”の列にを入力する

がGASの関数で、引数に郵便番号を渡すと、住所が返ってくる

以上で完了です。

スプレッドシートで”郵便番号”の列から住所を検索することができます！

▎GAS関数の解説

郵便番号(postalCode)で zipcloud APIを呼び出す

zipcloudとは、日本郵便のWebサイトで公開されている郵便番号データを再配信するサービスの名称です

この記事では、zipcloudが提供する”郵便番号検索API”を使います

”郵便番号検索API”では、郵便番号(postalCode)から住所をクラウドで検索することができます

住所情報のJSON形式の文字列で取得する

zipcloud APIから住所情報のJSON形式の文字列を取得しています

JSON形式は、次の通りです

住所情報のJSONをオブジェクトに変換する

“JSON.parse(…)”で、住所情報のJSONをオブジェクトに変換しています

住所情報は、以下のようなオブジェクトに変換されます

関数の戻り値として住所の文字列を返す

関数の戻り値として住所の文字列(address)を返しています

以下、住所情報を結合して住所の文字列を作成しています

都道府県名

data.results[0].address1

市区町村名

data.results[0].address2

町域名

data.results[0].address3

▎郵便番号検索APIとは

株式会社アイビス様が運営する「zipcloud」というサービスで提供している郵便番号データを検索できるWeb APIです

日本郵便が公開している郵便番号データから作成されており信頼性があります

郵便番号検索API - zipcloud

日本郵便が公開している郵便番号データを検索する機能をRESTで提供しています。

http://zipcloud.ibsnet.co.jp/doc/api

リクエストURL

https://zipcloud.ibsnet.co.jp/api/searchz?zipcode=${7桁の郵便番号}

の部分を郵便番号に置き換えます

、どちらの郵便番号でもOKです。

（例）郵便番号「1070052」で検索する場合

https://zipcloud.ibsnet.co.jp/api/search?zipcode=1070052

レスポンス

フィールド名		項目名	備考
status		ステータス	正常時は 200、エラー発生時にはエラーコードが返される。
message		メッセージ	エラー発生時に、エラーの内容が返される。
results	--- 検索結果が複数存在する場合は、以下の項目が配列として返される ---
	zipcode	郵便番号	7桁の郵便番号。ハイフンなし。
	prefcode	都道府県コード	JIS X 0401 に定められた2桁の都道府県コード。
	address1	都道府県名
	address2	市区町村名
	address3	町域名
	kana1	都道府県名カナ
	kana2	市区町村名カナ
	kana3	町域名カナ