Описание формата XML-файла для автоматического импорта объектов

1. Пример файла

Примеры файлов для импорта приведены в конце страницы:

Также примеры XML-файлов доступны по адресам:

 

2. Общее описание

Файл импорта объектов должен представлять собой валидный XML документ в кодировке UTF-8. Файл должны быть доступен непосредственно по указанному URL без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.).

Внимание: на загрузку файла установлен таймаут 30 секунд, обращение к файлу и его загрузка должны укладываться в это время.

Корневой XML тег – objects

В файле заполняются элементы, которые представляют собой различные объекты. Объектами могут являться как объекты недвижимости, так и специальные объекты позволяющие заполнять структуру жилых комплексов (ЖК).

ЖК – это специальный объект, который физически представляет собой либо набор из нескольких зданий, объединённых по некоторому признаку (например, территориальному) либо одно здание с большим количеством объектов внутри себя. Для заполнения ЖК предусмотрена отдельная структура, включающая в себя:

  • Очередь завершения строительства – специальный тип объекта для структуры ЖК, который логически выделяет, объединяет группу блоков ЖК объединённых единой датой завершения (сдачи) строительства;
  • Блок ЖК – специальный тип объекта для структуры ЖК, который определяет отдельное здание в рамках ЖК;
  • Этаж – специальный тип объекта для структуры ЖК, который определяет конкретный этаж в конкретном блоке ЖК;
  • Планировка – специальный тип объекта для структуры ЖК, который определяет логическую группу, объединяющую набор квартир по некоторым одинаковым параметрам;
  • Квартира в ЖК – объект недвижимости находящийся в ЖК, причём, тип объекта может быть различный из представленных на портале (например, пентхаус), это не обязательно квартира;

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

  • Объект, ЖК, квартира в ЖК – object;
  • Очередь завершения строительства – queue;
  • Блок ЖК – section;
  • Этаж – floor;
  • Планировка – layout;

 

3. Описание полей

Ниже приведен набор поддерживаемых тегов для указания информации об объекте и их описание.

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

Внимание:

  • Значения тегов не должны содержать HTML-тегов или иного кода.
  • При заполнении в мультиязычном формате, значение на каждом языке должно соответствовать указанному языку. В случае заполнения на несоответствующем языке, значение поля публиковаться не будет.
  • Различные языковые версии одного и того же объекта должны оформляться как один объект с помощью мультиязычного формата. Оформление каждой языковой версии отдельным объектом приведет к дублированию объектов на emirates.estate.
  • Для удаления ранее размещенного с помощью XML-файла объекта, необходимо данный объект удалить из XML-файла.

 

3.1. Набор полей для объектов, использующих тег «object»

Тег «object» используется для 3-х типов объектов, которые были описаны ранее. Они имеют схожий набор полей и имеют незначительные отличия друг от друга.

Тип объектов определяется по вспомогательным значениям полей, которые указываются для них (в скобках для каждого типа объектов указаны их ключевые обозначения в таблице ниже):

  • ЖК (ЖК) – в качестве типа объекта указан «Жилой комплекс», подробнее см. пункт 4;
  • Квартира в рамках структуры ЖК (К) – для объекта указан комплекс (development), подробнее см. таблицу полей в п.3.1.
  • Другие объекты (О) – объект, не являющийся ни ЖК, ни квартирой в рамках структуры ЖК.

Внимание:

  • В столбце «Используется» указаны ключевые обозначения объектов, для которых возможно указание тега.
ТегОписаниеОбязательныйИспользуется

id

Уникальный идентификатор объекта. Может содержать как цифры, так и буквы. Да ЖК, К, О

edited

Дата и время последнего изменения данных об объекте в формате ISO-8601 Да ЖК, К, О

trakheesi_permit

Номер лицензии Trakheesi Permit для объекта Нет ЖК, К, О

name

Наименование объекта. Должно быть обернуто в

Пример:


Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – наименование объекта на данном языке. Наименование должно быть обернуто в .

Пример:


   
   

Нет ЖК

description

Описание объекта. Должно быть обернуто в

Пример:


Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – описание объекта на данном языке. Описание должно быть обернуто в .

Пример:


   
   

Нет ЖК, К, О

excerpt

Краткое описание объекта. Должно быть обернуто в

Пример:


Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – краткое описание объекта на данном языке. Описание должно быть обернуто в .

Пример:


   
   

Нет ЖК, К, О

labels

Набор меток, характеризующих объект. Указывается в виде набора тегов label, содержащих текст метки. Текст метки должен быть обернут в

Пример:


   
   

Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – набор тегов label, содержащих метки объекта на данном языке.

