OpenPOI API

日本全国のPOI検索API。Overture Maps と食品営業許可・届出オープンデータを統合した約337万件を検索できるAPIです。

APIを試す

全画面のプレイグラウンドで試す

データについて

  • 出どころ: Overture Maps（約249万件）と、各自治体・厚生労働省が公開する食品営業許可・届出のオープンデータ（Japan Food Facilities、約88万件）を統合しています。ソースごとのライセンスと出典は出典・ライセンスページにあります。
  • 更新頻度: Japan Food Facilities 由来は毎週（日曜 19:00 UTC＝月曜 4:00 JST）に再構築します。Overture Maps 由来はリリース単位の取り込みで、現在のリリースは 2026-08-19.0 に固定しています（毎週は更新されません）。
  • 結果を保存できる: 元データがオープンデータなので、検索結果を自分のデータベースに保存して使えます。地図 API の中には、利用規約で結果の複製・保存やキャッシュを制限しているものがあります。保存した後の義務は検索結果を保存する場合をご覧ください。
  • 品質の限界: 位置のずれ、閉業した施設の残存、ランドマーク非収録などがあります。既知の制約をご覧ください。

ベースURL

https://api.openpoiapi.com
プロトコルHTTPS
認証不要（APIキーの発行はありません）
CORS全オリジン許可（access-control-allow-origin: *）
文字コードUTF-8。クエリは URL エンコードしてください

エンドポイント一覧

GET /v1/suggest

入力途中のキーワードから候補を出す（入力補完）

検索ボックスの入力中に呼ぶエンドポイントです。表記ゆれの吸収・重複除去・並び替えを済ませた候補を返すので、受け取った順にそのまま描画できます。施設候補に加えて、カテゴリ・ブランド・地名の語彙（vocabulary）と、入力欄に重ねて表示できる補完文字列（completion）も返します。

備考

  • 探す範囲は bbox の中が先で、0件のときだけ全国に広げます。どちらを使ったかは scope で分かります。
  • 2文字以下の語だけの入力は、bbox か center を指定したときだけ結果を返します。

パラメータ

名前型必須既定値説明
q string 任意 — 入力途中のキーワード。スペース区切りで複数語可（全語をANDで絞る）。施設名・カナ・都道府県・市区町村・住所を横断検索。省略時（空文字含む）は検索を行わず、`{ count: 0, scope: "view", suggestions: [], vocabulary: [], completion: null }` を返す（エラーにはならない）。
例: すたーば
bbox string 任意 — 地図の表示範囲「minLng,minLat,maxLng,maxLat」。まずこの中から候補を探す。
例: 139.6,35.5,139.9,35.8
center string 任意 — 地図中心「lng,lat」（経度が先）。近い順の並び替えに使う。bbox 省略時は radius と組み合わせて表示範囲を作る。
例: 139.75,35.66
radius integer 任意 50000 center からの半径（メートル）。bbox が無いときだけ使う。
limit integer 任意 8 返す候補の最大件数（1〜20にクランプ）。
fields enum(full, minimal) 任意 full "minimal" を指定すると、候補1件ごとの category/business_type/source/licenses/attributions を省いた軽量なレスポンス（MinimalSuggestion。licenses/attributions はレスポンス直下に1回だけ載る）を返す。未指定・"full"・不明な値はすべて従来どおりの完全なレスポンスになる（後方互換）。

レスポンス

  • 200 候補（そのまま一覧に出せる並び） — SuggestResponse
  • 400 クエリの実行エラー — Error

例

入力補完（「すたーば」。地図の表示範囲 bbox 内）

リクエスト

# curl 'https://api.openpoiapi.com/v1/suggest?q=すたーば&bbox=139.6,35.5,139.9,35.8&limit=2'
curl 'https://api.openpoiapi.com/v1/suggest?q=%E3%81%99%E3%81%9F%E3%83%BC%E3%81%B0&bbox=139.6,35.5,139.9,35.8&limit=2'

レスポンス

