ac_standard

住所クレンジング(標準)

住所の正規化処理を行い、座標情報結果を返します。
漢字間違いや一部欠損の補完、表記ゆれの入力を吸収して対応します。
(住所クレンジングのロジックについて)

https://[domain]/data-coding/ac_standard

HTTP request method

POST/GET

ContentType

application/x-www-form-urlencoded

Parameters

*requiredは必須
Array型のパラメータの区切り文字は特記のない限りカンマ(,)およびセミコロン(;)です。

名前	説明
word*required array[string]	住所名称を指定最大件数 100件。 1件当たりの最大文字数 255文字。 1文字以下の場合、マッチングレベルはNOMを返却します。先頭から100文字までの文字列で検索します。
enc integer default 0	入力住所の文字コードを指定 0 UTF-8 1 EUC-JP 2 Shift-JIS
use_kana boolean default false	カナ住所マッチング機能の使用 trueの場合、通常の住所に加えてwordで指定した文字列がカナ住所と一致するかを検索します。 true 使用する false 使用しない
use_multi_addr boolean default false	重複住所出力機能の使用 true 使用する false 使用しない
match_level string default TBN	マッチングする下限階層を指定指定値より粗いmatch_levelのみが返却されます。 (例:match_levelがOAZ指定されている場合、返却されるmatch_levelはTOD,SHK,OAZのいずれかとなります。) TOD 都道府県 SHK 市区町村 OAZ 大字 AZC 字丁目 GIK 街区 TBN 地番・戸番
datum string default JGD	入出力座標の測地系を指定 JGD 世界測地系 TOKYO 日本測地系 TOKYO_NAVI 日本測地系(ゼンリンナビ地図)

Responses

エラーについては「エラーメッセージ一覧」を参照してください。

Status Code:200

Media type:application/json

キー名				説明
status string				ステータス
result	info	hit integer		検索結果総数
	item	input_word string		入力文字列
		address_code string		住所コード
		address string		住所
		address_read_through string		住所読み下し
		address2 string		都道府県名称
		address_read_through2 string		都道府県名称読み下し
		address3 string		市区町村名称
		address_read_through3 string		市区町村名称読み下し
		address4 string		大字名称
		address_read_through4 string		大字名称読み下し
		address5 string		字丁目名称
		address_read_through5 string		字丁目名称読み下し
		address_detail1 string		街区名称
		address_detail_read_through1 string		街区名称読み下し
		address_detail2 string		地番戸番名称
		address_detail_read_through2 string		地番戸番名称読み下し
		post_code string		郵便番号
		address_name_type integer		住所階層が国～字丁目の住所に対し、住所名称の種類を表します。 1 正式名称(公称) 2 略式名称
		child_level_flag integer		子階層フラグ 0 子階層なし 1 子階層あり
		match_level string		マッチングレベル NOM マッチなし TOD 都道府県 SHK 市区町村 OAZ 大字 AZC 字丁目 GIK 街区 TBN2 地番・戸番(部分一致) TBN1 地番・戸番(地番戸番レベルのみで見て完全一致している)
		match_flag integer		入力住所(word)の全ての文字が出力住所(address)の中に含まれているかどうかを表すフラグ(正規化して判定) 0 入力住所が出力住所の中に全て含まれておらず部分的にしか一致しなかった場合 1 入力住所が出力住所の中に全て含まれていた場合
		match_position array[number]		マッチング座標内容はクエリパラメータのmatch_positionで指定します。 ["経度","緯度"]
		match_kana string		マッチングしたカナ住所文字列。カナ住所でマッチングした場合のみ返却します。
		multi_addr_count integer		重複住所件数
		building_info object	building_type integer	建物・テナント等を判別する区分 3 建物
			zid string	建物ZID 建物等の地物毎にふられるパーマネントのID
			zid_attr string	属性ZID 建物や地物内のテナント施設等といった属性情報毎にふられるパーマネントのID
			position array[number]	["経度","緯度"]

Example

リクエストURL

 https://[domain]/data-coding/ac_standard?word=%E6%9D%B1%E4%BA%AC%E9%83%BD%E5%8D%83%E4%BB%A3%E7%94%B0%E5%8C%BA%E6%B7%A1%E8%B7%AF%E7%94%BA2-101&match_level=TBN&datum=JGD

レスポンス

{
  "status": "OK",
  "result": {
      "info": {
          "hit": 1
      },
      "item": [
          {
              "input_word": "東京都千代田区淡路町2-101",
              "address_code": "131010100020000000007",
              "address": "東京都千代田区神田淡路町2丁目101",
              "address_read_through": "トウキョウトチヨダクカンダアワジチョウニチョウメヒャクイチ",
              "address2": "東京都",
              "address_read_through2": "トウキョウト",
              "address3": "千代田区",
              "address_read_through3": "チヨダク",
              "address4": "神田淡路町",
              "address_read_through4": "カンダアワジチョウ",
              "address5": "２丁目",
              "address_read_through5": "ニチョウメ",
              "address_detail1": null,
              "address_detail_read_through1": null,
              "address_detail2": "101",
              "address_detail_read_through2": "ヒャクイチ",
              "post_code": "101-0063",
              "address_name_type": 1,
              "child_level_flag": 0,
              "match_level": "TBN1",
              "match_flag": 0,
              "match_position": [
                  139.767126193576,
                  35.6975523546007
              ],
              "match_kana": null,
              "multi_addr_count": null,
              "building_info": null
          }
      ]
  }
}