Пример:


   
      
      
   
   
      
      
   

Нет ЖК, К, О

deal

Числовой идентификатор типа сделки. Значение ID из справочника, см. п. 4, справочник типов сделок. Да К, О

price

Цена объекта, число

Внимание: для аренды минимально допустимая цена – 8300 дирхам в месяц, более дешевые объекты импортированы не будут.

Внимание: для продажи минимально допустимая цена – 550000 дирхам, более дешевые объекты импортированы не будут.

Да ЖК, К, О

currency

Валюта, в которой указана цена объекта. Указывается трехбуквенный код валюты. Поддерживаемые для указания валюты приведены в справочнике, см. п. 4., справочник валют. Да ЖК, К, О

price_period

Период, для которого указана цена, в случае, когда объект представляет собой предложение аренды. Одно из двух значений:

  • monthly – в случае указания цены за месяц
  • daily – в случае указания цены за сутки
  • weekly – в случае указания цены за неделю
  • yearly – в случае указания цены за год
Да, в случае аренды К, О

installment

Возможна ли рассрочка для данного объекта. Возможные значения:

  • 1 – да
  • 0 – нет
Нет ЖК, К, О

type

Числовой идентификатор типа объекта. Значение ID из справочника, см. п. 4, справочник типов объектов.

Внимание:

  • для ЖК всегда тип «Жилой комплекс»
  • для квартир ЖК допустимы только следующие типы объектов (см. п. 4):
    • Квартира;
    • Пентхаус.
Да ЖК, К, О

region

Числовой идентификатор региона расположения объекта. Значение ID из справочника, см. п. 4, справочник регионов и районов. Секция regions.

Внимание: в качестве региона рекомендуем указывать город (тип city в справочнике)

Да ЖК, О

district

Числовой идентификатор района расположения объекта. Значение ID из справочника, см. п. 4, справочник регионов и районов. Секция districts.

Внимание: в случае указания района, значение его атрибута city из справочника должно совпадать со значением, указанным в теге region.

Нет ЖК, О

community

Числовой идентификатор комьюнити расположения объекта. Значение ID из справочника, см. п. 4, справочник регионов и районов. Секция communities.

Внимание: в случае указания комьюнити, значение его атрибута city из справочника должно совпадать со значением, указанным в теге region.

Нет ЖК, О

status

Числовой идентификатор статуса объекта. Значение ID из справочника, см. п. 4, справочник статусов. Да ЖК, К, О

square

Общая площадь объекта в квадратных метрах, число. Нет К, О

rooms

Общее количество комнат объекта, число.

Внимание:

  • Необходимо указывать общее число комнат, включая гостиные. Например, для планировки 2+1 общее количество комнат – 3 (2 спальни плюс 1 гостиная).
Нет К, О

bedrooms

Количество спален объекта, число. Нет К, О

bathrooms

Количество ванных комнат, число. Нет К, О

floor

Этаж расположения объекта, число. Нет К, О

floors

Этажность объекта, число. Для квартир указывается этажность дома, в котором расположена квартира. Для домов, вилл и т.п. указывается этажность самого объекта. Нет ЖК, О

tosea

Расстояние от объекта до моря в метрах, число. Нет ЖК, О

tocenter

Расстояние от объекта до центра города в метрах, число. Нет ЖК, О

toairport

Расстояние от объекта до ближайшего аэропорта в километрах, число. Нет ЖК, О

finish

Дата завершения строительства объекта. Указывается в виде набора тегов:

  • year – год окончания строительства в формате ГГГГ
  • quarter – квартал окончания строительства, цифра от 1 до 4

Пример:


   2021
   1

Нет ЖК, О

finished

Сдан ли объект. Возможные значения:

  • 1 – да
  • 0 – нет
Нет ЖК, О

geo

Широта и долгота объекта. Указывается в виде набора тегов:

  • lat – широта
  • lng – долгота

Пример:


   30.123456
   31.234567

Нет ЖК, О

developer

Числовой идентификатор застройщика, осуществляющего строительство объекта. Значение ID из справочника, см. п. 4, справочник застройщиков. Нет ЖК, О

images

Набор фотографий объекта. Указывается в виде набора тегов image, содержащих URL изображения.

Пример:


   http://domain.com/images/image1.jpg
   http://domain.com/images/image2.jpg
   http://domain.com/images/image3.jpg

Внимание:

  • В качестве главного изображения объекта и его превью на сайте будет использовано первое изображение в списке.
  • Поддерживаются только изображения в формате JPEG, GIF, PNG.
  • Изображения, превышающие по 5000 пикселей по ширине или 4000 пикселей по высоте, загружены не будут.
  • Максимальное количество изображений для каждого объекта 30. Если для объекта указано большее количество изображений, будут загружены только первые 30.
  • Изображения должны быть доступны непосредственно по указанному URL без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.)