{
  "count": 2,
  "scope": "view",
  "suggestions": [
    {
      "name": "スターバックスコーヒー用賀店",
      "address": "東京都世田谷区瀬田五丁目３９番２２号 -",
      "prefecture": "東京都",
      "city": "世田谷区",
      "lat": 35.626406,
      "lng": 139.626422,
      "level": 8,
      "category": "restaurant",
      "business_type": "restaurant",
      "source": "jff",
      "licenses": [
        "CC BY 4.0",
        "CDLA-Permissive-2.0",
        "公共データ利用規約（第1.0版, PDL1.0）"
      ],
      "attributions": [
        "Overture Maps Foundation, overturemaps.org",
        "厚生労働省 食品衛生申請等システム（オープンデータ）",
        "東京都世田谷区食品衛生営業許可施設"
      ],
      "matched": [
        "すたーば"
      ]
    },
    {
      "name": "スターバックスコーヒー明大前店",
      "address": "東京都世田谷区松原二丁目４６番５号 Ｒｙｕ＇ｓビル１Ｆ",
      "prefecture": "東京都",
      "city": "世田谷区",
      "lat": 35.669038,
      "lng": 139.650036,
      "level": 8,
      "category": "restaurant",
      "business_type": "restaurant",
      "source": "jff",
      "licenses": [
        "CC BY 4.0",
        "公共データ利用規約（第1.0版, PDL1.0）"
      ],
      "attributions": [
        "厚生労働省 食品衛生申請等システム（オープンデータ）",
        "東京都世田谷区食品衛生営業許可施設"
      ],
      "matched": [
        "すたーば"
      ]
    }
  ],
  "vocabulary": [
    {
      "type": "brand",
      "label": "スターバックス",
      "query": "スターバックス"
    }
  ],
  "completion": null
}

GET /

ランディング（目次JSON）

ドメインをブラウザで開いたときに検索結果のJSONが返らないよう、検索結果ではなくopenapi.json へのリンクと主要エンドポイントの一覧を返します。

例

ランディング

リクエスト

curl 'https://api.openpoiapi.com/'

レスポンス

{
  "name": "OpenPOI API",
  "description": "日本全国のPOI（Overture Maps + 食品営業許可・届出オープンデータを統合した約337万件）を検索するAPI。詳細は openapi.json を参照。",
  "documentation": "/openapi.json",
  "endpoints": {
    "search": "/v1/search",
    "suggest": "/v1/suggest",
    "openapi": "/openapi.json",
    "mcp": "/mcp"
  }
}

GET /openapi.json

OpenAPI 3.1 定義を返す

このページの生成元となる OpenAPI 定義です。servers にはリクエストされたホストが設定されます。ChatGPT の Custom GPT（Actions）やコーディングエージェントによるクライアント生成には、この URL をそのまま渡せます。

例

OpenAPI 定義（一部のみ表示）

リクエスト

curl 'https://api.openpoiapi.com/openapi.json'

レスポンス

{
  "openapi": "3.1.0",
  "info": "…（省略）",
  "servers": [
    {
      "url": "https://api.openpoiapi.com"
    }
  ],
  "paths": "…（省略）",
  "components": "…（省略）"
}

POST /mcp

MCP サーバー（Streamable HTTP・ステートレス）

AI エージェントから使うための MCP（Model Context Protocol）サーバーです。公開ツールは search_facilities（GET /v1/search と同じ検索）とdataset_info（データセットの概要・出典）の2つです。Claude Code には claude mcp add --transport http japan-facilities https://api.openpoiapi.com/mcp で追加できます。

備考

  • JSON-RPC 2.0 を1リクエスト1レスポンス（application/json）で処理します。セッションIDの発行と GET の SSE ストリームは提供しません。
  • 対応プロトコルバージョン: 2025-06-18 / 2025-03-26 / 2024-11-05

例

initialize

リクエスト（POST https://api.openpoiapi.com/mcp、content-type: application/json）

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "curl",
      "version": "0"
    }
  }
}

レスポンス

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": {
      "tools": {
        "listChanged": false
      }
    },
    "serverInfo": {
      "name": "openpoi-api",
      "title": "OpenPOI API（日本全国のPOI検索。Overture Maps + Japan Food Facilities）",
      "version": "0.1.0"
    },
    "instructions": "日本全国のPOIを検索できます（Overture Maps 約249万件 + 食品営業許可・届出オープンデータ Japan Food Facilities 約88万件、合計約337万件）。\n「近くのラーメン屋」のような検索は search_facilities に q と center_lng/center_lat を渡してください。\nライセンスは元データの提供元ごとに異なり、利用時は出典表示が必要です。dataset_info で確認できます。"
  }
}
tools/call（search_facilities）

