Расширенный контент, фото 360

Последнее обновление: 5 ноября 2020 г.

Содержание

Расширенный контент "richcontent" - getmime

Автоматическое определение ракурса изображения

Поддерживаемые параметры: commercialRef, pageSize, page

Расширенный контент "richcontent" - getmime

Метод позволяет получать расширенный контент по продукции и содержит следующую информацию:

  • Названия референсов
  • Ссылку на плеер фото 360
  • Ссылки на фотографии 360
  • Фото в интерьере
  • Инфографику
  • Статьи
  • Видео
  • Коммерческое название
  • Коммерческое описание

Изначально метод выдает данные без ссылок на изображения. Вместо этого передается ссылка на уже готовый плеер 360, где происходит воспроизведение контента.

Пример запроса:
https://web.se-ecatalog.ru/new-api/XML/getmime?accessCode={YourApiToken}

Пример ответа:

<reference>
<commercialRef>GSL000151</commercialRef>
<photo360>
<url>https://web.se-ecatalog.ru/player/embed/GSL000151</url>
</photo360>
<enviromental_img>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/photo_interior/50584/n6lba1kX4xMPdID.jpg
</url>
<size>1264824</size>
<type>jpg</type>
</image>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/photo_interior/50584/FrlmgsjT4Vj6wQR.jpg
</url>
<size>15506704</size>
<type>jpg</type>
</image>
<image>
<url>
https://static-pcsp.se-ecatalog.ru/photo_interior/50584/9rFHINl7e2hOPVq.jpg
</url>
<size>9899172</size>
<type>jpg</type>
</image>
</enviromental_img>
<infographic/>
<articles/>
<videos/>
<eComProductTitles/>
<eComeProductDescriptions>
Механизм Schneider Electric Glossa (цвет белый) выключателя 2-клавишного подходит для сетей 250 В, на ток 10 А. - Двухклавишный выключатель позволяет управлять двумя источниками света с одной точки. - Выполнен из материала PС+ASA, стойкого к УФ-излучению и появлению царапин. - Эргономичные клеммы расположены в два ряда: сверху и снизу.
</eComeProductDescriptions>
<typical_BOM/>
</reference>


photo360 - ссылка на плеер с фото 360. Плеер доступен по протоколу https, поэтому на сайтах с httpss могут возникнуть ошибки в браузере (проблемы с безопасностью). В среднем общий вес фото составляет 1.5Мб, размер кадра 1000 пикселей по максимальной стороне.

enviromental_img - ссылки на изображения в интерьере, расширение jpg.

infographic - ссылки на элементы инфографики jpg, png, pdf

articles - ссылки на статьи в pdf формате

videos - ссылки на видеоролики в youtube

eComProductTitles - коммерческое название референса

eComeProductDescriptions - коммерческое описание референса, приходит в неформатированном виде. Для корректного оторбажения требуется дополнительная разметка на стороне партнера.

Для получения списка всех фотографий 360, которые используются в плеере, в запрос необходимо добавлять параметр &images=1. В ответе дополнительно к основному списку контента будут добавлены и фотографии в теге images.

Пример запроса:
https://web.se-ecatalog.ru/new-api/XML/getmime?accessCode={YourApiToken}&images=1

Пример ответа:

<reference>
<commercialRef>GSL000151</commercialRef>
<photo360>
<url>https://web.se-ecatalog.ru/player/embed/GSL000151</url>
<images>
<image>
<num>1_1</num>
<url>
https://static-pcsp.se-ecatalog.ru/player_360/50584/001.jpg
</url>
<size>64219</size>
<type>jpg</type>
</image>
<image>
<num>2_1</num>
<url>
https://static-pcsp.se-ecatalog.ru/player_360/50584/002.jpg
</url>
<size>63786</size>
<type>jpg</type>
</image>
...


У референсов количество фотографий 360 в выдаче может быть разным, например 36 или 60 штук. Это является особенностью съемки.

Размер изображений указан в Байтах.

Автоматическое определение ракурса изображения

Дополнительно у фотографий указывается тег num, который передает порядковый номер изображения в выдаче для правильного восстановления хронологии воспроизведения. Этот номер состоит из двух частей, например 2_1. Первое значение является порядковым номером, а второе - принадлежность в ракурсу. И чем дальше вторая цифра от начала нумерации указанного ракурса, тем изображение будет более повернуто к другой стороне. Так, 2_1 будет ближе к ракурсу "вид фронта с левого бока", чем изображение под номером 2_9.

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

Всего определяется 3 ракурса:

  • {номер изображения}_1 - вид фронта с левого бока
  • {номер изображения}_2 - вид фронта с правого бока
  • {номер изображения}_3 - вид сзади

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

Продолжая просмотр сайта www.web.se-ecatalog.ru я соглашаюсь с использованием файлов cookie владельцем сайта в соответствии с «Политикой в отношении файлов cookie», в том числе на передачу данных, указанных в Политике, третьим лицам - статистическим службам сети Интернет.