Нет ЖК, К, О

agent

Сотрудник Вашего агентства, выступающий менеджером по данному объекту. Указывается в виде тега name, значением которого выступает имя сотрудника в том виде, в каком оно указано в списке сотрудников в Вашем личном кабинете. Если данный тег не указывать, то в качестве продавца объекта на сайте emirates.estate будет указано контактное лицо компании.

Пример:


   John Smith

Нет ЖК, К, О

features

Набор числовых идентификаторов особенностей объекта. Указывается в виде набора тегов feature. В качестве значений используются идентификаторы особенностей объектов, см. п. 4, справочник особенностей объектов.

Пример:


   5
   19
   71

Нет ЖК, К, О

project_id

Числовой идентификатор Жилого комплекса для объектов квартир, которые относятся к Жилым Комплексам других агенств. Значение ID из справочника, см. п. 4, справочник жилых комплексов. Секция complexes.

Внимание: этот тег необходим для агентств, которые добавляют квартиры не в свои Жилые комплексы, если в вашем файле присутствует Жилой комплекс, к которому должна быть привязана квартира, используйте тег «development»

Нет О

development

Идентификатор Жилого комплекса для объекта типа «Квартира». Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится квартира.

Внимание: если Жилой комплекс, к которому привязана квартира будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, квартира также добавлена не будет.

Нет К

scheme

Схема ЖК, подробнее см. пункт 3.6. Нет ЖК

section

Идентификатор Блока для объекта типа «Квартира». Значение ID из текущего файла импорта указанное в теге «id» для Блока, к которому относится квартира.

Внимание: если Блок, к которому привязана квартира будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, квартира также добавлена не будет.

Нет К

layout

Идентификатор Планировки для объекта типа «Квартира». Значение ID из текущего файла импорта указанное в теге «id» для Планировки, к которой относится квартира.

Внимание: если Планировка, к которой привязана квартира будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, квартира также добавлена не будет.

Нет К

image_2d

Указывается URL изображения, которое будет использоваться в качестве 2D схемы квартиры.

Внимание:

  • Если для квартиры не указано ни одной фотографии, в качестве превью в списках будет использована 2D схема.
  • Поддерживаются только изображения в формате JPEG, GIF, PNG.
  • Изображения, превышающие по 5000 пикселей по ширине или 4000 пикселей по высоте, загружены не будут.
  • Для корректного отображения 2D схем рекомендуемые пропорции 3x2 (ширина х высота). Если изображение имеет другие пропорции, к нему будут добавлены поля для получения нужных пропорций. Цвет полей аналогичен фону изображения, если определить цвет фона изображения не получилось, поля будут белого цвета.
  • Изображение должно быть доступно непосредственно по указанному URL без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.)
Нет К

image_3d

Указывается URL изображения, которое будет использоваться в качестве 3D схемы квартиры.

Внимание:

  • Если для квартиры не указано ни одной фотографии и 2D схема, в качестве превью в списках будет использована 3D схема
  • Поддерживаются только изображения в формате JPEG, GIF, PNG.
  • Изображения, превышающие по 5000 пикселей по ширине или 4000 пикселей по высоте, загружены не будут.
  • Для корректного отображения 3D схем рекомендуемые пропорции 3x2 (ширина х высота).
  • Изображение должно быть доступно непосредственно по указанному URL без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.)
Нет К

 

3.2. Набор полей для объектов, использующих тег «queue»

Тег «queue» используется для заполнения объектов типа «Очередь».

ТегОписаниеОбязательный

id

Уникальный идентификатор очереди. Может содержать как цифры, так и буквы. Да

edited

Дата и время последнего изменения данных об очереди в формате ISO-8601 Да

development

Идентификатор Жилого комплекса для очереди. Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится очередь.

Внимание: если Жилой комплекс, к которому привязана очередь будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, очередь также добавлена не будет.

Да

name

Наименование очереди. Должно быть обернуто в

Пример:


Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – наименование очереди на данном языке. Наименование должно быть обернуто в .

Пример:


   
   

Да

finish

Дата завершения очереди строительства. Указывается в виде набора тегов:

  • year – год окончания строительства в формате ГГГГ
  • quarter – квартал окончания строительства, цифра от 1 до 4

Пример:


   2021
   1

Да

 

3.3. Набор полей для объектов, использующих тег «section»

Тег «section» используется для заполнения объектов типа «Блок».

ТегОписаниеОбязательный

id

