← Инструкции по встраиванию
Руководство по интеграции

Как встроить 3D-карту недвижимости Georivo в Webflow

Добавьте iframe Georivo с помощью элемента Code Embed в Webflow, сохраните соотношение сторон, опубликуйте авторизованный домен и проверьте работу виджета.

Как встроить 3D-карту недвижимости Georivo в Webflow

Чтобы встроить интерактивную историю локации Georivo в Webflow, сначала опубликуйте виджет и авторизуйте точный публичный домен вашего сайта в личном кабинете Georivo. Скопируйте сгенерированный код iframe HTTPS, добавьте его через поддерживаемый платформой элемент HTML или код, сохраните соотношение сторон и опубликуйте страницу. Проверьте работу виджета по активному публичному URL-адресу на компьютерах и мобильных устройствах, включая доступность домена, скорость загрузки, указание авторства, обработку согласия пользователей и резервные сценарии.

Панель встраивания пользовательского кода Webflow, показывающая код iframe Georivo
Вставьте защищенный код iframe Georivo непосредственно в элемент Code Embed в Webflow.

Предварительные требования для интеграции с Webflow

Интеграция интерактивной 3D-истории локации на сайт Webflow требует тщательной подготовки на обеих платформах. Перед попыткой встроить код убедитесь, что вы выполнили все технические и административные требования. Во-первых, у вас должен быть полностью настроенный и опубликованный виджет Georivo. Этот виджет представляет собой презентацию объекта недвижимости, историю района или гид по прибытию с настроенными движениями камеры и отмеченными локациями. Несохраненные черновики или неопубликованные конфигурации не будут корректно отображаться на рабочем сайте.

Во-вторых, вам необходим доступ с правами редактора к целевому проекту Webflow. Интеграция основана на возможностях добавления пользовательского кода Webflow, которые ограничены в зависимости от структуры вашего тарифного плана. В частности, вам нужен тарифный план Webflow, позволяющий встраивать iframe или пользовательский HTML-код. Если ваш сайт находится на бесплатном стартовом тарифе без активного тарифного плана сайта или обновления рабочей области, этот элемент будет недоступен. Наконец, вам нужно определить точное публичное доменное имя, на котором будет размещен ваш сайт. Georivo использует привязку встроенного кода к домену в качестве ключевой функции безопасности для защиты лицензионных геопространственных изображений от несанкционированного копирования и использования на сторонних ресурсах.

Копирование кода встраивания Georivo

После того как ваша 3D-история локации будет готова и опубликована в панели управления Georivo, вы сможете получить защищенный код для встраивания. Перейдите в настройки совместного доступа или распространения вашего виджета. Здесь вы найдете конфигурацию авторизации домена. Вам необходимо ввести точный публичный домен вашего сайта Webflow, включая любые тестовые поддомены, которые вы планируете использовать для проверки перед полноценным запуском. Этот шаг авторизации является обязательным требованием; система безопасности виджета заблокирует отображение на любом домене, который не указан в списке.

После сохранения авторизованных доменов скопируйте сгенерированный фрагмент кода iframe HTTPS. В соответствии со строгими правилами встраивания, вы должны использовать только точный код iframe, скопированный из панели управления опубликованного виджета Georivo. Никогда не пытайтесь извлечь, изменить или вручную воссоздать защищенный URL-адрес или уникальные токены безопасности, встроенные в исходную строку. Изменение этих параметров нарушит проверку безопасности, что приведет к ошибке загрузки или ошибкам доступа при попытке iframe подключиться к серверам визуализации.

Поле ввода для авторизации домена в панели управления Georivo
Авторизуйте точный пользовательский домен Webflow в панели управления Georivo для безопасного отображения карты.

Добавление элемента Code Embed в Webflow

Скопировав защищенный код iframe HTTPS в буфер обмена, откройте Webflow Designer и перейдите на страницу и в раздел, где должна появиться интерактивная 3D-карта. В интерфейсе Webflow найдите панель выбора элементов. Прокрутите список доступных компонентов до элемента Code Embed, который обычно находится в группе продвинутых или пользовательских компонентов. Перетащите этот элемент и поместите его в нужный контейнер макета, секцию или блок div.

После размещения элемента Webflow откроет интерфейс редактора пользовательского кода. Вставьте скопированный код iframe Georivo прямо в окно редактора. Убедитесь, что при вставке не возникло лишних пробелов, символов или поврежденных тегов. После вставки сохраните изменения и закройте редактор. Обратите внимание, что из-за ограничений Webflow на выполнение пользовательского кода внутри конструктора в целях безопасности и стабильности, вы увидите заглушку вместо интерактивной 3D-карты. Настоящая визуализация будет доступна только на опубликованных тестовых или рабочих доменах.

Правила адаптивного изменения размера и соотношения сторон