リクエスト（POST https://api.openpoiapi.com/mcp、content-type: application/json）

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_facilities",
    "arguments": {
      "q": "書店",
      "limit": 1
    }
  }
}

レスポンス

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"count\":1,\"results\":[{\"name\":\"100000tアローントコ\",\"name_kana\":\"\",\"prefecture\":\"\",\"city\":\"京都市中京区\",\"address\":\"\",\"category\":\"retail_other\",\"business_type\":\"retail_other\",\"lat\":35.01133436,\"lng\":135.7671323,\"level\":\"\",\"source\":\"overture\",\"licenses\":[\"CDLA-Permissive-2.0\"],\"attributions\":[\"Overture Maps Foundation, overturemaps.org\"]}]}"
      }
    ],
    "structuredContent": {
      "count": 1,
      "results": [
        {
          "name": "100000tアローントコ",
          "name_kana": "",
          "prefecture": "",
          "city": "京都市中京区",
          "address": "",
          "category": "retail_other",
          "business_type": "retail_other",
          "lat": 35.01133436,
          "lng": 135.7671323,
          "level": "",
          "source": "overture",
          "licenses": [
            "CDLA-Permissive-2.0"
          ],
          "attributions": [
            "Overture Maps Foundation, overturemaps.org"
          ]
        }
      ]
    }
  }
}

レスポンスの形

openapi.json の components.schemas に基づく定義です。

Facility

施設1件。1レコードは1件の営業許可・届出を表す（同一施設が業種違いで複数レコードになることがある）

名前型必須説明
name string 任意 施設名
name_kana string 任意 施設名カナ
prefecture string 任意 都道府県
city string 任意 市区町村（正規化済み）
address string 任意 所在地
category string 任意 正規化カテゴリ（複数ソース統合後の統一語彙）。データ提供元でカテゴリ情報が乏しいレコードでは "unknown" になる
business_type string 任意 営業許可・届出の業種（例: 飲食店営業）。category と同値（後方互換のため残している）
lat number | string 任意 緯度（WGS84）。座標が無い施設は空文字
lng number | string 任意 経度（WGS84）。座標が無い施設は空文字
level integer | string | null 任意 ジオコーディング精度（1=都道府県 2=市区町村 3=町丁目 8=街区・地番。小さいほど大まか）
source string 任意 代表レコードの出所ソース識別子（例: "jff" / "overture"）。複数ソースが統合された施設でも値は単一の文字列（配列ではない）
licenses array<string> 任意 出所元のライセンス一覧。複数ソースが統合された施設では和集合（重複除去済み）
attributions array<string> 任意 出所元の帰属表示（参考情報。画面表示は不要）。統合された施設では全ソース分を含む。保存するときはこの配列も一緒に保存すること。詳細は https://openpoiapi.com/attribution.html

SearchResponse

名前型必須説明
count integer 必須 返した件数
results array<> 必須

Suggestion

入力補完の候補1件。表示（名前・住所）と地図移動（緯度経度）に必要な項目だけを持ち、座標が無い施設は含まれない

名前型必須説明
name string 必須 施設名
address string 必須 住所（都道府県から始まる形にそろえてある。そのまま1行で表示できる）
prefecture string 任意 都道府県
city string 任意 市区町村（正規化済み）
category string 任意 正規化カテゴリ（複数ソース統合後の統一語彙）。データ提供元でカテゴリ情報が乏しいレコードでは "unknown" になる
business_type string 任意 営業許可・届出の業種（例: 飲食店営業）。category と同値（後方互換のため残している）
lat number 必須 緯度（WGS84）
lng number 必須 経度（WGS84）
level integer | null 任意 ジオコーディング精度（1=都道府県 2=市区町村 3=町丁目 8=街区・地番。不明は null）
source string 任意 代表レコードの出所ソース識別子（例: "jff" / "overture"）。複数ソースが統合された施設でも値は単一の文字列（配列ではない）
licenses array<string> 任意 出所元のライセンス一覧。複数ソースが統合された施設では和集合（重複除去済み）
attributions array<string> 任意 出所元の帰属表示（参考情報。画面表示は不要）。統合された施設では全ソース分を含む。保存するときはこの配列も一緒に保存すること。詳細は https://openpoiapi.com/attribution.html
matched array<string> 任意 この候補の name に含まれていた入力語（表記ゆれを正規化して判定し、入力された表記のまま返す）。一致部分の強調表示などに使える。辞書の展開語だけで当たった語は含まない