Уникальный идентификатор блока. Может содержать как цифры, так и буквы. Да

edited

Дата и время последнего изменения данных о блоке в формате ISO-8601 Да

development

Идентификатор Жилого комплекса для блока. Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится блок.

Внимание: если Жилой комплекс, к которому привязан блок будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, блок также добавлен не будет.

Да

queue

Идентификатор Очереди для блока. Значение ID из текущего файла импорта указанное в теге «id» для Очереди, к которой относится блок.

Внимание: если Очередь, к которой привязан блок будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлена, блок также добавлен не будет.

Нет

name

Наименование объекта. Должно быть обернуто в

Пример:


Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – наименование очереди на данном языке. Наименование должно быть обернуто в .

Пример:


   
   

Да

finish

Дата завершения строительства блока. Указывается в виде набора тегов:

  • year – год окончания строительства в формате ГГГГ
  • quarter – квартал окончания строительства, цифра от 1 до 4

Пример:


   2021
   1

Да

 

3.4. Набор полей для объектов, использующих тег «floor»

Тег «floor» используется для заполнения объектов типа «Этаж».

ТегОписаниеОбязательный

id

Уникальный идентификатор этажа. Может содержать как цифры, так и буквы. Да

edited

Дата и время последнего изменения данных об этаже в формате ISO-8601 Да

development

Идентификатор Жилого комплекса для этажа. Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится этаж.

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

Да

section

Идентификатор Блока для этажа. Значение ID из текущего файла импорта указанное в теге «id» для Блока, к которому относится этаж.

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

Нет

number

Номер этажа, число

Да

scheme_2d

2D схема этажа, подробнее см. пункт 3.6

Нет

scheme_3d

3D схема этажа, подробнее см. пункт 3.6

Нет

 

3.5. Набор полей для объектов, использующих тег «layout»

Тег «layout» используется для заполнения объектов типа «Планировка».

ТегОписаниеОбязательный

id

Уникальный идентификатор планировки. Может содержать как цифры, так и буквы. Да

edited

Дата и время последнего изменения данных об объекте в формате ISO-8601 Да

name

Наименование планировки. Должно быть обернуто в

Пример:


Также поддерживает мульти-язычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – название планировки на данном языке. Название должно быть обернуто в .

Пример:


   
   

Да

description

Описание планировки. Должно быть обернуто в

Пример:


Также поддерживает мульти-язычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – описание планировки на данном языке. Описание должно быть обернуто в .

Пример:


   
   

Нет

excerpt

Краткое описание планировки. Должно быть обернуто в

Пример:


Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – краткое описание планировки на данном языке. Описание должно быть обернуто в .

Пример:


   
   

Нет

labels

Набор меток, характеризующих планировку. Указывается в виде набора тегов label, содержащих текст метки. Текст метки должен быть обернут в

Пример:


   
   

Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – набор тегов label, содержащих метки объекта на данном языке.

Пример:


   
      
      
   
   
      
      
   

Нет

price

Цена планировки, число

Да

currency

Валюта, в которой указана цена объекта. Указывается трехбуквенный код валюты. Поддерживаемые для указания валюты приведены в справочнике, см. п. 4., справочник валют. Да

square

Общая площадь планировки в квадратных метрах, число. Нет

rooms

Общее количество комнат планировки, число.

Внимание:

  • Необходимо указывать общее число комнат, включая гостиные. Например, для планировки 2+1 общее количество комнат – 3 (2 спальни плюс 1 гостиная).
Нет

bedrooms

Количество спален объекта, число. Нет

bathrooms

Количество ванных комнат, число. Нет

images

Набор фотографий планировки. Указывается в виде набора тегов image, содержащих URL изображения.

Пример:


   http://domain.com/images/image1.jpg
   http://domain.com/images/image2.jpg
   http://domain.com/images/image3.jpg

Внимание:

  • В качестве главного изображения объекта и его превью на сайте будет использовано первое изображение в списке.
  • Поддерживаются только изображения в формате JPEG, GIF, PNG.
  • Изображения, превышающие по 5000 пикселей по ширине или 4000 пикселей по высоте, загружены не будут.
  • Максимальное количество изображений для каждого объекта 30. Если для объекта указано большее количество изображений, будут загружены только первые 30.
  • Изображения должны быть доступны непосредственно по указанному URL без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.)
Нет

features

Набор числовых идентификаторов особенностей планировки. Указывается в виде набора тегов feature. В качестве значений используются идентификаторы особенностей объектов, см. п. 4, справочник особенностей объектов.

Пример:


   5
   19
   71

