住所・所在地検索（ジオコーダ）API

全国Q地図では、住所・所在地から経緯度（緯度・経度）を検索できるジオコーダAPIを提供しています。デジタル庁アドレス・ベース・レジストリ（ABR）のデータに基づき、全国の住所・所在地をジオコーディング（住所・所在地から座標への変換）できます。

NOTE

本APIは現在試験公開中です。予告なく仕様変更又はサービス停止する場合があります。

住所・所在地検索を試す

下のフォームに住所・所在地を入力すると、ジオコーダAPIの動作を試すことができます。

検索対象:

北九州市門司区役所の住所です。住居番号（号）レベルでの座標精度です。

くじゅう連山の御池の所在地番です。住所以外の所在地番の検索も可能です。

田川警察署英彦山駐在所の所在地番です。座標精度は市町村レベルとなります。

生データ（JSON）を表示

APIの使い方

エンドポイント

GET https://api.qchizu.jp/geocode.php

パラメータ

パラメータ	必須	説明	例
`address`	○	検索する住所・所在地（最大500文字）	`福岡県北九州市門司区清滝1丁目1-1`
`target`	-	検索対象: `all`（全て）、`residential`（住居表示）、`parcel`（地番）。デフォルト: `all`	`residential`

リクエスト例

curl "https://api.qchizu.jp/geocode.php?address=福岡県北九州市門司区清滝1丁目1-1"

レスポンス

レスポンス例

{
  "results": [
    {
      "query": {
        "input": "福岡県北九州市門司区清滝1丁目1-1"
      },
      "result": {
        "output": "福岡県北九州市門司区清滝一丁目1-1",
        "others": [],
        "score": 0.95,
        "match_level": "residential_detail",
        "coordinate_level": "residential_detail",
        "lat": 33.941660431,
        "lon": 130.959552762,
        "lg_code": "401013",
        "machiaza_id": "0036001",
        "rsdt_addr_flg": 1,
        "blk_id": "001",
        "rsdt_id": "001",
        "rsdt2_id": null,
        "prc_id": null,
        "pref": "福岡県",
        "county": null,
        "city": "北九州市",
        "ward": "門司区",
        "oaza_cho": "清滝",
        "chome": "一丁目",
        "koaza": null,
        "blk_num": "1",
        "rsdt_num": "1",
        "rsdt_num2": null,
        "prc_num1": null,
        "prc_num2": null,
        "prc_num3": null
      },
      "links": {
        "qchizu_map": "https://qchizu.jp/maps/#17/33.941660/130.959553/",
        "qchizu_embed": "https://qchizu.jp/maps/index_pm.html#17/33.941660/130.959553/"
      }
    }
  ],
  "attribution": "住所データ: デジタル庁 アドレス・ベース・レジストリ / 地図: 全国Q地図 (https://qchizu.jp)",
  "usage_policy": "本APIの結果を利用する際は、地図に表示する場合は全国Q地図（qchizu.jp）の埋め込み地図を使用してください。地図に表示しない場合（データ保持等）は、全国Q地図の表示用URL（links.qchizu_map）または埋め込み用URL（links.qchizu_embed）を必ず保持・提示してください。",
  "links": {
    "qchizu_top": "https://qchizu.jp/",
    "qchizu_maps": "https://qchizu.jp/maps/",
    "documentation": "https://api.qchizu.jp/openapi.json"
  }
}

主要フィールド

results[] 内の各要素:

フィールド	説明
`result.output`	正規化された住所・所在地
`result.others`	マッチしなかった住所の残り部分（配列）。完全一致の場合は空配列
`result.match_level`	住所正規化レベル（入力住所・所在地をどの階層まで正規化できたか）
`result.coordinate_level`	座標精度レベル（返される座標がどの階層の精度か）。`match_level`とは異なる場合があります（例: 住所・所在地は大字・町まで正規化できたが、座標は市区町村の代表点のみ）
`result.lat` / `result.lon`	緯度・経度（WGS84）。座標不明の場合は `null`
`result.score`	マッチスコア（0〜1、1が完全一致）
`result.lg_code`	全国地方公共団体コード（6桁）
`result.machiaza_id`	町字ID
`result.rsdt_addr_flg`	住居表示フラグ（`1`: 住居表示、`0`: 地番、`-1`: 不明）。マッチレベルが都道府県・市区町村のみの場合はフィールド自体が省略されることがあります
`result.blk_id` / `result.rsdt_id` / `result.rsdt2_id` / `result.prc_id`	街区ID / 住居ID / 住居ID2（枝番） / 地番ID
`result.pref` / `result.county` / `result.city` / `result.ward`	都道府県名 / 郡名 / 市区町村名 / 政令市の区名
`result.oaza_cho` / `result.chome` / `result.koaza`	大字・町名 / 丁目 / 小字名
`result.blk_num` / `result.rsdt_num` / `result.rsdt_num2`	街区符号 / 住居番号 / 住居番号2（枝番）
`result.prc_num1` / `result.prc_num2` / `result.prc_num3`	地番1 / 地番2（枝番） / 地番3（枝番）
`links.qchizu_map`	全国Q地図で当該地点を表示するURL
`links.qchizu_embed`	全国Q地図の埋め込み用URL（iframeで使用可）

トップレベルフィールド:

フィールド	説明
`attribution`	データの出典表示
`usage_policy`	本APIの利用条件
`links.qchizu_top` / `links.qchizu_maps` / `links.documentation`	全国Q地図トップページ / 地図ページ / OpenAPI仕様書の URL

レベル一覧

match_level（住所正規化レベル）と coordinate_level（座標精度レベル）は、いずれも以下の値をとります。

レベル	説明
`error`	ジオコーダ内部エラー
`unknown`	都道府県を特定できなかった
`prefecture`	都道府県レベル
`city`	郡 / 市区町村レベル
`machiaza`	大字・町レベル
`machiaza_detail`	丁目・小字レベル
`residential_block`	街区符号レベル
`residential_detail`	住居番号レベル
`parcel`	地番レベル

例えば、match_level が machiaza（大字・町まで正規化できた）で coordinate_level が city（座標は市区町村の代表点）という場合、住所・所在地の文字列は大字・町まで特定できたものの、その大字・町の座標データが未整備のため市区町村の代表点の座標が返されています。

利用上の注意

試験公開

本APIは現在試験公開中です。予告なく仕様変更又はサービス停止する場合があります。

データ更新に伴うサービス停止

住所・所在地データは毎月更新しています。毎月2日早朝にサービスを停止します。

ジオコーディング精度の制約

本APIはデジタル庁アドレス・ベース・レジストリ（ABR）のデータに基づいています。ABRの整備状況により、以下の制約があります。

ABRの座標整備状況によっては、市町村や大字・町名の代表点にジオコーディングされる場合があります
地番: おおよそ半分程度の地番に対応しています。任意座標整備エリア等では座標が取得できない場合があります
住居表示: おおよそ8〜9割程度の住居表示に対応していると思われます
特殊な地番: イロハが含まれる地番や、支号の支号（孫番）は非対応の可能性があります

利用条件

本APIは、全国Q地図の普及促進を目的として無料で一般公開しています。御利用の際は、以下の条件に従ってください。

地図に表示する場合: 全国Q地図（qchizu.jp）の埋め込み地図（links.qchizu_embed）を使用してください
地図に表示しない場合（データ保持等）: 全国Q地図の表示用URL（links.qchizu_map）又は埋め込み用URL（links.qchizu_embed）を必ず保持・提示してください
出典表示: レスポンスに含まれる attribution の内容を表示してください

NOTE

レート制限があります（300リクエスト/分）。

データについて

住所・所在地データはデジタル庁アドレス・ベース・レジストリ（ABR）に基づいています
データは毎月2日に更新しています
住居表示及び地番の両方に対応しています

OpenAPI仕様

APIの詳細な仕様は、OpenAPI形式で公開しています。

OpenAPI仕様書（JSON）

AI（LLM）やアプリケーションからの利用にも対応しています。OpenAPI仕様書を読み込ませることで、住所・所在地検索機能を簡単に組み込むことができます。