MinimalSuggestion

fields=minimal のときの候補1件。category/business_type/source/licenses/attributions を持たない（それらは SuggestResponse 直下の licenses/attributions を参照）

名前型必須説明
name string 必須 施設名
address string 必須 住所（都道府県から始まる形にそろえてある。そのまま1行で表示できる）
prefecture string 任意 都道府県
city string 任意 市区町村（正規化済み）
lat number 必須 緯度（WGS84）
lng number 必須 経度（WGS84）
level integer | null 任意 ジオコーディング精度（1=都道府県 2=市区町村 3=町丁目 8=街区・地番。不明は null）
matched array<string> 任意 この候補の name に含まれていた入力語（表記ゆれを正規化して判定し、入力された表記のまま返す）。一致部分の強調表示などに使える。辞書の展開語だけで当たった語は含まない

SuggestResponse

名前型必須説明
count integer 必須 返した候補の件数
scope enum(view, nationwide) 必須 どの範囲で見つけたか。view = 指定された表示範囲の中、nationwide = 表示範囲で0件だったため全国へ広げた
suggestions array<> 必須 候補（良い順に並んでいる。呼び出し側での並び替えは不要）。fields=minimal のときは各要素が MinimalSuggestion になる。
vocabulary array<> 任意 入力に前方一致したカテゴリ・ブランド・地名の語彙（最大5件。良い順）。1文字の入力や suggestions が空のときも返す
completion string | null 任意 入力の続きとして入力欄に薄く重ねて出せる補完文字列（ゴーストテキスト用）。suggestions 先頭の name が入力 q で始まればその name、そうでなく vocabulary 先頭の label が q で始まればその label、どちらも無ければ null。比較は正規化前の文字列のまま行う
licenses array<string> 任意 fields=minimal のときだけ存在する。返した suggestions 全件分のライセンス一覧（和集合・重複除去済み）
attributions array<string> 任意 fields=minimal のときだけ存在する。suggestions 全件分の帰属表示（和集合・重複除去済み。参考情報で画面表示は不要）

VocabularyItem

語彙1件（カテゴリ・ブランド・地名）。type で形が変わる。place のときだけ prefecture/city/center/bbox/count を持つ

名前型必須説明
type enum(category, brand, place) 必須 category = 業種・カテゴリ（例: ラーメン）/ brand = チェーン店名（例: スターバックス）/ place = 都道府県・市区町村
label string 必須 表示名
query string 必須 この語彙が選ばれたときに、検索し直すのに使えばよい文字列（q にそのまま渡せる）
prefecture string 任意 place のみ。都道府県
city string 任意 place のみ。市区町村（都道府県そのものの語彙では空文字）
center array<number> 任意 place のみ。代表点 [lng, lat]（その地名に属する施設座標の平均）
bbox array<number> 任意 place のみ。範囲 [minLng, minLat, maxLng, maxLat]（その地名に属する施設座標の最小・最大。座標の外れ値があると広がることがある）
count integer 任意 place のみ。その地名に属する施設（座標あり）の件数

Error

名前型必須説明
error string 任意 エラーメッセージ
代表ソースを示すフィールドは source（単数）です。sources（配列）は返しません。

エラーレスポンス

GET /v1/search と GET /v1/suggest は、クエリの実行に失敗すると HTTPステータス 400 とボディ { "error": "..." }（Error スキーマ）を返します。通常の不正入力（例: limit=abc）は既定値にフォールバックし、200 を返します。

400 の例（q に NUL バイトを含めた場合）

リクエスト

curl -i 'https://api.openpoiapi.com/v1/search?q=%00abc'

レスポンス

HTTP/1.1 400
{
  "error": "unterminated string"
}

API 全体のレート上限（定常 200 req/s・バースト 600 req/s）を超えると 429 になります。このレスポンスは API Gateway が生成するため、ボディは { "message": "Too Many Requests" } で、 CORS ヘッダは付きません。ブラウザからは CORS エラーとして観測されます。

よくある質問

商用利用はできますか。

できます。商用・非商用を問わず利用できます。ただし配信データのライセンスは提供元ごとに異なり、商用利用できてもデータ側の義務は免除されません。出典・ライセンスをご確認ください。

出典表示には何が必要ですか。

出典として OpenPOI API を記載し、出典・ライセンスページへリンクしてください。たとえば次のように記載します。 