Чтобы ваша 3D-история локации отлично выглядела на экранах любых размеров, необходимо настроить четкие правила адаптивных стилей в Webflow. Сам iframe разработан так, чтобы заполнять весь родительский контейнер, а значит, его ширина и высота в коде должны быть установлены на 100%. Этот подход передает управление размерами, масштабированием и адаптивными границами стандартной панели стилей Webflow, позволяя вам визуально настраивать макет.

Создайте отдельный родительский блок div в Webflow для размещения элемента Code Embed. Установите позиционирование этого родительского блока как relative. Чтобы сохранить правильное соотношение сторон, вы можете использовать метод отступа снизу в процентах (padding-bottom) или задать фиксированную высоту. На мобильных контрольных точках важно убедиться, что родительский контейнер сохраняет минимальную высоту, например 400 пикселей, чтобы 3D-карта не сжималась и не обрезалась. Достаточная высота также позволит мобильным пользователям удобно взаимодействовать с сенсорным управлением карты, избегая случайной прокрутки основной страницы.

Панель стилей Webflow, отображающая относительное позиционирование и настройки высоты для родительского контейнера
Настройте родительский контейнер с относительным позиционированием для сохранения адаптивного соотношения сторон на экранах мобильных устройств.

Публикация домена и шаги по проверке

После настройки макета и сохранения пользовательского кода следующим шагом будет публикация вашего проекта Webflow для активации интеграции. Нажмите на кнопку публикации в интерфейсе Webflow и выберите авторизованные домены, включая тестовый поддомен и ваш основной рабочий домен. Запустите процесс публикации и дождитесь подтверждения от Webflow о том, что изменения вступили в силу.

После публикации перейдите по активному публичному URL-адресу в браузере для проверки интеграции. Вам необходимо протестировать страницу как на компьютерах, так и на мобильных устройствах. На этом этапе проверки убедитесь в успешном доступе к домену и оцените скорость загрузки. Подтвердите, что обязательное указание авторства Google Maps Platform отображается и расположено корректно, соответствуя правилам использования изображений. Кроме того, проверьте работу окна согласия и то, как виджет обрабатывает резервные сценарии, если пользователь ограничил выполнение определенных скриптов или если интернет-соединение медленное.

Отличие 3D-визуализации от съёмки с дрона

Важное правило для специалистов по недвижимости, застройщиков и маркетологов, использующих Georivo, заключается в четком разграничении компьютерной 3D-визуализации и реальной съемки с дрона. Georivo создает интерактивные фотореалистичные 3D-истории локаций, обрабатывая адреса объектов и близлежащие места с помощью лицензионных геопространственных снимков. Платформа не размещает и не отображает необработанное видео с дронов или статические видеофайлы.

При демонстрации этих интерактивных карт потенциальным покупателям или клиентам в описании объектов и маркетинговых материалах необходимо четко указывать, что это 3D-визуализация, а не реальная видеосъемка с дрона. Такая прозрачность обеспечивает полное соответствие отраслевым стандартам рекламы и предотвращает неверное представление о текущем состоянии объекта недвижимости. Это также помогает управлять ожиданиями клиентов, подчеркивая, что инструмент представляет собой интерактивный пространственный гид для изучения района, а не физическую запись в реальном времени.

Устранение распространенных ошибок встраивания

Если встроенная 3D-карта отображается некорректно, можно диагностировать и решить несколько типичных проблем. Пустой iframe или ошибка блокировки домена обычно указывают на несоответствие между URL-адресом работающего сайта и списком авторизованных доменов в панели управления Georivo. Убедитесь, что точный домен, включая любые тестовые поддомены или префиксы, правильно введен в настройках Georivo. Даже незначительная опечатка приведет к блокировке безопасности.

Среди других частых проблем можно назвать неправильное отображение высоты и обрезку на мобильных устройствах. Если iframe сжимается до нулевой высоты, убедитесь, что ваш родительский контейнер в Webflow имеет фиксированную высоту или относительное позиционирование с заданными размерами. Кроме того, проверьте, что политика безопасности контента (CSP) или блокировки смешанного содержимого со стороны вашего хостинг-провайдера не мешают защищенному HTTPS-соединению, необходимому для работы Georivo. Наконец, убедитесь, что устаревший кэш браузера или инструменты управления согласием не блокируют запуск скриптов интерактивной карты.

Лучшие практики производительности и оптимизации

Чтобы поддерживать оптимальную производительность сайта и высокую скорость загрузки страниц в Webflow, вам следует следовать лучшим практикам встраивания сторонних интерактивных медиафайлов. Поскольку фотореалистичные 3D-карты Georivo обрабатывают геопространственные изображения высокого разрешения, их мгновенная загрузка при открытии страницы может повлиять на показатели Core Web Vitals и общую скорость. Попробуйте разместить контейнер с картой ниже на странице, чтобы он не входил в критическую область первого экрана.