Внимание: Если не указано ни одной особенности, то список особенностей будет получен из списка особенностей ЖК, к которому относится планировка. Если же длязаполнена хотя бы 1 особенность, то список особенностей будет выводится как есть.

Нет

development

Идентификатор Жилого комплекса. Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится планировка.

Внимание: если Жилой комплекс, к которому привязана квартира будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, квартира также добавлена не будет.

Да

section

Идентификатор Блока. Значение ID из текущего файла импорта указанное в теге «id» для Блока, к которому относится планировка.

Внимание: если Блок, к которому привязана планировка будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, планировка также добавлена не будет.

Нет

image_2d

Указывается URL изображения, которое будет использоваться в качестве 2D схемы планировки.

Внимание:

  • Если для планировки не указано ни одной фотографии, в качестве превью в списках будет использована 2D схема.
  • Поддерживаются только изображения в формате JPEG, GIF, PNG.
  • Для корректного отображения 2D схем рекомендуемые пропорции 3x2 (ширина х высота). Если изображение имеет другие пропорции, к нему будут добавлены поля для получения нужных пропорций. Цвет полей аналогичен фону изображения, если определить цвет фона изображения не получилось, поля будут белого цвета.
  • Изображение должно быть доступно непосредственно по указанному URL без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.)
Нет

image_3d

Указывается URL изображения, которое будет использоваться в качестве 3D схемы планировки.

Внимание:

  • Если для планировки не указано ни одной фотографии и 2D схема, в качестве превью в списках будет использована 3D схема
  • Поддерживаются только изображения в формате JPEG, GIF, PNG.
  • Изображения, превышающие по 5000 пикселей по ширине или 4000 пикселей по высоте, загружены не будут.
  • Для корректного отображения 3D схем рекомендуемые пропорции 3x2 (ширина х высота).
  • Изображение должно быть доступно непосредственно по указанному URL без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.)
Нет

 

3.6. Описание поля заполнения схемы

Схема – это специальное изображение для элемента ЖК (самого ЖК, блока, этажа), которое содержит размеченные активные области в виде замкнутых многоугольников, являющиеся ссылками на другие элементы структуры ЖК, а также выводящие информацию о данных элементах. Схема используется для визуальной навигации пользователей по структуре жилого комплекса.

Например, схема ЖК содержит разметку входящих в него блоков или этажей, схема блока – разметку его этажей, схема этажа – разметку квартир на этом этаже.

В качестве общего тега для схемы используется тег, описанный в списке полей для определённого типа объекта, обычно это «scheme».

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

ТегОписаниеОбязательный

image

Указывается URL изображения, которое будет использоваться в качестве изображения схемы

Внимание:

  • Поддерживаются только изображения в формате JPEG, GIF, PNG.
  • Изображения, превышающие по 5000 пикселей по ширине или 4000 пикселей по высоте, загружены не будут.
  • Для корректного отображения схем, рекомендуемые пропорции 9x4 (ширина х высота).
  • Изображение должно быть доступно непосредственно по указанному URL без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.)
Да

area

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

  • Набор тегов point – каждый тег задаёт точку в виде координат X и Y в координатной плоскости изображения (используются абсолютные координаты для каждой точки), где началом координат считается левая верхняя точка изображения (все координаты должны быть положительные). Каждый тег заполняется в виде набора тегов координат x и y:
    • x – координата на схеме по оси X;
    • y – координата на схеме по оси Y;
  • Тег infobar (не обязателен) – указывает связанный с областью элемент структуры данного ЖК (например, идентификатор блока на схеме ЖК). В теге заполняется один из дочерних тегов:
    • section_id - Идентификатор Блока. Значение ID из текущего файла импорта указанное в теге «id» для Блока, к которому относится данная область разметки;
    • floor_id – Идентификатор Этажа. Значение ID из текущего файла импорта указанное в теге «id» для Этажа, к которому относится данная область разметки;
    • apartment_id – ID из текущего файла импорта указанное в теге «id» для Квартиры, к которой относится данная область разметки

Внимание:

  • section_id доступен для использования только внутри схем ЖК;
  • floor_id доступен для использования только для блоков или ЖК у которых только 1 блок;
  • apartment_id доступен для использования только для этажей.
Да

Пример для ЖК


	
http://domain.com/images/image1.jpg

	


		100100
		300100
		300300
		100300
		
			<section_id>dc1s1
		
	
	


		400100
		600100
		600500
		400500
		
			<section_id>dc1s2
		
	
	


		600100
		800100
		800500
		600500
		
			<section_id>dc1s3
		
	


Пример для этажа

<scheme_2d>
	

http://domain.com/image6.jpg 100100 300100 300300 100300 <apartment_id>dc1a1 400100 600100 600500 400500 <apartment_id>dc1a2 <scheme_3d>