<a href="https://openpoiapi.com/attribution.html">OpenPOI API</a>
リンクを設置できない媒体では、次の形でも構いません。 
出典: OpenPOI API（https://openpoiapi.com/attribution.html）
https://openpoiapi.com/attribution.html に使用データの詳細を掲載しています。

検索結果を自分のデータベースに保存できますか。保存すると出典表示は変わりますか。

保存できます。licenses と attributions もレコードと一緒に保存してください。保存しただけなら追加の義務が生じないライセンスが多い一方、保存したデータを画面に出す・第三者に渡す・加工して公開する場合は義務が生じます。詳しくは検索結果を保存する場合をご覧ください。

APIキーは必要ですか。

不要です。認証なしで利用できます。今後、提供形態（レート制限やAPIキーによる利用登録）を変更する場合は、 利用規約を改定して告知します。

レート制限はありますか。

利用者ごとの制限はありません。API 全体で定常 200 req/s・バースト 600 req/s を超えると 429 を返します（詳細はエラーレスポンス）。

データはどのくらいの頻度で更新されますか。

Japan Food Facilities 由来のデータは、元データが毎週更新されるのに合わせて、毎週日曜 19:00 UTC（月曜 4:00 JST）に再構築します。 Overture Maps 由来のデータは、リリース単位で取り込みます（現在のリリースは 2026-08-19.0）。

対応地域はどこですか。

日本全国です。

/v1/search と /v1/suggest はどう使い分けますか。

検索ボックスの入力補完には /v1/suggest を使います。表記ゆれの吸収、複数語の AND 判定、重複除去、並び替えをサーバー側で済ませた候補を返します。キーワードや範囲で施設を一覧・取得する用途には /v1/search を使います（複数語は OR で広く候補を返します）。カテゴリ・ブランド・地名の語彙は、/v1/suggest の応答の vocabulary に入っています（1文字の入力でも返ります）。

表記ゆれは吸収されますか。

/v1/suggest は、全角半角・大文字小文字・ひらがなカタカナの違いを吸収します。 /v1/search は、ひらがなとカタカナで同じ結果を返しますが、半角カナと全角カナでは結果が異なります。表記ゆれをまとめて吸収するには /v1/suggest を使ってください。

AI エージェントから使えますか。

POST https://api.openpoiapi.com/mcp が MCP サーバーとして使えます。Claude Code には claude mcp add --transport http japan-facilities https://api.openpoiapi.com/mcp で追加できます。 OpenAPI 定義（https://api.openpoiapi.com/openapi.json）は、ChatGPT の Custom GPT などにそのまま渡せます。

ご質問・不具合・データの誤りは、どこに連絡すればよいですか。

security@openpoiapi.com が窓口です。対応はベストエフォートで、回答期限の保証はありません（サポート窓口）。

出典・ライセンス

出典として OpenPOI API を記載し、出典・ライセンスページへリンクしてください。

記載例です。

<a href="https://openpoiapi.com/attribution.html">OpenPOI API</a>

リンクを設置できない媒体（印刷物・音声など）では、次の形でも構いません。

出典: OpenPOI API（https://openpoiapi.com/attribution.html）

https://openpoiapi.com/attribution.html に使用データの詳細を掲載しています。

レスポンスの licenses / attributions は、レコードに適用されるライセンスをプログラムで判定するための参考情報です。画面への表示は求められていません。

データソースライセンス掲示の要件
Overture Maps（Places テーマ）CDLA-Permissive-2.0出典として OpenPOI API を記載し、出典・ライセンスページへリンクする
Overture Maps 内 Foursquare 由来分Apache-2.0NOTICE.txt を開発者向けドキュメントに掲載する（下記に全文を掲載済み）。エンドユーザー画面への表示は NOTICE.txt の要件に含まれない
Japan Food Facilities（JFF）CC BY 系 + 公共データ利用規約（PDL1.0）が混在出典として OpenPOI API を記載し、出典・ライセンスページへリンクする

Overture Maps のデータは、提供元ごとにライセンスと表記が決められています。上の表は本APIが確認した時点の内容です。最新の条件は Overture Maps の帰属表示ページ でご自身でご確認ください。

検索結果を保存する場合

検索結果は自分のデータベースに保存できます。licenses と attributions を配列のまま一緒に保存してください。 義務が生じるのは保存した先の使い方によるため、後から出典を示せる状態にしておく必要があります。

