premiumaddress_multi
住所検索(多言語)
多言語で住所の検索を行います。
対応言語:英語・中国語簡体・中国語繁体・韓国語
住所フリーワード検索
住所文字列から該当する住所情報を検索します。
住所コード検索
住所コードに該当する住所情報を検索します。
住所逆引き(緯度経度検索)
指定された緯度経度座標から住所情報を検索します。
範囲指定住所検索
中心座標、半径で範囲を指定し範囲内の住所情報を検索します。
行政界ポリゴンの取得
住所情報の行政界ポリゴンを取得します。
検索条件を複数指定した場合はAND結合となります。
※本APIを利用するには別途契約が必要です。
HTTP request method
POST/GET
ContentType
application/x-www-form-urlencoded
Parameters
| 名前 | 説明 |
|---|---|
| word_en string |
住所名称を指定(英語) 最小文字数 2 最大文字数 255 word_match_typeが3(部分一致)の場合のみ、スペース区切りで複数ワード(1ワードの最小文字数2)を指定してください。AND検索となります。 word_match_typeが1,2(完全一致、前方一致)の場合は、スペースを除去した1ワードとして検索を行います。 word_en,word_zh_cn,word_zh_tw,word_ko 同時の指定不可 |
| word_zh_cn string |
住所名称を指定(中国語簡体) 最小文字数 2 最大文字数 255 word_match_typeが3(部分一致)の場合のみ、スペース区切りで複数ワード(1ワードの最小文字数2)を指定してください。AND検索となります。 word_match_typeが1,2(完全一致、前方一致)の場合は、スペースを除去した1ワードとして検索を行います。 word_en,word_zh_cn,word_zh_tw,word_ko 同時の指定不可 |
| word_zh_tw string |
住所名称を指定(中国語繁体) 最小文字数 2 最大文字数 255 word_match_typeが3(部分一致)の場合のみ、スペース区切りで複数ワード(1ワードの最小文字数2)を指定してください。AND検索となります。 word_match_typeが1,2(完全一致、前方一致)の場合は、スペースを除去した1ワードとして検索を行います。 word_en,word_zh_cn,word_zh_tw,word_ko 同時の指定不可 |
| word_ko string |
住所名称を指定(韓国語) 最小文字数 2 最大文字数 255 word_match_typeが3(部分一致)の場合のみ、スペース区切りで複数ワード(1ワードの最小文字数2)を指定してください。AND検索となります。 word_match_typeが1,2(完全一致、前方一致)の場合は、スペースを除去した1ワードとして検索を行います。 word_en,word_zh_cn,word_zh_tw,word_ko 同時の指定不可 |
| word_match_type integer default 3 |
検索語句のマッチタイプを指定
|
| address_code string |
住所コードを指定 最大文字数 255 |
| code_match_type integer default 1 |
住所コードのマッチタイプを指定
|
| proximity array[number] ※カンマ区切り |
中心座標、半径で範囲を指定 代表点の近傍検索。 "経度,緯度,半径(m)"で指定してください。 半径の上限は5000です。 proximity,positionは同時指定できません。 |
| position array[number] ※カンマ区切り |
座標を指定 "経度,緯度"で指定してください。 proximity,positionは同時指定できません。 |
| address_level array[string] default TOD,SHK,OAZ,AZC,GIK,TBN ※カンマ区切り |
検索する住所の階層を指定(複数指定可)
|
| sort array[string] default address_sort ※カンマ区切り |
出力順を指定(複数指定可) デフォルトは昇順です。降順指定の場合、ソートキーの前方にマイナス(-)を付加してください。 address_sort
住所
address_code
住所コード
address_read
住所読み
address_level
住所階層レベル
postcode
郵便番号
distance
検索座標と代表点の直線距離
address_en
住所(英語)
address_zh_cn
住所(簡体)
address_zh_tw
住所(繁体)
address_ko
住所(韓国語)
|
| address_polygon boolean default false |
行政界ポリゴンの取得有無を指定 行政界ポリゴンが整備されていない地番・戸番はnullが返却されます。 ※行政界ポリゴンを取得する場合は1リクエスト1行政界ポリゴンとなるようにご指定ください。1リクエストで大量の行政界ポリゴンを取得しようとするとエラーとなる場合があります。
|
| show_code_zero boolean default false |
当該階層の住所コードが 0 のレコード(大字なし、字丁目なし、街区なし)出力を指定 行政界ポリゴンが整備されていない地番・戸番はnullが返却されます。
|
| limit array[integer] default List[0,100] ※カンマ区切り |
検索結果取得件数を指定 "オフセット,件数"で指定してください。 1階層で10000レコードを超える住所があり、リスト表示での全件取得を可能とするため住所検索と地番検索のみ、オフセット値の上限を20000としています。 最大値 20000,1000 |
| datum string default JGD |
入出力座標の測地系を指定 JGD
世界測地系
TOKYO
日本測地系
TOKYO_NAVI
日本測地系(ゼンリン ナビ地図)
|
Responses
エラーについては「エラーメッセージ一覧」を参照してください。
Media type:application/json
| キー名 | 説明 | ||
|---|---|---|---|
| status string |
ステータス | ||
| result | info | hit integer |
検索結果総数 |
| item | address_code string |
住所コード | |
| address string |
住所 | ||
| address_read string |
住所読み | ||
| address_read_through string |
住所読み下し 読みと読み下しの違いは以下の通り ・読み ：英数字は英数字のまま返却 ・読み下し：英数字の読みを返却（例：１→イチ、A→エー） ※いずれか、もしくはいずれもnullで返却される場合があります |
||
| address_code1 string |
国コード | ||
| address1 string |
国名称 | ||
| address_read1 string |
国名称読み | ||
| address_read_through1 string |
国名称読み下し | ||
| address_code2 string |
都道府県コード | ||
| address2 string |
都道府県名称 | ||
| address_read2 string |
都道府県名称読み | ||
| address_read_through2 string |
都道府県名称読み下し | ||
| address_code3 string |
市区町村コード | ||
| address3 string |
市区町村名称 | ||
| address_read3 string |
市区町村名称読み | ||
| address_read_through3 string |
市区町村名称読み下し | ||
| address_code4 string |
大字コード | ||
| address4 string |
大字名称 | ||
| address_read4 string |
大字名称読み | ||
| address_read_through4 string |
大字名称読み下し | ||
| address_code5 string |
字丁目コード | ||
| address5 string |
字丁目名称 | ||
| address_read5 string |
字丁目名称読み | ||
| address_read_through5 string |
字丁目名称読み下し | ||
| address_detail_code1 string |
街区コード | ||
| address_detail1 string |
街区名称 | ||
| address_detail_read1 string |
街区名称読み | ||
| address_detail_read_through1 string |
街区名称読み下し | ||
| address_detail_code2 string |
地番戸番コード | ||
| address_detail2 string |
地番戸番名称 | ||
| address_detail_read2 string |
地番戸番名称読み | ||
| address_detail_read_through2 string |
地番戸番名称読み下し | ||
| post_code string |
郵便番号 | ||
| address_level string |
住所階層情報
|
||
| address_name_type integer |
住所階層が国～字丁目の住所に対し、住所名称の種類を表します。
|
||
| exclude_level_flag integer |
住所階層表示の対象外とするデータを表すフラグ
|
||
| child_level_flag integer |
子階層フラグ
|
||
| entrance_point array[array[number]] |
出入口地点座標 座標の配列(複数点の場合あり)を返却します。 [[経度,緯度],...] |
||
| position array[number] |
["経度","緯度"] | ||
| distance number |
検索座標と代表点の直線距離(proximityを指定した場合のみ返却) | ||
| address_polygon string |
行政界ポリゴン(行政界ポリゴン取得有を指定した場合のみ) GeoJSON形式 |
||
| address_en string |
住所_英語 | ||
| address_zh_cn string |
住所_簡体 | ||
| address_zh_tw string |
住所_繁体 | ||
| address_ko string |
住所_韓国語 | ||
| address1_en string |
国名称_英語 | ||
| address1_zh_cn string |
国名称_簡体 | ||
| address1_zh_tw string |
国名称_繁体 | ||
| address1_ko string |
国名称_韓国語 | ||
| address2_en string |
都道府県名称_英語 | ||
| address2_zh_cn string |
都道府県名称_簡体 | ||
| address2_zh_tw string |
都道府県名称_繁体 | ||
| address2_ko string |
都道府県名称_韓国語 | ||
| address3_en string |
市区町村名称_英語 | ||
| address3_zh_cn string |
市区町村名称_簡体 | ||
| address3_zh_tw string |
市区町村名称_繁体 | ||
| address3_ko string |
市区町村名称_韓国語 | ||
| address4_en string |
大字名称_英語 | ||
| address4_zh_cn string |
大字名称_簡体 | ||
| address4_zh_tw string |
大字名称_繁体 | ||
| address4_ko string |
大字名称_韓国語 | ||
| address5_en string |
字丁目名称_英語 | ||
| address5_zh_cn string |
字丁目名称_簡体 | ||
| address5_zh_tw string |
字丁目名称_繁体 | ||
| address5_ko string |
字丁目名称_韓国語 | ||
| address_detail1_en string |
街区名称_英語 | ||
| address_detail1_zh_cn string |
街区名称_簡体 | ||
| address_detail1_zh_tw string |
街区名称_繁体 | ||
| address_detail1_ko string |
街区名称_韓国語 | ||
| address_detail2_en string |
地番戸番名称_英語 | ||
| address_detail2_zh_cn string |
地番戸番名称_簡体 | ||
| address_detail2_zh_tw string |
地番戸番名称_繁体 | ||
| address_detail2_ko string |
地番戸番名称_韓国語 | ||
Example
https://[domain]/search/address_multi?word_en=Tokyo&word_match_type=3&address_code=13103026&code_match_type=2p&osition=139.723646,35.651638&address_level=TOD,SHK,OAZ,AZC,GIK,TBN&sort=address_sort&address_polygon=false&show_code_zero=false&limit=0,100&datum=JGD
{
"status": "OK",
"result": {
"info": {
"hit": 4
},
"item": [
{
"address_code": "13103026",
"address": "東京都港区南麻布",
"address_read": "トウキョウトミナトクミナミアザブ",
"address_read_through": "トウキョウトミナトクミナミアザブ",
"address_code1": "JPN",
"address1": "日本",
"address_read1": "ニホン",
"address_read_through1": "ニホン",
"address_code2": "13",
"address2": "東京都",
"address_read2": "トウキョウト",
"address_read_through2": "トウキョウト",
"address_code3": "103",
"address3": "港区",
"address_read3": "ミナトク",
"address_read_through3": "ミナトク",
"address_code4": "026",
"address4": "南麻布",
"address_read4": "ミナミアザブ",
"address_read_through4": "ミナミアザブ",
"address_code5": null,
"address5": null,
"address_read5": null,
"address_read_through5": null,
"address_detail_code1": null,
"address_detail1": null,
"address_detail_read1": null,
"address_detail_read_through1": null,
"address_detail_code2": null,
"address_detail2": null,
"address_detail_read2": null,
"address_detail_read_through2": null,
"post_code": "106-0047",
"address_level": "OAZ",
"address_name_type": 1,
"exclude_level_flag": 0,
"child_level_flag": 1,
"entrance_point": null,
"position": [
139.7306369358,
35.6507858615
],
"distance": null,
"address_polygon": null,
"address_en": "TokyoMinatoMinamiazabu",
"address_zh_cn": "东京都港区南麻布",
"address_zh_tw": "東京都港區南麻布",
"address_ko": "도쿄도미나토구미나미아자부",
"address1_en": "Japan",
"address1_zh_cn": "日本",
"address1_zh_tw": "日本",
"address1_ko": "일본",
"address2_en": "Tokyo",
"address2_zh_cn": "东京都",
"address2_zh_tw": "東京都",
"address2_ko": "도쿄도",
"address3_en": "Minato",
"address3_zh_cn": "港区",
"address3_zh_tw": "港區",
"address3_ko": "미나토구",
"address4_en": "Minamiazabu",
"address4_zh_cn": "南麻布",
"address4_zh_tw": "南麻布",
"address4_ko": "미나미아자부",
"address5_en": null,
"address5_zh_cn": null,
"address5_zh_tw": null,
"address5_ko": null,
"address_detail1_en": null,
"address_detail1_zh_cn": null,
"address_detail1_zh_tw": null,
"address_detail1_ko": null,
"address_detail2_en": null,
"address_detail2_zh_cn": null,
"address_detail2_zh_tw": null,
"address_detail2_ko": null
},
{
"address_code": "13103026005",
"address": "東京都港区南麻布5丁目",
"address_read": "トウキョウトミナトクミナミアザブ5チョウメ",
"address_read_through": "トウキョウトミナトクミナミアザブゴチョウメ",
"address_code1": "JPN",
"address1": "日本",
"address_read1": "ニホン",
"address_read_through1": "ニホン",
"address_code2": "13",
"address2": "東京都",
"address_read2": "トウキョウト",
"address_read_through2": "トウキョウト",
"address_code3": "103",
"address3": "港区",
"address_read3": "ミナトク",
"address_read_through3": "ミナトク",
"address_code4": "026",
"address4": "南麻布",
"address_read4": "ミナミアザブ",
"address_read_through4": "ミナミアザブ",
"address_code5": "005",
"address5": "５丁目",
"address_read5": "５チョウメ",
"address_read_through5": "ゴチョウメ",
"address_detail_code1": null,
"address_detail1": null,
"address_detail_read1": null,
"address_detail_read_through1": null,
"address_detail_code2": null,
"address_detail2": null,
"address_detail_read2": null,
"address_detail_read_through2": null,
"post_code": "106-0047",
"address_level": "AZC",
"address_name_type": 1,
"exclude_level_flag": 0,
"child_level_flag": 1,
"entrance_point": null,
"position": [
139.7230932617,
35.6516156684
],
"distance": null,
"address_polygon": null,
"address_en": "TokyoMinatoMinamiazabu5",
"address_zh_cn": "东京都港区南麻布5丁目",
"address_zh_tw": "東京都港區南麻布5丁目",
"address_ko": "도쿄도미나토구미나미아자부5쵸메",
"address1_en": "Japan",
"address1_zh_cn": "日本",
"address1_zh_tw": "日本",
"address1_ko": "일본",
"address2_en": "Tokyo",
"address2_zh_cn": "东京都",
"address2_zh_tw": "東京都",
"address2_ko": "도쿄도",
"address3_en": "Minato",
"address3_zh_cn": "港区",
"address3_zh_tw": "港區",
"address3_ko": "미나토구",
"address4_en": "Minamiazabu",
"address4_zh_cn": "南麻布",
"address4_zh_tw": "南麻布",
"address4_ko": "미나미아자부",
"address5_en": "5",
"address5_zh_cn": "5丁目",
"address5_zh_tw": "5丁目",
"address5_ko": "5쵸메",
"address_detail1_en": null,
"address_detail1_zh_cn": null,
"address_detail1_zh_tw": null,
"address_detail1_ko": null,
"address_detail2_en": null,
"address_detail2_zh_cn": null,
"address_detail2_zh_tw": null,
"address_detail2_ko": null
},
{
"address_code": "1310302600500016",
"address": "東京都港区南麻布5丁目16",
"address_read": "トウキョウトミナトクミナミアザブ5チョウメ16",
"address_read_through": "トウキョウトミナトクミナミアザブゴチョウメジュウロク",
"address_code1": "JPN",
"address1": "日本",
"address_read1": "ニホン",
"address_read_through1": "ニホン",
"address_code2": "13",
"address2": "東京都",
"address_read2": "トウキョウト",
"address_read_through2": "トウキョウト",
"address_code3": "103",
"address3": "港区",
"address_read3": "ミナトク",
"address_read_through3": "ミナトク",
"address_code4": "026",
"address4": "南麻布",
"address_read4": "ミナミアザブ",
"address_read_through4": "ミナミアザブ",
"address_code5": "005",
"address5": "５丁目",
"address_read5": "５チョウメ",
"address_read_through5": "ゴチョウメ",
"address_detail_code1": "00016",
"address_detail1": "16",
"address_detail_read1": "16",
"address_detail_read_through1": "ジュウロク",
"address_detail_code2": null,
"address_detail2": null,
"address_detail_read2": null,
"address_detail_read_through2": null,
"post_code": "106-0047",
"address_level": "GIK",
"address_name_type": 1,
"exclude_level_flag": 0,
"child_level_flag": 1,
"entrance_point": null,
"position": [
139.7236233181,
35.6515673828
],
"distance": null,
"address_polygon": null,
"address_en": "TokyoMinatoMinamiazabu5-16",
"address_zh_cn": "东京都港区南麻布5丁目16",
"address_zh_tw": "東京都港區南麻布5丁目16",
"address_ko": "도쿄도미나토구미나미아자부5쵸메16",
"address1_en": "Japan",
"address1_zh_cn": "日本",
"address1_zh_tw": "日本",
"address1_ko": "일본",
"address2_en": "Tokyo",
"address2_zh_cn": "东京都",
"address2_zh_tw": "東京都",
"address2_ko": "도쿄도",
"address3_en": "Minato",
"address3_zh_cn": "港区",
"address3_zh_tw": "港區",
"address3_ko": "미나토구",
"address4_en": "Minamiazabu",
"address4_zh_cn": "南麻布",
"address4_zh_tw": "南麻布",
"address4_ko": "미나미아자부",
"address5_en": "5",
"address5_zh_cn": "5丁目",
"address5_zh_tw": "5丁目",
"address5_ko": "5쵸메",
"address_detail1_en": "16",
"address_detail1_zh_cn": "16",
"address_detail1_zh_tw": "16",
"address_detail1_ko": "16",
"address_detail2_en": null,
"address_detail2_zh_cn": null,
"address_detail2_zh_tw": null,
"address_detail2_ko": null
},
{
"address_code": "131030260050001600003",
"address": "東京都港区南麻布5丁目16-13",
"address_read": "トウキョウトミナトクミナミアザブ5チョウメ16-13",
"address_read_through": "トウキョウトミナトクミナミアザブゴチョウメジュウロクジュウサン",
"address_code1": "JPN",
"address1": "日本",
"address_read1": "ニホン",
"address_read_through1": "ニホン",
"address_code2": "13",
"address2": "東京都",
"address_read2": "トウキョウト",
"address_read_through2": "トウキョウト",
"address_code3": "103",
"address3": "港区",
"address_read3": "ミナトク",
"address_read_through3": "ミナトク",
"address_code4": "026",
"address4": "南麻布",
"address_read4": "ミナミアザブ",
"address_read_through4": "ミナミアザブ",
"address_code5": "005",
"address5": "５丁目",
"address_read5": "５チョウメ",
"address_read_through5": "ゴチョウメ",
"address_detail_code1": "00016",
"address_detail1": "16",
"address_detail_read1": "16",
"address_detail_read_through1": "ジュウロク",
"address_detail_code2": "00003",
"address_detail2": "13",
"address_detail_read2": "13",
"address_detail_read_through2": "ジュウサン",
"post_code": "106-0047",
"address_level": "TBN",
"address_name_type": 1,
"exclude_level_flag": 0,
"child_level_flag": 0,
"entrance_point": [
[
139.7235386827,
35.6516729058
]
],
"position": [
139.7235918511,
35.6515882704
],
"distance": null,
"address_polygon": null,
"address_en": "TokyoMinatoMinamiazabu5-16-13",
"address_zh_cn": "东京都港区南麻布5丁目16-13",
"address_zh_tw": "東京都港區南麻布5丁目16-13",
"address_ko": "도쿄도미나토구미나미아자부5쵸메16-13",
"address1_en": "Japan",
"address1_zh_cn": "日本",
"address1_zh_tw": "日本",
"address1_ko": "일본",
"address2_en": "Tokyo",
"address2_zh_cn": "东京都",
"address2_zh_tw": "東京都",
"address2_ko": "도쿄도",
"address3_en": "Minato",
"address3_zh_cn": "港区",
"address3_zh_tw": "港區",
"address3_ko": "미나토구",
"address4_en": "Minamiazabu",
"address4_zh_cn": "南麻布",
"address4_zh_tw": "南麻布",
"address4_ko": "미나미아자부",
"address5_en": "5",
"address5_zh_cn": "5丁目",
"address5_zh_tw": "5丁目",
"address5_ko": "5쵸메",
"address_detail1_en": "16",
"address_detail1_zh_cn": "16",
"address_detail1_zh_tw": "16",
"address_detail1_ko": "16",
"address_detail2_en": "13",
"address_detail2_zh_cn": "13",
"address_detail2_zh_tw": "13",
"address_detail2_ko": "13"
}
]
}
}