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

Home > TECH BLOG > 【コピペOK】Googleスプレッドシートで郵便番号から住所を取得する方法
公開日:2023年11月13日 更新日:2023年11月13日

▎はじめに

Googleスプレッドシートで、郵便番号から住所を取得したい!といった方に向けて、GASを使った方法を解説する記事です。本記事では、以下、スキルを得ることができます。
  • 郵便番号から住所を検索する方法
  • GAS関数の作成方法
  • スプレッドシートからGAS関数を呼び出す方法
  • 郵便番号検索APIとは何か

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

  1. Googleドライブを開く
  1. スプレッドシートを作成する
 
  1. GASエディタの起動する
    1. “拡張機能”の”App Script”をクリック
 
  1. に以下のコードをコピー&ペーストする
  1. スプレッドシートに”郵便番号”と”住所”の列を作成する
  1. “住所”の列に を入力する
    1. が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です
  • 日本郵便が公開している郵便番号データから作成されており信頼性があります

リクエストURL

https://zipcloud.ibsnet.co.jp/api/searchz?zipcode=${7桁の郵便番号}
  • の部分を郵便番号に置き換えます
  • どちらの郵便番号でもOKです。

レスポンス

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

▎まとめ

Googleスプレッドシートで郵便番号から住所を取得したい!といった方に向けて、GASを使った方法を解説しましたがいかがだったでしょうか?お役に立てれば幸いです。
💡
記事のまとめ
  • 郵便番号から住所を検索する方法
    • をGASエディタで作成する
    • スプレッドシートの数式に を入力する
  • GAS関数の作成方法
    • “拡張機能”の”App Script”でGASエディタを起動
    • にGASの関数を記述する
  • スプレッドシートからGASの関数を呼び出す方法
    • スプレッドシートの数式に を入力する
  • 郵便番号検索APIとは何か
    • 株式会社アイビスが運営する「zipcloud」で提供している、郵便番号を検索できるWeb APIのこと

[宣伝] GASプログラミング入門の教材 - Udemy

  • 2023年11月時点で、約3,000人の受講生を獲得し、「Udemy Business」に選定されてます。
    • 「Udemy Business」とは、Udemyが「企業研修」向けに提供しているサービスのことです。
    • Udemyで販売している全ての講座の中から、「企業研修」に提供できる高品質な講座をレビューや内容を加味して厳選していることが特徴のサービスです。
    • その「Udemy Business」で、このGAS講座は採用されております。
  • 教材の詳細は、以下のUdemyに記載しておりますので内容ご確認ください
    • 以下のバナーから購入すると、通常、定価27,800円が1,500円に割引される特別クーポンが適用されます!
    • 有効期限は、です。

関連記事