したいこと必要なこと
保存する追加の義務は生じません。ただし licenses と attributions は配列のまま一緒に保存してください。
画面に出す出典として OpenPOI API を記載し、出典・ライセンスページへリンクします。保存していない場合と同じです。
第三者に渡すライセンスごとの再配布条件が加わります。CDLA は契約書の全文（または参照先）、Apache-2.0 は License の写しと NOTICE、CC BY は出典・ライセンスへのリンクと変更の有無。
加工して公開する上記に加えて、加工したことと加工した主体（あなた）を記載します。

各ライセンスの原文（2026-09-30 取得）を読んだ内容で、法的助言ではありません。公共データ利用規約1.0版と CC BY 2.1 JP は義務の起点が「利用する際」で、保存が含まれるかは原文から断定できません。Apache-2.0（Foursquare 由来）は第4条の条件が複製と頒布に掛かる書き方で、保存だけが対象かは断定できません。上記のとおり保存しておけば、義務が生じた時点で示せます。

利用規約・プライバシーポリシー・サポート窓口は利用規約・プライバシー・サポートに掲載しています。

Foursquare NOTICE.txt

Overture Maps に含まれる Foursquare 由来のデータ（licenses に Apache-2.0 を含むレコード）は、 Apache License 2.0 で提供されています。Foursquare は、API の形でデータを配信する場合に、 NOTICE.txt の内容を開発者向けドキュメントに掲載するよう求めています。以下が NOTICE.txt の全文です。

取得日: 2026-09-23／取得元: https://opensource.foursquare.com/places-notice-txt/

© 2026 Foursquare Labs, Inc. All rights reserved.

The Foursquare OS Places dataset (the "Data") is licensed under the Apache License, Version 2.0 (the "License"). You may not use, modify, or distribute the Data except in compliance with the License.

As set forth more fully in the License, if you use, modify, or distribute the Data, you must:
- provide recipients with a copy of the License.
- if applicable, include prominent notices to the extent you've changed the Data.
- preserve attribution to Foursquare, including preserving the full content of this NOTICE.txt file.

To ensure appropriate attribution to Foursquare, we recommend the following:
- if using/distributing the Data in flat file form as-is or after making changes/modifications: include this NOTICE.txt file, which may be modified to include an additional notice of your changes/modifications, if any.
- if using/distributing the Data in API form as-is or after making changes/modifications: include a copy of the content from this NOTICE.txt file prominently in your developer documentation for such API, which may be modified to include an additional notice of your changes/modifications, if any.

You may obtain a copy of the License at:
http://www.apache.org/licenses/LICENSE-2.0
. Unless required by applicable law or agreed to in writing, the Data distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.

We also encourage you to join our Placemaker community where you can contribute and provide suggestions to improve the accuracy of the Data for future releases for yourself and others.

本APIが加えた変更の通知

OpenPOI API は、Foursquare 由来データを含む Overture Maps Places テーマのレコードに対し、他ソース（Japan Food Facilities 等）との名寄せ（正規化・重複排除）と、複数レコード間での緯度経度の統合処理を行っています。変更の主体は OpenPOI API（本APIの運営者）です。

既知の制約

  • category / business_type の多くが "unknown"（実データで実測: 1,840,570件 / 全3,372,487件 ≈ 54.6%）。Overture 由来レコードで正規化カテゴリが未整備な語彙が多いため。
  • 位置がずれたレコードがあります。Overture Maps の座標をそのまま採用しているため、観光地・駅・公園などの名前を持つレコードで、数 km から数百 km ずれる例を確認しています。食品営業許可データ（Japan Food Facilities）由来は住所からの位置で、同じ建物の店舗は同じ座標になります。
  • 閉業・閉鎖した施設が残っていることがあります。元データに閉業の情報が無いか、反映が遅れるためです。鮮度を示す値は、現在レスポンスに含まれません。
  • 東京スカイツリーのような観光名所・ランドマーク自体は、収録対象ではありません。店舗・施設の検索が主な用途です。名前で探すと、周辺のテナントや同名の店舗が返ります。
  • /v1/search の複数語は OR で広く候補を返し、center が無いと関連度順にも距離順にもなりません。Tokyo Skytree や ラーメン 渋谷 のような検索では、無関係な結果が先頭に並ぶことがあります。center の指定か /v1/suggest を使ってください。
  • 網羅性は元データ次第で、実在する施設が収録されていないことがあります。