Кез келген мекенжай үшін тікелей тұрғылықтылық ұпайын өз беттеріңізде көрсетіңіз — тегін, адаптивті және ешқандай жинау қадамынсыз. Жылжымайтын мүлік хабарландырулары, аудан нұсқаулықтары, көшу құралдары және қалалық беттер үшін өте ыңғайлы. Ұпайды басқан келушілер BuildingsScore-тің толық есебіне өтеді.
Ұпайды көрсеткіңіз келген жерге орын белгілегішті қосыңыз, содан кейін сценарийді бетке бір рет жүктеңіз. Бағалағыңыз келген орынның координаттарын орнатыңыз:
<div data-buildingsscore data-lat="48.8584" data-lng="2.2945"></div> <script async src="https://buildingsscore.com/embed.js"></script>
Бәрі осы. Сценарий орын белгілегішті ұпай картасымен ауыстырып, оның өлшемін автоматты түрде реттейді.
Жоғарыдағы фрагмент дәл осы виджетті жасайды:
data-layout арқылы екі пішін — vertical
(жоғарыда көрсетілген әдепкі, бүйірлік тақталар мен карталар үшін өте қолайлы) және
horizontal, хабарландырудың жоғарғы жағына немесе толық
еніндегі жолға сыятын кең баннер:
<div data-buildingsscore data-layout="horizontal"
data-lat="48.8584" data-lng="2.2945"></div>
Орын белгілегіштегі data-* атрибуттары арқылы виджетті баптаңыз:
| Атрибут | Сипаттама |
|---|---|
data-lat / data-lng | Бағалайтын орынның координаттары. Іздеусіз сенімді нұсқа — болса, осыны пайдаланыңыз. |
data-address | Бағалайтын көше мекенжайы (lat/lng берілмесе геокодталады) және/немесе картада көрсетілетін белгі. |
data-layout | vertical (әдепкі, биік карта) немесе horizontal (кең баннер — ұпай жинақы екі бағанды тор жанында). |
data-theme | auto (әдепкі, келушінің операциялық жүйесіне сәйкес), light немесе dark. |
data-ref | Атрибуция үшін сайт/науқан белгісі. Әдепкі мәні — доменіңіз. |
data-height | Карта өзін өлшемейінше бастапқы биіктік px-пен (әдепкі 440). |
data-cta | "Толық есепті көру" түймесін жасыру үшін 0 мәніне орнатыңыз. |
Хабарландыруларды динамикалық түрде шығарасыз ба (шексіз айналдыру, SPA, AJAX нәтижелері)? Жаңа орын белгілегіштерді кірістіргеннен кейін мынаны шақырыңыз:
BuildingsScore.render();
Сценарийді өткізіп жіберіп, виджетті тікелей енгізіңіз:
<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 есебін ашады — сонда келушіңіз терең мазмұнды оқып жатса да бетіңізде қала береді. Виджетте ешқашан үшінші тарап Cookie-лерін орнатпаймыз, ал ұпай біздің серверлерде есептеледі, сондықтан бетіңіз жылдам болып қала береді.