Hiển thị điểm đánh giá khả năng sinh sống trực tiếp cho bất kỳ địa chỉ nào ngay trên trang của bạn — miễn phí, tương thích mọi thiết bị, và không cần bước build nào. Lý tưởng cho danh sách bất động sản, hướng dẫn khu phố, công cụ chuyển nhà và trang thông tin thành phố. Khách truy cập nhấn vào điểm số sẽ được dẫn đến báo cáo đầy đủ của BuildingsScore.
Thêm một thẻ giữ chỗ vào nơi bạn muốn hiển thị điểm số, rồi tải script một lần duy nhất trên mỗi trang. Đặt tọa độ của địa điểm bạn muốn đánh giá:
<div data-buildingsscore data-lat="48.8584" data-lng="2.2945"></div> <script async src="https://buildingsscore.com/embed.js"></script>
Chỉ vậy thôi. Script sẽ thay thế thẻ giữ chỗ bằng một thẻ điểm số và tự động điều chỉnh kích thước cho phù hợp.
Đây chính xác là widget mà đoạn mã trên tạo ra:
Hai kiểu dáng thông qua data-layout — vertical
(mặc định như hình trên, lý tưởng cho thanh bên và thẻ) và
horizontal, một banner rộng phù hợp với phần đầu của một trang listing
hoặc một hàng toàn chiều rộng:
<div data-buildingsscore data-layout="horizontal"
data-lat="48.8584" data-lng="2.2945"></div>
Cấu hình widget bằng các thuộc tính data-* trên thẻ giữ chỗ:
| Thuộc tính | Mô tả |
|---|---|
data-lat / data-lng | Tọa độ của địa điểm cần đánh giá. Lựa chọn đáng tin cậy, không cần tra cứu — hãy dùng khi bạn có sẵn. |
data-address | Địa chỉ đường phố để đánh giá (sẽ được geocode nếu bạn không cung cấp lat/lng) và/hoặc nhãn hiển thị trên thẻ. |
data-layout | vertical (mặc định, thẻ dọc cao) hoặc horizontal (banner ngang rộng — điểm số bên cạnh lưới hai cột gọn gàng). |
data-theme | auto (mặc định, theo cài đặt hệ điều hành của khách truy cập), light hoặc dark. |
data-ref | Thẻ trang web/chiến dịch của bạn để theo dõi nguồn. Mặc định là tên miền của bạn. |
data-height | Chiều cao ban đầu tính bằng px trước khi thẻ tự đo kích thước (mặc định 440). |
data-cta | Đặt thành 0 để ẩn nút "Xem báo cáo đầy đủ". |
Bạn đang hiển thị danh sách động (cuộn vô tận, SPA, kết quả AJAX)? Sau khi chèn các thẻ giữ chỗ mới, hãy gọi:
BuildingsScore.render();
Bỏ qua script và nhúng widget trực tiếp:
<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>
Với script, thẻ tự động điều chỉnh kích thước theo nội dung; với iframe thuần túy, bạn phải tự đặt chiều cao cố định.
Điểm số, nút bấm và từng danh mục đều mở báo cáo BuildingsScore đầy đủ, tương tác cho địa điểm đó trong một tab mới — trang của bạn vẫn giữ khách trong khi họ xem chi tiết sâu hơn. Chúng tôi không bao giờ đặt cookie bên thứ ba trong widget, và điểm số được tính toán trên máy chủ của chúng tôi, nên trang của bạn vẫn tải nhanh.