このページでは、kintone Flow
プラグインの住所カテゴリに含まれる関数の使い方を解説します。各関数の概要・パラメータ・活用シーンをまとめています。
kintone 標準の住所機能の限界
kintone 標準には住所に関する自動化機能がありません。
| やりたいこと | kintone 標準 | kintone Flow |
|---|---|---|
| 郵便番号から住所を自動入力 | – | ○ |
| 住所の正規化(表記ゆれ統一) | – | ○ |
| 電話番号の正規化(形式統一) | – | ○ |
| 郵便番号の正規化(ハイフン統一) | – | ○ |
| 住所から緯度経度を取得 | – | ○ |
| 緯度経度から住所を取得 | – | ○ |
住所関数の全体像
| グループ | 関数 | できること |
|---|---|---|
| 住所変換 | ZIPCODE_TO_ADDRESS | 郵便番号→住所の自動変換 |
| 正規化 | NORMALIZE_ADDRESS, NORMALIZE_PHONE, NORMALIZE_ZIPCODE | 住所・電話番号・郵便番号の表記統一 |
| ジオコーディング | GEOCODE, REVERSE_GEOCODE | 住所↔︎緯度経度の相互変換 |
1. 住所変換
ZIPCODE_TO_ADDRESS —
郵便番号から住所を取得する
郵便番号を入力すると、対応する都道府県・市区町村・町域名を自動で取得します。
パラメータ
| パラメータ | 説明 | 設定方法 |
|---|---|---|
| 郵便番号 | 変換元の郵便番号 | フィールド参照 |
| 保存先フィールド(都道府県) | 都道府県名を保存 | 文字列フィールドを選択 |
| 保存先フィールド(市区町村) | 市区町村名を保存 | 文字列フィールドを選択 |
| 保存先フィールド(町域名) | 町域名を保存 | 文字列フィールドを選択 |
活用シーン
- 顧客登録の効率化:
郵便番号を入力するだけで住所が自動入力される - 入力ミスの防止: 手入力による住所の間違いを削減
- データの標準化:
都道府県・市区町村・町域が個別フィールドに分かれるため、地域別の集計が容易
2. 正規化
NORMALIZE_ADDRESS —
住所を正規化する
住所の表記ゆれを統一します。全角半角の混在、「丁目」「番地」の表記ゆれなどを標準形式に変換します。
パラメータ
| パラメータ | 説明 | 設定方法 |
|---|---|---|
| 住所 | 正規化する住所文字列 | フィールド参照 |
| 保存先フィールド | 正規化結果を保存する文字列フィールド | 文字列フィールドを選択 |
正規化の例
| 入力値 | 出力結果 |
|---|---|
| 東京都千代田区丸の内1ー1ー1 | 東京都千代田区丸の内1-1-1 |
| 東京都千代田区丸ノ内一丁目1番1号 | 東京都千代田区丸の内1-1-1 |
活用シーン
- データクレンジング: 既存データの住所表記を統一
- 重複チェックの前処理:
住所の表記ゆれを統一してから重複検出
NORMALIZE_PHONE —
電話番号を正規化する
電話番号のフォーマットを統一します。ハイフンの有無、全角半角の混在を標準形式に変換します。
パラメータ
| パラメータ | 説明 | 設定方法 |
|---|---|---|
| 電話番号 | 正規化する電話番号 | フィールド参照 |
| 保存先フィールド | 正規化結果を保存する文字列フィールド | 文字列フィールドを選択 |
正規化の例
| 入力値 | 出力結果 |
|---|---|
| 03ー1234ー5678 | 03-1234-5678 |
| 09012345678 | 090-1234-5678 |
NORMALIZE_ZIPCODE —
郵便番号を正規化する
郵便番号のフォーマットを統一します。
正規化の例
| 入力値 | 出力結果 |
|---|---|
| 1000001 | 100-0001 |
| 100ー0001 | 100-0001 |
活用シーン
- 入力データの統一:
様々なフォーマットで入力された連絡先情報を統一形式に変換 - ZIPCODE_TO_ADDRESS の前処理:
郵便番号を正規化してから住所変換を実行
3. ジオコーディング
GEOCODE —
住所から緯度経度を取得する
住所文字列を緯度・経度の数値に変換します。Google Maps API
を使用します。
パラメータ
| パラメータ | 説明 | 設定方法 |
|---|---|---|
| 住所(または都道府県) | 変換する住所(一括指定または分割指定) | フィールド参照 |
| 市区町村名(任意) | 分割指定時の市区町村 | フィールド参照 |
| 町域名(任意) | 分割指定時の町域 | フィールド参照 |
| 小字名・丁目・番地(任意) | 分割指定時の詳細住所 | フィールド参照 |
| 事業所名(任意) | 分割指定時の事業所名 | フィールド参照 |
| 保存先フィールド(緯度) | 緯度を保存する数値フィールド | 数値フィールドを選択 |
| 保存先フィールド(経度) | 経度を保存する数値フィールド | 数値フィールドを選択 |
この関数は Google Maps API を使用するため、共通設定で API
キーの設定が必要です。
活用シーン
- 地図連携:
顧客住所を緯度経度に変換し、地図サービスと連携 - 距離計算の前処理:
2点間の距離計算の入力データとして利用
REVERSE_GEOCODE —
緯度経度から住所を取得する
緯度・経度から住所(都道府県・市区町村・町域名)を逆引きします。
パラメータ
| パラメータ | 説明 | 設定方法 |
|---|---|---|
| 緯度 | 緯度の数値 | フィールド参照 |
| 経度 | 経度の数値 | フィールド参照 |
| 保存先フィールド(都道府県) | 都道府県名を保存 | 文字列フィールドを選択 |
| 保存先フィールド(市区町村) | 市区町村名を保存 | 文字列フィールドを選択 |
| 保存先フィールド(町域名) | 町域名を保存 | 文字列フィールドを選択 |
この関数は Google Maps API を使用するため、共通設定で API
キーの設定が必要です。
活用シーン
- 位置情報からの住所特定:
GPSデータから住所を自動取得 - フィールドワーク支援:
現地調査時の位置情報を住所に変換
関数一覧(クイックリファレンス)
| 関数名 | グループ | 説明 | 返却型 | 外部API |
|---|---|---|---|---|
| ZIPCODE_TO_ADDRESS | 住所変換 | 郵便番号→住所 | 文字列(3フィールド) | – |
| NORMALIZE_ADDRESS | 正規化 | 住所の表記統一 | 文字列 | – |
| NORMALIZE_PHONE | 正規化 | 電話番号の形式統一 | 文字列 | – |
| NORMALIZE_ZIPCODE | 正規化 | 郵便番号の形式統一 | 文字列 | – |
| GEOCODE | ジオコーディング | 住所→緯度経度 | 数値(2フィールド) | Google Maps |
| REVERSE_GEOCODE | ジオコーディング | 緯度経度→住所 | 文字列(3フィールド) | Google Maps |
