Вбудовування карти на ваш вебсайт

Вбудована карта поміщає проєкт на сторінку вашого вебсайту: його фігури, їхні виміри та, якщо в проєкті є ціни, його кошторис. Відвідувачі дивляться на нього просто там, без облікового запису, і можуть відкрити його в Measure Map Online, якщо їм потрібно більше місця.

Які проєкти можна вбудовувати#

Ваші вбудовані карти можуть показувати ваші власні проєкти та проєкти інших облікових записів, наприклад ваших клієнтів, відповідно до їхнього рівня доступу:

• Проєкти з рівнем visibilityТільки перегляд і publicПублічний показуються на вашій сторінці, хто б не був їхнім власником. Відвідувачі можуть дивитися, але нічого не змінювати: редагування у вбудованій карті вимкнено, навіть для учасників проєкту.
• lockПриватний проєкти іншого облікового запису показуються, лише коли їхній власник дозволив вам це. Тоді вони показуються лише для перегляду, у ваших вбудованих картах і більше ніде. Див. приватні проєкти клієнтів.
• Ваші власні lockПриватний проєкти не показуються ніколи, навіть із вашим ключем. Спершу установіть для них visibilityТільки перегляд.
• Проєкти person_pin_circleOpen Guest дають відвідувачам змогу вимірювати самостійно й запитувати кошторис. Див. Open Guest.

Проєкт показується, лише поки діє тариф його власника або, для проєктів організації, тариф організації. Проєкти в кошику й шаблони не показуються. Коли проєкт не можна показати, карта повідомляє причину: див. коли карта показує повідомлення.

Отримання коду для вбудовування#

1. На панелі керування натисніть codeРозробник, а потім web_assetВбудувати карту. Вбудовування завжди використовує ваш робочий ключ: проєкти, створені з ключем пісочниці, відвідувачі вашого сайту відкрити не можуть (див. робоче середовище та пісочниця).
2. У розділі Отримайте свій ключ API, якщо на сторінці ще немає ключа, натисніть addСтворити новий ключ і створіть його у вікні, що відкриється. Див. створення ключа.
3. У розділі Вкажіть ID проєкту введіть частину назви проєкту в Виберіть проєкт і виберіть його зі списку. Список показує, як надано доступ до кожного проєкту, і не містить шаблонів та проєктів у кошику. Якщо вибрати Приватний проєкт, сторінка попередить, що ваші відвідувачі побачать повідомлення про його приватність, і запропонує visibilityЗробити лише для перегляду.
4. У розділі Код для вбудовування виберіть вигляд карти:
   • Тема: Авто відповідає світлому чи темному налаштуванню кожного відвідувача; або завжди Світла чи Темна.
   • Одиниці: Авто (країна відвідувача) показує англійські одиниці відвідувачам зі Сполучених Штатів, а метричні — усім іншим; або завжди Імперські чи Метричні.
   • Тип карти: Супутник, Карта, Гібрид або Рельєф.
   • Ширина і Висота карти на вашій сторінці, у пікселях (від 200 до 2000).
5. Перевірте Попередній перегляд наживо.
6. Натисніть content_copy поруч із Код для вбудовування і вставте код у HTML вашої сторінки туди, де має з'явитися карта.

Щоб вбудувати чужий проєкт, наприклад проєкт клієнта, потрібен його ID проєкту. Його власник знаходить його наприкінці огляду проєкту, з кнопкою content_copy Копіювати; у вбудованій карті клацання по назві проєкту копіює його. Вставте його в pid адреси для вбудовування.

Код містить ваш ключ API, тому карта працює, доки ви не замінете ключ, на сайтах, які дозволяє ключ. Після заміни старий ключ ще приймається 24 години, тож вставте новий код на свої сторінки протягом цього часу. Ключ, створений до появи параметрів доступу для ключів, зберігає натомість дату, яку вам було надано. Короткочасний токен використовує лише Попередній перегляд наживо на цій сторінці.

Щоб узагалі не тримати ключ на своїх сторінках, нехай сервер вашого вебсайту щоразу запитує токен під час показу сторінки. Див. ключ чи токен, де також перелічено всі параметри, які приймає адреса для вбудовування.

Обмеження карти вашими вебсайтами#

Типово вбудована карта працює на будь-якому вебсайті. Щоб інші сайти не могли показувати ваші карти, натисніть codeРозробник > vpn_keyКлючі API і додайте свої вебсайти, наприклад example.com, у розділі Обмеження за вебсайтами. Вебсайт зі списку охоплює й свої піддомени. Щойно в списку є принаймні один вебсайт, карта, вбудована будь-де ще, не відкривається. Див. обмеження ключа вашими вебсайтами.

Що можуть робити відвідувачі#

У вбудованій карті відвідувачі можуть:

• переміщуватися й масштабувати, а також клацати фігуру, щоб прочитати її виміри;
• бачити кошторис проєкту, якщо він є;
• читати коментарі проєкту й додавати власні, якщо проєкт дозволяє коментувати всім;
• натискати settings, щоб змінити тип карти й одиниці вимірювання (див. налаштування);
• клацати назву проєкту, щоб скопіювати його ID проєкту;
• натискати кнопку Measure Map Online у правому нижньому куті, щоб відкрити проєкт у новій вкладці.

У проєкті Open Guest вони також можуть малювати й вимірювати та натискати Запросити кошторис, щоб надіслати вам свої дані.

У будь-якій іншій вбудованій карті редагування вимкнено, навіть для учасників проєкту. Щоб створити вбудовування зі свого коду або вставити в нього короткочасний токен замість ключа, див. iFrame API.

Коли карта показує повідомлення#

Коли проєкт не можна показати, карта замість нього повідомляє причину та що можна зробити.

Технічні подробиці кожного випадку див. у розділі коли карта не з'являється.