Кроме того, вы можете использовать встроенную оптимизацию браузера, добавив атрибут ленивой загрузки (lazy loading) для элемента iframe. Это заставит браузер отложить загрузку интерактивных 3D-ресурсов до тех пор, пока посетитель не прокрутит страницу ближе к контейнеру с картой, что сбережет пропускную способность сети и ресурсы процессора для основного контента Webflow. Такой подход гарантирует, что ваш сайт останется быстрым и отзывчивым, при этом предоставляя детализированную интерактивную историю локации, когда пользователь будет готов изучить окружение объекта.

Ограничения и применимость

Используйте этот материал для презентационных целей и поддержки принятия решений, а не в качестве замены независимо проверенных первоисточников. Перед публикацией или использованием подтвердите маршруты, расстояния, доступность, наличие свободных объектов, изображения, юридические границы, требования платформы и текущие условия в соответствующих авторитетных источниках.

Метод интеграцииЛучше всего подходит дляУровень кастомизацииНеобходимый тариф Webflow
Элемент Code EmbedОтдельные страницы объектов и уникальные целевые страницыВысокий (полный контроль CSS)Core, Growth или любой тарифный план сайта
Код в элементе Rich TextДинамические записи в блоге и элементы CMS с несколькими объектамиСредний (наследует стили родителя)Тариф CMS или Enterprise
Код для всего сайтаГлобальные карты, отображаемые в шапке каждой страницыНизкий (применяется глобально)Любой платный тариф
Встраивание HTML в шаблон CMSАвтоматизированные каталоги объявлений с динамическими URLВысокий (динамическая привязка полей)Тариф CMS или Enterprise

Пошаговый процесс встраивания в Webflow

  1. Настройте и опубликуйте интерактивную 3D-историю локации в панели управления Georivo.
  2. Добавьте точные тестовые и рабочие домены Webflow в список авторизованных доменов в Georivo.
  3. Скопируйте защищенный код встраивания iframe HTTPS, сгенерированный платформой Georivo.
  4. Откройте Webflow Designer, перейдите на нужную страницу и перетащите элемент Code Embed в макет.
  5. Вставьте скопированный код iframe в редактор пользовательского кода и сохраните элемент.
  6. Задайте стили родительского контейнера: относительное позиционирование (relative) с фиксированной высотой или соотношением сторон.
  7. Опубликуйте проект Webflow на авторизованных тестовых или рабочих доменах.
  8. Протестируйте активный URL-адрес на различных устройствах, чтобы проверить работу интерактивного управления и отображение геопространственных изображений.
Интерактивная 3D-визуализация предлагает масштабируемую и соответствующую правилам альтернативу реальной съемке с дронов, позволяя профессионалам в сфере недвижимости демонстрировать окружение объекта без задержек из-за погоды или ограничений воздушного пространства.

Материалы по теме

Частые вопросы

Почему на моей встроенной карте отображается ошибка авторизации домена?

Эта ошибка возникает, когда URL-адрес работающего сайта не совпадает со списком авторизованных доменов в настройках Georivo. Убедитесь, что вы добавили как тестовый поддомен webflow.io, так и ваш собственный рабочий домен в список разрешенных.

Могу ли я использовать встраивание Georivo на бесплатном стартовом тарифе Webflow?

Webflow ограничивает использование элемента Code Embed на бесплатных стартовых тарифах без активного плана подписки для сайта. Чтобы встраивать пользовательский HTML или iframe, вам необходимо обновить рабочую область Webflow или приобрести платный тарифный план для сайта.

Как сделать 3D-карту адаптивной на мобильных устройствах?

Установите ширину и высоту iframe на 100 процентов, а затем используйте родительский блок div в Webflow для управления размерами. Убедитесь, что родительский блок div имеет минимальную высоту 400 пикселей на мобильных контрольных точках для удобного сенсорного взаимодействия.

Обновляются ли встроенные 3D-изображения в режиме реального времени?

3D-изображения состоят из высококачественных лицензионных геопространственных данных. Хотя они обеспечивают точное и фотореалистичное представление о районе, это не прямая трансляция видео в реальном времени, и их следует отличать от реальной съемки с дрона.

Могу ли я встраивать разные карты на разные страницы коллекций Webflow CMS?

Да, вы можете добавить элемент Code Embed в шаблоны коллекций Webflow CMS. Убедитесь, что для каждого элемента используется соответствующий авторизованный код iframe Georivo, скопированный из панели управления опубликованного виджета.

Влияет ли встраивание на SEO-показатели моего сайта Webflow?

Поскольку код Georivo встраивается через iframe, он загружается отдельно от основного содержимого страницы Webflow. Использование атрибутов отложенной загрузки (lazy loading) для iframe помогает отложить загрузку ресурсов, сохраняя оптимизированными начальную скорость страницы и показатели Core Web Vitals.