http://domain.com/image7.jpg

Пример для блока


	http://domain.com/image5.jpg
	


		100100
		300100
		300300
		100300
		
			<floor_id>dc1s2f1
		
	
	


		400100
		600100
		600500
		400500
		
			<floor_id>dc1s2f2
		
	


 

4. Справочники

Список кодов языков:

ЯзыкКод
Русский ru
Английский en
Турецкий tr
Немецкий de
Финский fi
Шведский sv
Норвежский no
Польский pl
Азербайджанский az
Казахский kk
Белорусский by
Украинский ua
Датский da
Фарси fa
Французский fr
Испанский es
Итальянский it
Румынский ro
Португальский pt
Иврит he
Японский jz
Китайский zh
Хинди hi
Голландский nl
Латвийский lv
Корейский ko
Албанский al
Словенский sk
Индонезийский id
Малазийский ms
Филиппинский ph

Также, список доступных языков представлен в справочнике языков, см. список справочников.

Список справочников:

  • Справочник типов недвижимости: XML / JSON
  • Справочник типов сделок: XML / JSON
  • Справочник статусов: XML / JSON
  • Справочник застройщиков: XML / JSON
  • Справочник особенностей объектов: XML / JSON
  • Справочник валют: XML / JSON
  • Справочник регионов, районов и комьюнити: XML / JSON
  • Справочник жилых комплексов: XML / JSON
  • Справочник доступных сроков аренды: XML / JSON
  • Справочник доступных языков: XML / JSON
  • Пример XML-файла: https://emirates.estate/uploads/xml_import_sample.xml

Также список справочников доступен в Вашем личном кабинете на сайте в разделе «Объекты» > «Импорт объектов» > «Документация» (https://emirates.estate/agency-profile/properties/?autoload=documentation)

 

5. Примеры заполнения полей

ТегПример неверного заполненияПример верного заполнения

id

 Несколько объектов с одинаковым ID недопустимо
 Уникальное значение для каждого объекта

edited

2020-01-17

17 января 2020

17/01/2020 05:33
Неверные форматы даты
2020-01-17T08:05:33+0000
Дата в формате ISO-8601

description


   Описание объекта

Описание объекта не обернуто в


   Описание объекта

]]>

Описание объекта содержит HTML теги


   

Описание объекта содержит HTML теги, хоть и закодированные.


   
   

Неверные коды языков в мультиязычном формате


   

или


   
   

excerpt


   Краткое описание объекта

Краткое описание не обернуто в


    Краткое описание объекта 

]]>

Краткое описание содержит HTML теги


   

Краткое описание содержит HTML теги, хоть и закодированные.


   
   

Неверные коды языков в мультиязычном формате


   

или


   
   

labels

 

Текст метки указан непосредственно в теге labels


   

Текст метки не обернут в


   

Метка содержит HTML теги


   

Метка содержит HTML теги, хоть и закодированные.


   
   

или


   
      
      
   
   
      
      
   

deal

sale

В качестве типа сделки должен указываться числовой идентификатор из справочника

10

Идентификатор типа сделки отсутствует в справочнике

1

price

123 456

Числовое значение должно указываться без разделителей

1234,56

В качестве разделителя дробной части должна использоваться точка

123456 EUR

Цена должна содержать только числовое значение

123456

currency

euro

$


Неверные коды валюты

EUR

price_period

<price_period> 

Не указан период аренды

<price_period>week

Неверный период аренды

<price_period>monthly

installment

yes

3
Недопустимые значения тега
1

type

apartment

В качестве типа объекта должен указываться числовой идентификатор из справочника

111

Идентификатор типа объекта отсутствует в справочнике

1

region

Анталья

Antalya

В качестве региона должен указываться числовой идентификатор из справочника

123456

Идентификатор региона отсутствует в справочнике

90

district

Business Bay

В качестве района должен указываться числовой идентификатор из справочника

170

Указан идентификатор региона, а не района

170
1

Указанный район не соответствует указанному региону

1

community

Avencia

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

3

Указан идентификатор региона, а не комьюнити

170
1

Указанное комьюнити не соответствует указанному региону

1

status

Secondary

В качестве статуса объекта должен указываться числовой идентификатор из справочника

10

Идентификатор статуса объекта отсутствует в справочнике

1

square

150 m2

Площадь объекта должна указываться числом квадратных метров без указания единиц измерения

150-160

Должно указываться только одно значение площади объекта

150

rooms

studio

2+1

В качестве количества комнат должно указываться числовое значение

2,3

Должно указываться только одно значение количества комнат

2

bedrooms

