📍 周辺情報マップ — RESUTOOL 連携仕様

1. 概要

周辺情報マップ https://hatakan-dx.com/map/ は、
URL クエリパラメータで 対象地の緯度経度 を渡すことで、 その地点を中心に都市計画・防災・周辺施設等のレイヤを重ねた地図を表示します。

RESUTOOL の物件詳細画面に「周辺情報マップを開く」ボタンを設置し、 クリック時に window.open() で本URLを別タブで開くだけで連携完了です。

2. URL クエリパラメータ

基本パラメータ

3. 実装例

シンプル版（最小実装）

RESUTOOL に「周辺情報マップを開く」ボタンを追加：

<button onclick="openParcelMap()">周辺情報マップを開く</button>

<script>
function openParcelMap() {
  // RESUTOOL の対象物件データから緯度経度を取得
  const lat = parcel.latitude;   // 例: 33.5588
  const lng = parcel.longitude;  // 例: 133.5314
  const name = parcel.address;   // 例: "高知市福井町1611-9"

  const url = `https://hatakan-dx.com/map/?lat=${lat}&lng=${lng}`
            + `&name=${encodeURIComponent(name)}`;
  window.open(url, '_blank', 'noopener,width=1280,height=900');
}
</script>

応用版（推奨：都市計画区域を自動ON）

鑑定業務で最初に確認したい都市計画区域の境界を起動時に表示：

function openParcelMap() {
  const params = new URLSearchParams({
    lat: parcel.latitude,
    lng: parcel.longitude,
    name: parcel.address,
    z: 17,
    layers: 'XKT001',          // 都市計画区域の境界を自動ON
    base: 'pale',              // 淡色地図を初期選択
  });
  window.open(
    `https://hatakan-dx.com/map/?${params.toString()}`,
    'parcel_map',  // 同名ウィンドウを再利用（複数物件を見比べる際に便利）
    'noopener'
  );
}

完全版（推奨：対象地ポリゴンも同時に渡す）

RESUTOOL の物件調査画面と同じく、対象地の範囲（オレンジ枠）も地図上に表示：

function openParcelMap() {
  // RESUTOOL が既に保持している対象地データを使用
  const lat      = parcel.center_lat;        // 33.5588
  const lng      = parcel.center_lng;        // 133.5314
  const name     = parcel.management_no;     // "研修会サンプル②"
  const boundary = parcel.boundary_coords;   // [[lng,lat], [lng,lat], ...]

  const params = new URLSearchParams({
    lat, lng, name,
    polygon: JSON.stringify(boundary),  // ← 対象地ポリゴン
    layers:  'XKT001',
    base:    'pale',
  });

  window.open(
    `https://hatakan-dx.com/map/?${params.toString()}`,
    'parcel_map',
    'noopener'
  );
}

4. 利用可能なレイヤID 一覧

?layers= パラメータに指定できるレイヤIDです。複数指定する場合はカンマ区切り。

都市計画情報

防災情報

価格情報

周辺施設情報

人口情報

地形・地理院オーバーレイ

5. 動作確認デモ

下記ボタンで実際に表示できます。RESUTOOL 側の実装イメージとしてご確認ください。

6. よくある質問

Q. RESUTOOL のドメインから呼び出しても表示できますか？

はい。URL を window.open() で開くだけなので、CORS や Origin 制限の影響を受けません。

Q. iframe で埋め込みは可能ですか？

技術的には可能ですが、地図のインタラクション領域が確保しにくいため、別タブで開く方式を推奨します。 どうしても iframe が必要な場合はご相談ください（X-Frame-Options の調整が必要）。

Q. 緯度経度の精度はどれくらい必要ですか？

10進度で小数点以下 5〜6 桁あれば物件単位の精度（誤差約 1〜10cm）になります。 RESUTOOL 内に既に保持されている地番ベースの座標で十分です。

Q. ベース地図のデフォルトを変更できますか？

はい。?base=pale（淡色）または ?base=std（標準）等を指定してください。 デフォルトは mono（白地図）で、これはオーバーレイレイヤの視認性を最大化するためです。

Q. 料金は発生しますか？

RESUTOOL からの本URL呼び出し自体に追加料金は発生しません（出典：MLIT 不動産情報ライブラリ API＋国土地理院タイル＝全て無料）。 当社（hatakan-dx.com）のホスティング（Cloudflare Pages）も無料枠で運用されています。

7. お問い合わせ

実装にあたりご不明な点は下記までご連絡ください。