Japanese POI API: 2.63M Points of Interest with Derived Signals | koteihi-lab

日本のPOI APIが解決する課題

日本国内の店舗・クリニック・ホテル・駅の位置情報が必要なサービスを開発する場合、現在の選択肢は3つしかなく、すべてに課題があります。

• Google Places API — 精度は高いが、利用規約で検索結果の保存・キャッシュが明示的に禁止。月額100ドルからの有料プランが必要で、データベースへの保存は不可。
• OpenStreetMap — 無料で保存・キャッシュ可能だが、日本の主要都市以外のカバー率が低く、POIの品質管理とカテゴリ付与を自社で行う必要がある。
• OpenPOI — Overture Mapsと81の自治体飲食施設データセットをベースとした生データ。ただしレコードそのままの出荷で、11.3%がカテゴリ未設定、座標のズレも多い。

本APIはその生データを衛生処理し、生のルックアップではなく集約された派生シグナルを販売します。Google Maps Platformの公式価格（スターター100ドル/月、エッセンシャルズ275ドル/月、プロ1200ドル/月、新規登録で300ドルの試用クレジット）と比較して、従量課金で無料枠から利用可能です。

提供する5つの派生シグナルと料金

カテゴリ別POI件数（主要カテゴリ20項目）

駅圏集計（半径500m、主要駅20駅）

Google Places APIとの料金・条件比較

無料で今すぐ利用（APIキー不要）

無料エンドポイントはアカウント登録・APIキーなしで即座に利用できます。東京都の自治体センサス例：

curl "https://koteihi-lab.local-connect-design.trade/api/v1/poi/municipality?prefecture=%E6%9D%B1%E4%BA%AC"

{
  "census": {
    "\u6771\u4eac": {
      "restaurant": 41288,
      "cafe": 4391,
      "retail": 18204,
      "service_medical": 6122
    }
  },
  "extra": { "prefectures": 105, "backfilled": 124821, "total": 2629417 },
  "attribution": "Source: koteihi-lab Japan Data Foundry, derived from OpenPOI"
}

有料エンドポイントも同じ形式で回答し、最初に402が返ります：

curl -i "https://koteihi-lab.local-connect-design.trade/api/v1/poi/catchment?limit=3"

HTTP/2 402
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6MiwiYWNjZXB0cyI6W3sic2NoZW1lIjoiZXhhY3Qi...

{"x402Version":2,"error":"payment_required","accepts":[
  {"scheme":"exact","network":"eip155:8453","amount":"50000",
   "asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "payTo":"0x...","resource":{"serviceName":"Japan Places",...},
   "extra":{"priceUsd":0.05,"creditPacks":[{"usd":5,"calls":100}]}}
]}

アカウント登録不要での支払い

サインアップはフローのどこにもありません。402レスポンスボディには正確な金額、資産、ネットワーク、送金先アドレスが記載されています。Baseネットワーク上でUSDC送金承認に署名し、PAYMENT-SIGNATUREヘッダーでリトライすると、ファシリテーターが決済を完了します。1コールごとに署名したくない場合は、クレジットパックが5ドルで100コール、20ドルで500コールです。

署名するまで料金は発生せず、402と決済の間で金額が変更されることはありません。要件に固定されているためです。

AIエージェント向けMCP接続

/mcpエンドポイントは同じ5つのシグナルを公開します。有料ツールはpayment_required結果を返し、PAYMENT-REQUIREDヘッダーを含むため、エージェントは2回目のリクエストなしで支払いを構築・署名できます：

claude mcp add --transport http japan-places https://koteihi-lab.local-connect-design.trade/mcp

データをパッケージに同梱した完全オフラインインストールの例：

npx -y @modelcontextprotocol/server-japan-places

ライセンス、平易に説明

• 無料枠はCC BY 4.0。商用利用、保存、キャッシュ、改変、再配布はすべて許可。
• 結果を自社データベースに保存可能。これはほとんどの位置情報APIが禁止している部分です。
• レコードごとのlicensesとattributions配列を保持し、データを表示する場所で帰属リンクを表示してください。
• 有料枠は同じデータと同じ権限で、より高い制限枠となります。

上流ライセンスチェーン（Overture MapsはCDLA-Permissive-2.0およびApache-2.0、81の自治体データセットはCC BYおよびPDL-1.0、国土交通省データはCC BY 4.0）と、当社が行った変更の一覧は帰属ページに記載されています。

できないこと

制限事項ページに公開済みですが、短い版：11.3%の生データレコードはカテゴリ未設定、一部座標にズレがあり、閉店した店舗は週次リビルドまで残存し、日本の事業所の完全なセンサスではありません。品質シグナルでフィルタし、営業中確率インデックスで優先順位を付けてください。

利用開始

• ランディングページ、エンドポイント、料金
• OpenAPI 3.0仕様
• Pythonクライアント / TypeScriptクライアント
• llms.txt — このページの機械可読版

よくある質問（FAQ）