このサイトは性能確認デモ用です。利用した結果生じるいかなる損害に対しても責任を負いません。個人情報等を含むデータは決して送信しないでください。実運用するにはこちらからコードを取得して自組織内にサーバを設置してください。

住所ジオコーディングAPI

住所を検索して緯度経度などの情報を取得します。

リクエスト例

例：西新宿2丁目8-1を東京都から検索し、オプション項目allを含める。

    get https://jageocoder.info-proto.com/geocode?addr=%E8%A5%BF%E6%96%B0%E5%AE%BF2%E4%B8%81%E7%9B%AE8-1&area=%E6%9D%B1%E4%BA%AC%E9%83%BD&opts=all

リクエスト項目

HTTP method は GET または POST が利用できます。

addr

解析したい住所文字列
area

検索対象とする都道府県・市区町村。複数指定したい場合はカンマで区切ってください。
opts
レスポンスに含めるオプション項目。
- postcode
  
  郵便番号(7桁、ハイフンを含まない)
- prefcode
  
  JIS X 0401 の都道府県コード(2桁)
- citycode
  
  JIS X 0402 の市区町村コード(5桁)
- lgcode
  
  総務省の全国地方公共団体コード(6桁)
- azaid
  
  アドレス・ベース・レジストリの町字ID(7桁)
- all
  
  上記すべて

レスポンス例

[
  {
    "matched": "西新宿2丁目8-",
    "node": {
      "azaid": "0023002",
      "citycode": "13104",
      "fullname": [
        "東京都",
        "新宿区",
        "西新宿",
        "二丁目",
        "8番"
      ],
      "id": 80223284,
      "level": 7,
      "lgcode": "131041",
      "name": "8番",
      "note": "",
      "parent_id": 80223179,
      "postcode": "1600023",
      "prefcode": "13",
      "priority": 3,
      "sibling_id": 80223285,
      "x": 139.6917724609375,
      "y": 35.68962860107422
    }
  }
]

レスポンス項目

node

一致した末尾の住所ノード。
- id
  
  ノードのID。ただしこの ID は辞書の内部IDであり、辞書のバージョンによって変化するので、住所の識別子としては利用できません。
- name
  
  ノードの表記。
- level
  
  住所レベル（1:都道府県, 2:郡, 3:市町村・23特別区, 4:政令市の区, 5:大字, 6:字・丁目, 7:街区・地番, 8:住居番号・枝番）。
- priority
  
  出典となるデータセットに指定された優先度の値。
- note
  
  注記。各種コードなどを含みます。
- fullname
  
  住所要素表記のリスト。
- postcode
  
  郵便番号(optsにpostcodeまたはallを指定した場合に追加)。
- prefcode
  
  都道府県コード(optsにprefcodeまたはallを指定した場合に追加)。
- citycode
  
  市区町村コード(optsにcitycodeまたはallを指定した場合に追加)。
- lgcode
  
  全国地方公共団体コード(optsにlgcodeまたはallを指定した場合に追加)。
- azaid
  
  町字ID(optsにazaidまたはallを指定した場合に追加)。
matched

住所として解析できた文字列。

リバース住所ジオコーディングAPI

検索地点を緯度経度で指定し、その地点を囲む3点の住所を取得します。半島の先端や住所ノードがまばらな場合など、3点が見つからない場合もあります。

リクエスト例

例：北緯35.689472度, 東経139.69175度をレベル(7)まで検索し、オプション項目allを含める。

      get https://jageocoder.info-proto.com/rgeocode?lat=35.689472&lon=139.69175&level=7&opts=all

リクエスト項目

HTTP method は GET または POST が利用できます。

lat

検索地点の緯度（10進度）。
lon

検索地点の経度（10進度）。
level

検索する住所レベル（1:都道府県, 2:郡, 3:市町村・23特別区, 4:政令市の区, 5:大字, 6:字・丁目, 7:街区・地番, 8:住居番号・枝番）。
opts

レスポンスに含めるオプション項目。選択肢はジオコーディングAPIと同じです。

レスポンス例

[
  {
    "candidate": {
      "azaid": "0023002",
      "citycode": "13104",
      "fullname": [
        "東京都",
        "新宿区",
        "西新宿",
        "二丁目",
        "8番"
      ],
      "id": 80223284,
      "level": 7,
      "lgcode": "131041",
      "name": "8番",
      "note": "",
      "parent_id": 80223179,
      "postcode": "1600023",
      "prefcode": "13",
      "priority": 3,
      "sibling_id": 80223285,
      "x": 139.6917724609375,
      "y": 35.68962860107422
    },
    "dist": 17.493937852135367
  },
  {
    "candidate": {
      "azaid": "0023002",
      "citycode": "13104",
      "fullname": [
        "東京都",
        "新宿区",
        "西新宿",
        "二丁目",
        "9番"
      ],
      "id": 80223286,
      "level": 7,
      "lgcode": "131041",
      "name": "9番",
      "note": "",
      "parent_id": 80223179,
      "postcode": "1600023",
      "prefcode": "13",
      "priority": 3,
      "sibling_id": 80223287,
      "x": 139.692138671875,
      "y": 35.688079833984375
    },
    "dist": 158.42114875469414
  },
  {
    "candidate": {
      "azaid": "0023002",
      "citycode": "13104",
      "fullname": [
        "東京都",
        "新宿区",
        "西新宿",
        "二丁目",
        "10番"
      ],
      "id": 80223182,
      "level": 7,
      "lgcode": "131041",
      "name": "10番",
      "note": "",
      "parent_id": 80223179,
      "postcode": "1600023",
      "prefcode": "13",
      "priority": 3,
      "sibling_id": 80223183,
      "x": 139.689697265625,
      "y": 35.687679290771484
    },
    "dist": 272.1914944403067
  }
]

レスポンス項目

candidate

候補の住所ノード。各項目の意味はジオコーディングAPI のレスポンス項目を参照してください。
dist

検索地点から候補の住所ノードの代表点までの距離（メートル）。