將 BuildingsScore 嵌入你嘅網站

喺你自己嘅頁面顯示任何地址嘅實時宜居評分 — 免費、響應式，完全唔需要構建步驟。非常適合用於樓盤列表、社區指南、搬遷工具同城市資訊頁面。訪客點擊評分後會跳轉到完整嘅 BuildingsScore 報告。

兩行 HTML

喺你想顯示評分嘅地方加一個佔位符，然後每頁載入一次腳本。設定你想評分地點嘅座標：

<div data-buildingsscore data-lat="48.8584" data-lng="2.2945"></div>
<script async src="https://buildingsscore.com/embed.js"></script>

就係咁簡單。腳本會將佔位符替換成評分卡，並自動調整大小以適應內容。

即時預覽

以下就係上面代碼所生成嘅 widget：

版面樣式

透過 data-layout 提供兩種樣式 — vertical （預設，如上圖所示，適合側欄同卡片）同 horizontal，一個寬橫幅，適合放喺列表頂部或全寬橫排：

<div data-buildingsscore data-layout="horizontal"
     data-lat="48.8584" data-lng="2.2945"></div>

選項

透過佔位符上嘅 data-* 屬性配置 widget：

屬性	說明
`data-lat` / `data-lng`	要評分地點嘅座標。最可靠嘅選項，唔需要額外查詢 — 有的話就用佢。
`data-address`	要評分嘅街道地址（如果冇提供 lat/lng 會進行地理編碼），以及/或者顯示喺卡片上嘅標籤。
`data-layout`	`vertical`（預設，高卡片）或 `horizontal`（寬橫幅 — 評分旁邊係緊湊嘅雙欄維度網格）。
`data-theme`	`auto`（預設，跟隨訪客嘅作業系統設定）、`light` 或 `dark`。
`data-ref`	你網站／推廣活動嘅標籤，用於歸因追蹤。預設係你嘅域名。
`data-height`	卡片自我測量前嘅初始高度（像素），預設係 `440`。
`data-cta`	設為 `0` 可隱藏「查看完整報告」按鈕。

頁面載入後添加 widget

你係動態渲染列表（無限滾動、SPA、AJAX 結果）？插入新佔位符之後，呼叫：

BuildingsScore.render();

想用普通 iframe？

跳過腳本，直接嵌入 widget：

<iframe
  src="https://buildingsscore.com/embed.html?lat=48.8584&lng=2.2945"
  style="width:100%;height:440px;border:0"
  loading="lazy" title="BuildingsScore"></iframe>

使用腳本時卡片會自動調整大小適應內容；使用純 iframe 時你需要自行設定固定高度。

點擊係點樣運作

評分、按鈕同每個類別都會喺新分頁中打開該地點完整嘅互動式 BuildingsScore 報告 — 咁你嘅頁面就能夠留住訪客，同時讓佢哋獲得更深入嘅資訊。我哋絕對唔會喺 widget 中設置第三方 Cookie，而且評分係喺我哋嘅伺服器上計算，所以你嘅頁面依然保持快速。