2+1

В качестве количества спален должно указываться числовое значение

1,2

Должно указываться только одно значение количества спален

1

bathrooms

да

В качестве количества ванных должно указываться числовое значение

1,2

Должно указываться только одно значение количества ванных

2

floor

five

В качестве этажа должно указываться числовое значение

5,6,7

Должно указываться только одно значение этажа

5

floors

ten

В качестве этажности должно указываться числовое значение

10,12

Должно указываться только одно значение этажности

10

tosea

500 m

Расстояние до моря указывается числом метров, без указания единиц измерения

0.5

Расстояние до моря должно быть указано в метрах, а не километрах

500

tocenter

1000 m

Расстояние до центра города указывается числом метров, без указания единиц измерения

1

Расстояние до центра города должно быть указано в метрах, а не километрах

1000

toairport

15 km

Расстояние до аэропорта указывается числом километров, без указания единиц измерения

15000

Расстояние до аэропорта должно быть указано в километрах, а не метрах

15

finish

2021

Дата завершения строительства указана без вложенных тегов year и quarter


   21
   1

Год должен быть указан в формате ГГГГ


   2021
   II

Квартал окончания строительства должен быть указан арабской цифрой


   2021

Не указан квартал окончания строительства


   2021
   1

finished

yes

10

Недопустимые значения тега

0

geo

30.123456,31.234567

Координаты заданы без указания вложенных тегов lat и lng


   36°49'13.4"N
   34°38'21.6"E

Координаты должны быть указаны в виде десятичных дробей


   30.123456
   31.234567

developer

Yekta Homes

В качестве застройщика должен указываться числовой идентификатор из справочника

123456

Идентификатор застройщика отсутствует в справочнике

83

images

http://domain.com/image1.jpg,
http://domain.com/image2.jpg,
http://domain.com/image3.jpg

Изображения указаны без вложенных тегов image


   /path/image1.jpg
   /path/image2.jpg
   /path/image3.jpg

Необходимо указывать абсолютный URL изображений


   http://domain.com/image1.jpg
   http://domain.com/image2.jpg
   http://domain.com/image3.jpg

agent

John Smith

Сотрудник указан без вложенного тега name


   Nonexistent manager

Указан сотрудник, не присутствующий в списке сотрудников Вашей компании на emirates.estate


   John Smith

Сотрудник John Smith присутствует в списке сотрудников Вашей компании на emirates.estate

features

5,19,71

Особенности объекта указаны без вложенных тегов feature


   Близко к пляжу
   Близко к природе
   У моря

В качестве особенностей объекта должны указываться числовые идентификаторы из справочника


   5
   19
   71

scheme


   
   

Не указан URL изображения


   http://domain.com/images/image1.jpg
   




Не указаны точки для тега area


   http://domain.com/images/image1.jpg
   


      
          
          100,34
       
   



Не указана координата по оси X. Для координаты по оси Y указано не число (в качестве разделителя целой и дробной части должен использоваться знак точки).


   http://domain.com/images/image1.jpg 
   


       
	    100100
       
       
          300100
       
       
          300300
       
       
          100300
       
       
         <section_id>dc1s1
       
    

			

image_2d

<image_2d>/path/image1.jpg

Необходимо указывать абсолютный URL изображений

<image_2d>http://domain.com/image1.jpg

image_3d

<image_3d>/path/image1.jpg

Необходимо указывать абсолютный URL изображений

<image_3d>http://domain.com/image1.jpg

project_id

<project_id>project

В качестве идентификатора ЖК используется число.

<project_id>10835

development


В качестве идентификатора ЖК должен быть указан идентификатор из текущего документа (он не может быть пустым).

development-123

section

В качестве идентификатора блока должен быть указан идентификатор из текущего документа (он не может быть пустым).

section-123

layout


В качестве идентификатора планировки должен быть указан идентификатор из текущего документа (он не может быть пустым).

layout-123

number

123 456

Числовое значение должно указываться без разделителей

first

Номер этажа должен указываться числом

1

 

6. Часто задаваемые вопросы

Как удалить объект, ранее добавленный через XML файл?

Для удаления объекта, который был добавлен на emirates.estate с помощью XML файла, необходимо удалить данный объект из этого XML файла. Во время очередного импорта данных все отсутствующие в файле объекты будут удалены. Обратите внимание, что идентификация объектов производится по значению тега id.

 

Мы обновили информацию об объекте в XML, но на emirates.estate изменения не появились

