SEARCHADDRESS¶
種類: EGTools 専用関数
韓国の住所を検索します(juso.go.kr)。
構文¶
=SEARCHADDRESS(テキスト, [出力項目], [行], [api_key])
引数¶
| 引数 | 必須 | 説明 |
|---|---|---|
| テキスト | 必須 | 検索する住所キーワード |
| 出力項目 | 省略可能 | 出力列 1~27、{1,2} の配列可: 1 郵便番号, 2 道路名住所(既定), 3 地番住所, 4 英文住所 |
| 行 | 省略可能 | 出力する行番号、0/省略で全件 |
| api_key | 省略可能 | juso.go.kr の承認キー。1 回入力するとレジストリに保存 |
戻り値¶
検索された住所を、選択した出力項目の列で構成したテキスト配列として返し、スピルされます(行=0 の場合は全件、最大 100 件)。検索語が空の場合や出力項目が 1～27 の範囲外の場合は #VALUE! を、結果がない場合は #N/A を返し、キー未設定・ネットワーク・サービスのエラーは "ERROR: …" テキストとして返します。
例¶
| 数式 | 結果 | 説明 |
|---|---|---|
=SEARCHADDRESS("세종대로 110") |
道路名住所の検索(ネットワーク・API キーが必要) | |
=SEARCHADDRESS("세종대로 110",{1,2},1) |
郵便番号+道路名住所を 1 行で(ネットワーク・API キーが必要) |
解説¶
- API キーは配布されません。住所基盤産業支援サービスで発行を受け、最後の引数として 1 回入力するとユーザーアカウントに保存され、以後は省略できます。
- サービスがキーを拒否した場合(期限切れ/未登録)、保存されたキーを自動的に削除し、再発行の案内を返します。
- 出力項目の一覧(1～27)は次の表のとおりです。既定値は 2(道路名住所)で、{1,2} のように配列で複数の列を指定できます。
| 番号 | フィールド | 内容 |
|---|---|---|
| 1 | zipNo | 郵便番号 |
| 2 | roadAddr | 道路名住所(全体、既定) |
| 3 | jibunAddr | 地番住所 |
| 4 | engAddr | 道路名住所(英文) |
| 5 | roadAddrPart1 | 道路名住所(参考項目を除く) |
| 6 | roadAddrPart2 | 道路名住所の参考項目 |
| 7 | admCd | 行政区域コード |
| 8 | rnMgtSn | 道路名コード |
| 9 | bdMgtSn | 建物管理番号 |
| 10 | detBdNmList | 詳細建物名 |
| 11 | bdNm | 建物名 |
| 12 | bdKdcd | 共同住宅かどうか(1: 共同住宅、0: 非共同住宅) |
| 13 | siNm | 市・道名 |
| 14 | sggNm | 市・郡・区名 |
| 15 | emdNm | 邑・面・洞名 |
| 16 | liNm | 法定里名 |
| 17 | rn | 道路名 |
| 18 | udrtYn | 地下かどうか(0: 地上、1: 地下) |
| 19 | buldMnnm | 建物本番 |
| 20 | buldSlno | 建物副番 |
| 21 | mtYn | 山かどうか(0: 宅地、1: 山) |
| 22 | lnbrMnnm | 地番本番(番地) |
| 23 | lnbrSlno | 地番副番(号) |
| 24 | emdNo | 邑面洞連番 |
| 25 | hstryYn | 変動履歴の有無 |
| 26 | relJibun | 関連地番 |
| 27 | hemdNm | 管轄住民センター |
- 検索語・api_key に配列を指定すると #VALUE! を返します(api_key は保存前に拒否され、誤ったキーの保存を防ぎます) — 複数件は数式を行ごとにコピーして使用してください。
- 対応: Excel 2010+。すべての Excel バージョンで
SEARCHADDRESSの名前のまま登録されます。