Такая ситуация возможна по двум причинам:

  1. Очередной импорт объектов еще не производился. Пожалуйста, обратите внимание, что импорт производится один раз в сутки.
  2. Не изменилась дата редактирования объекта – тег edited. В процессе обработки XML файла для каждого объекта сравнивается дата его последнего редактирования, указанная в теге edited, со значением, указанным в процессе предыдущего импорта. Изменение данных на emirates.estate производится только в том случае, если дата последнего редактирования увеличилась.

 

Фотография объекта не отображается на emirates.estate, но в XML файле она присутствует

Пожалуйста, проверьте правильность указания ссылки на фотографию в XML файле, а также соответствие ее требованиям:

  • Необходимо указывать полный URL фотографии, по которому она общедоступна без каких-либо дополнительных параметров (авторизации, специфичных заголовков HTTP и т.п.)
  • Фотография должна быть в формате JPEG, GIF или PNG.
  • Ширина фотографии не более 5000 пикселей, а высота не более 4000 пикселей
  • Для объекта указано не более 30 фотографий. Изображения, начиная с 31-го, загружены не будут

Также, пожалуйста, обратите внимание, что загрузка информации об объекте и загрузка фотографий происходят не одновременно: сначала на emirates.estate импортируются описания объектов, а затем загружаются изображения. В случае необходимости одновременной загрузки большого количества изображений, процесс из обработки может занять несколько часов.

 

Можно ли использовать HTML в описании объекта? Как производит разметку и оформление описания?

Нет, к сожалению, в описании объекта нельзя использовать никаких тегов HTML. Для разметки описания объекта, пожалуйста, используйте переводы строк.

 

У нас объект в планировке 2+1 – как правильно указать количество комнат и спален?

В теге rooms необходимо указать общее количество комнат объекта, включая гостиные, а в теге bedrooms – количество спален. Для планировки 2+1 общее количество комнат – 3, именно это значение и нужно указать в теге rooms. Спален в планировке 2+1 две, поэтому в теге bedrooms необходимо указать 2.

 

Как проверить результаты импорта объектов?

Отчет о последнем импорте объектов из Вашего XML-файла доступен в Вашем личном кабинете в разделе «Объекты» > «Импорт объектов». Там указана дата последнего успешного импорта из Вашего XML-файла и отчет по количеству добавленных, обновленных и скрытых объектов. Нажав на ссылку «Показать детали», можно ознакомиться с подробным отчетом.

Пример простого файла для импорта



   

Пример файла со структурой ЖК для импорта



	
	
		dc1q1
		2020-02-09T08:08:33+0000
		
			
			
		
		
			2021
			3
		
		dc001
	
dc1s1 2020-02-09T08:08:33+0000 2021 2 dc001 dc1q1 http://domain.com/image2.jpg 100100 300100 300300 100300 <floor_id>dc1s1f1 400100 600100 600500 400500 <floor_id>dc1s1f2 600100 800100 800500 600500 <floor_id>dc1s1f3
dc1s2 2020-02-09T08:08:33+0000 dc001 dc1q1 http://domain.com/image5.jpg 100100 300100 300300 100300 <floor_id>dc1s2f1 400100 600100 600500 400500 <floor_id>dc1s2f2
dc1s3 2020-02-09T08:08:33+0000 dc001 2022 3
dc1s1f1 2020-02-09T08:08:33+0000 1 dc001
dc1s1
<scheme_2d> http://domain.com/image6.jpg 100100 300100 300300 100300 <apartment_id>dc1a1 400100 600100 600500 400500 <apartment_id>dc1a2 <scheme_3d> http://domain.com/image7.jpg
dc1s1f2 2020-02-09T08:08:33+0000 2 dc001
dc1s1
<scheme_2d> http://domain.com/image8.jpg <scheme_3d> http://domain.com/image9.jpg
dc1s1f3 2020-02-09T08:08:33+0000 3 dc001
dc1s1
dc1s2f1 2020-02-09T08:08:33+0000 1 dc001
dc1s2
dc1s2f2 2020-02-09T08:08:33+0000 2 dc001
dc1s2
dc1l1 2020-06-22T08:08:35+0000 90000 EUR 90 2 1 3 dc001
dc1s1
<image_2D> http://domain.com/image2d.jpg <image_3D> http://domain.com/image3d.jpg 6 21 72
dc1l2 2020-06-22T08:08:35+0000 110000 EUR 110 3 2 2 dc001
dc1s1
<image_2D> http://domain.com/image2d.jpg <image_3D> http://domain.com/image3d.jpg
dc1l3 2020-06-22T08:08:35+0000 80000 EUR 120 3 2 3 dc001
dc1s3
<image_2D> http://domain.com/image2d.jpg
dc1l4 2020-06-22T08:08:35+0000 150000 EUR 180 5 4 3 dc001