Описание формата XML-файла для автоматического импорта объектов
1. Пример файла
Примеры файлов для импорта приведены в конце страницы:
- простой файл для импорта;
- файл для импорта со структурой для жилых комплексов (очереди строительства, блоки, этажи, планировки, квартиры).
Также примеры XML-файлов доступны по адресам:
- Простой – https://emirates.estate/uploads/xml_import_sample.xml
- Со структурой ЖК – https://emirates.estate/uploads/xml_import_complexes_sample.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 |
Период, для которого указана цена, в случае, когда объект представляет собой предложение аренды. Одно из двух значений:
|
Да, в случае аренды | К, О |
|
installment |
Возможна ли рассрочка для данного объекта. Возможные значения:
|
Нет | ЖК, К, О |
|
type |
Числовой идентификатор типа объекта. Значение ID из справочника, см. п. 4, справочник типов объектов. Внимание:
|
Да | ЖК, К, О |
|
region |
Числовой идентификатор региона расположения объекта. Значение ID из справочника, см. п. 4, справочник регионов и районов. Секция regions. Внимание: в качестве региона рекомендуем указывать город (тип city в справочнике) |
Да | ЖК, О |
|
district |
Числовой идентификатор района расположения объекта. Значение ID из справочника, см. п. 4, справочник регионов и районов. Секция districts. Внимание: в случае указания района, значение его атрибута city из справочника должно совпадать со значением, указанным в теге region. |
Нет | ЖК, О |
|
community |
Числовой идентификатор комьюнити расположения объекта. Значение ID из справочника, см. п. 4, справочник регионов и районов. Секция communities. Внимание: в случае указания комьюнити, значение его атрибута city из справочника должно совпадать со значением, указанным в теге region. |
Нет | ЖК, О |
|
status |
Числовой идентификатор статуса объекта. Значение ID из справочника, см. п. 4, справочник статусов. | Да | ЖК, К, О |
|
square |
Общая площадь объекта в квадратных метрах, число. | Нет | К, О |
|
rooms |
Общее количество комнат объекта, число. Внимание:
|
Нет | К, О |
|
bedrooms |
Количество спален объекта, число. | Нет | К, О |
|
bathrooms |
Количество ванных комнат, число. | Нет | К, О |
|
floor |
Этаж расположения объекта, число. | Нет | К, О |
|
floors |
Этажность объекта, число. Для квартир указывается этажность дома, в котором расположена квартира. Для домов, вилл и т.п. указывается этажность самого объекта. | Нет | ЖК, О |
|
tosea |
Расстояние от объекта до моря в метрах, число. | Нет | ЖК, О |
|
tocenter |
Расстояние от объекта до центра города в метрах, число. | Нет | ЖК, О |
|
toairport |
Расстояние от объекта до ближайшего аэропорта в километрах, число. | Нет | ЖК, О |
|
finish |
Дата завершения строительства объекта. Указывается в виде набора тегов:
Пример:
|
Нет | ЖК, О |
|
finished |
Сдан ли объект. Возможные значения:
|
Нет | ЖК, О |
|
geo |
Широта и долгота объекта. Указывается в виде набора тегов:
Пример:
|
Нет | ЖК, О |
|
developer |
Числовой идентификатор застройщика, осуществляющего строительство объекта. Значение ID из справочника, см. п. 4, справочник застройщиков. | Нет | ЖК, О |
|
images |
Набор фотографий объекта. Указывается в виде набора тегов image, содержащих URL изображения. Пример:
Внимание:
|
Нет | ЖК, К, О |
|
agent |
Сотрудник Вашего агентства, выступающий менеджером по данному объекту. Указывается в виде тега name, значением которого выступает имя сотрудника в том виде, в каком оно указано в списке сотрудников в Вашем личном кабинете. Если данный тег не указывать, то в качестве продавца объекта на сайте emirates.estate будет указано контактное лицо компании. Пример:
|
Нет | ЖК, К, О |
|
features |
Набор числовых идентификаторов особенностей объекта. Указывается в виде набора тегов feature. В качестве значений используются идентификаторы особенностей объектов, см. п. 4, справочник особенностей объектов. Пример:
|
Нет | ЖК, К, О |
|
project_id |
Числовой идентификатор Жилого комплекса для объектов квартир, которые относятся к Жилым Комплексам других агенств. Значение ID из справочника, см. п. 4, справочник жилых комплексов. Секция complexes. Внимание: этот тег необходим для агентств, которые добавляют квартиры не в свои Жилые комплексы, если в вашем файле присутствует Жилой комплекс, к которому должна быть привязана квартира, используйте тег «development» |
Нет | О |
|
development |
Идентификатор Жилого комплекса для объекта типа «Квартира». Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится квартира. Внимание: если Жилой комплекс, к которому привязана квартира будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, квартира также добавлена не будет. |
Нет | К |
|
scheme |
Схема ЖК, подробнее см. пункт 3.6. | Нет | ЖК |
|
section |
Идентификатор Блока для объекта типа «Квартира». Значение ID из текущего файла импорта указанное в теге «id» для Блока, к которому относится квартира. Внимание: если Блок, к которому привязана квартира будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, квартира также добавлена не будет. |
Нет | К |
|
layout |
Идентификатор Планировки для объекта типа «Квартира». Значение ID из текущего файла импорта указанное в теге «id» для Планировки, к которой относится квартира. Внимание: если Планировка, к которой привязана квартира будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, квартира также добавлена не будет. |
Нет | К |
|
image_2d |
Указывается URL изображения, которое будет использоваться в качестве 2D схемы квартиры. Внимание:
|
Нет | К |
|
image_3d |
Указывается URL изображения, которое будет использоваться в качестве 3D схемы квартиры. Внимание:
|
Нет | К |
3.2. Набор полей для объектов, использующих тег «queue»
Тег «queue» используется для заполнения объектов типа «Очередь».
| Тег | Описание | Обязательный |
|---|---|---|
|
id |
Уникальный идентификатор очереди. Может содержать как цифры, так и буквы. | Да |
|
edited |
Дата и время последнего изменения данных об очереди в формате ISO-8601 | Да |
|
development |
Идентификатор Жилого комплекса для очереди. Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится очередь. Внимание: если Жилой комплекс, к которому привязана очередь будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, очередь также добавлена не будет. |
Да |
|
name |
Наименование очереди. Должно быть обернуто в Пример: Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – наименование очереди на данном языке. Наименование должно быть обернуто в . Пример: |
Да |
|
finish |
Дата завершения очереди строительства. Указывается в виде набора тегов:
Пример:
|
Да |
3.3. Набор полей для объектов, использующих тег «section»
Тег «section» используется для заполнения объектов типа «Блок».
| Тег | Описание | Обязательный |
|---|---|---|
|
id |
Уникальный идентификатор блока. Может содержать как цифры, так и буквы. | Да |
|
edited |
Дата и время последнего изменения данных о блоке в формате ISO-8601 | Да |
|
development |
Идентификатор Жилого комплекса для блока. Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится блок. Внимание: если Жилой комплекс, к которому привязан блок будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, блок также добавлен не будет. |
Да |
|
queue |
Идентификатор Очереди для блока. Значение ID из текущего файла импорта указанное в теге «id» для Очереди, к которой относится блок. Внимание: если Очередь, к которой привязан блок будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлена, блок также добавлен не будет. |
Нет |
|
name |
Наименование объекта. Должно быть обернуто в Пример: Также поддерживает мультиязычный формат. В этом случае указывается в виде набора тегов, где в качестве имени тега выступает код языка (см. п. 4), а в качестве значения – наименование очереди на данном языке. Наименование должно быть обернуто в . Пример: |
Да |
|
finish |
Дата завершения строительства блока. Указывается в виде набора тегов:
Пример:
|
Да |
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 |
Общее количество комнат планировки, число. Внимание:
|
Нет |
|
bedrooms |
Количество спален объекта, число. | Нет |
|
bathrooms |
Количество ванных комнат, число. | Нет |
|
images |
Набор фотографий планировки. Указывается в виде набора тегов image, содержащих URL изображения. Пример:
Внимание:
|
Нет |
|
features |
Набор числовых идентификаторов особенностей планировки. Указывается в виде набора тегов feature. В качестве значений используются идентификаторы особенностей объектов, см. п. 4, справочник особенностей объектов. Пример:
Внимание: Если не указано ни одной особенности, то список особенностей будет получен из списка особенностей ЖК, к которому относится планировка. Если же длязаполнена хотя бы 1 особенность, то список особенностей будет выводится как есть. |
Нет |
|
development |
Идентификатор Жилого комплекса. Значение ID из текущего файла импорта указанное в теге «id» для Жилого комплекса, к которому относится планировка. Внимание: если Жилой комплекс, к которому привязана квартира будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, квартира также добавлена не будет. |
Да |
|
section |
Идентификатор Блока. Значение ID из текущего файла импорта указанное в теге «id» для Блока, к которому относится планировка. Внимание: если Блок, к которому привязана планировка будет иметь ошибки в заполнении или по какой-то другой причине не сможет быть добавлен, планировка также добавлена не будет. |
Нет |
|
image_2d |
Указывается URL изображения, которое будет использоваться в качестве 2D схемы планировки. Внимание:
|
Нет |
|
image_3d |
Указывается URL изображения, которое будет использоваться в качестве 3D схемы планировки. Внимание:
|
Нет |
3.6. Описание поля заполнения схемы
Схема – это специальное изображение для элемента ЖК (самого ЖК, блока, этажа), которое содержит размеченные активные области в виде замкнутых многоугольников, являющиеся ссылками на другие элементы структуры ЖК, а также выводящие информацию о данных элементах. Схема используется для визуальной навигации пользователей по структуре жилого комплекса.
Например, схема ЖК содержит разметку входящих в него блоков или этажей, схема блока – разметку его этажей, схема этажа – разметку квартир на этом этаже.
В качестве общего тега для схемы используется тег, описанный в списке полей для определённого типа объекта, обычно это «scheme».
Внутри тега заполняется набор тегов, каждый из которых отвечает за конкретные элементы
| Тег | Описание | Обязательный |
|---|---|---|
|
image |
Указывается URL изображения, которое будет использоваться в качестве изображения схемы
Внимание:
|
Да |
|
area |
Данный тег позволяет задать замкнутый многоугольник в виде набора точек. Внутри тега заполняется набор других тегов, каждый из которых отвечает за конкретные элементы
Внимание:
|
Да |
Пример для ЖК
http://domain.com/images/image1.jpg
100 100 300 100 300 300 100 300 <section_id>dc1s1 400 100 600 100 600 500 400 500 <section_id>dc1s2 600 100 800 100 800 500 600 500 <section_id>dc1s3
Пример для этажа
<scheme_2d>http://domain.com/image6.jpg
100 100 300 100 300 300 100 300 <apartment_id>dc1a1 400 100 600 100 600 500 400 500 <apartment_id>dc1a2 <scheme_3d>http://domain.com/image7.jpg
Пример для блока
http://domain.com/image5.jpg
100 100 300 100 300 300 100 300 <floor_id>dc1s2f1 400 100 600 100 600 500 400 500 <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 |
Неверные форматы даты |
Дата в формате ISO-8601 |
|
description |
Описание объекта не обернуто в
Описание объекта содержит HTML теги Описание объекта содержит HTML теги, хоть и закодированные. Неверные коды языков в мультиязычном формате |
или |
|
excerpt |
Краткое описание не обернуто в
Краткое описание содержит HTML теги Краткое описание содержит HTML теги, хоть и закодированные. Неверные коды языков в мультиязычном формате |
или |
|
labels |
Текст метки указан непосредственно в теге labels Текст метки не обернут в Метка содержит HTML теги Метка содержит HTML теги, хоть и закодированные. |
или |
|
deal |
В качестве типа сделки должен указываться числовой идентификатор из справочника
Идентификатор типа сделки отсутствует в справочнике |
|
|
price |
Числовое значение должно указываться без разделителей
В качестве разделителя дробной части должна использоваться точка
Цена должна содержать только числовое значение |
|
|
currency |
Неверные коды валюты |
|
|
price_period |
<price_period> Не указан период аренды <price_period>week Неверный период аренды |
<price_period>monthly |
|
installment |
Недопустимые значения тега |
|
|
type |
В качестве типа объекта должен указываться числовой идентификатор из справочника
Идентификатор типа объекта отсутствует в справочнике |
|
|
region |
В качестве региона должен указываться числовой идентификатор из справочника
Идентификатор региона отсутствует в справочнике |
|
|
district |
В качестве района должен указываться числовой идентификатор из справочника
Указан идентификатор региона, а не района
Указанный район не соответствует указанному региону |
|
|
community |
В качестве комьюнити должен указываться числовой идентификатор из справочника
Указан идентификатор региона, а не комьюнити
Указанное комьюнити не соответствует указанному региону |
|
|
status |
В качестве статуса объекта должен указываться числовой идентификатор из справочника
Идентификатор статуса объекта отсутствует в справочнике |
|
|
square |
Площадь объекта должна указываться числом квадратных метров без указания единиц измерения
Должно указываться только одно значение площади объекта |
|
|
rooms |
В качестве количества комнат должно указываться числовое значение
Должно указываться только одно значение количества комнат |
|
|
bedrooms |
В качестве количества спален должно указываться числовое значение
Должно указываться только одно значение количества спален |
|
|
bathrooms |
В качестве количества ванных должно указываться числовое значение
Должно указываться только одно значение количества ванных |
|
|
floor |
В качестве этажа должно указываться числовое значение
Должно указываться только одно значение этажа |
|
|
floors |
В качестве этажности должно указываться числовое значение
Должно указываться только одно значение этажности |
|
|
tosea |
Расстояние до моря указывается числом метров, без указания единиц измерения
Расстояние до моря должно быть указано в метрах, а не километрах |
|
|
tocenter |
Расстояние до центра города указывается числом метров, без указания единиц измерения
Расстояние до центра города должно быть указано в метрах, а не километрах |
|
|
toairport |
Расстояние до аэропорта указывается числом километров, без указания единиц измерения
Расстояние до аэропорта должно быть указано в километрах, а не метрах |
|
|
finish |
Дата завершения строительства указана без вложенных тегов year и quarter
Год должен быть указан в формате ГГГГ
Квартал окончания строительства должен быть указан арабской цифрой
Не указан квартал окончания строительства |
|
|
finished |
Недопустимые значения тега |
|
|
geo |
Координаты заданы без указания вложенных тегов lat и lng
Координаты должны быть указаны в виде десятичных дробей |
|
|
developer |
В качестве застройщика должен указываться числовой идентификатор из справочника
Идентификатор застройщика отсутствует в справочнике |
|
|
images |
Изображения указаны без вложенных тегов image
Необходимо указывать абсолютный URL изображений |
|
|
agent |
Сотрудник указан без вложенного тега name
Указан сотрудник, не присутствующий в списке сотрудников Вашей компании на emirates.estate |
Сотрудник John Smith присутствует в списке сотрудников Вашей компании на emirates.estate |
|
features |
Особенности объекта указаны без вложенных тегов feature
В качестве особенностей объекта должны указываться числовые идентификаторы из справочника |
|
|
scheme |
Не указан URL изображения
Не указаны точки для тега area
Не указана координата по оси X. Для координаты по оси Y указано не число (в качестве разделителя целой и дробной части должен использоваться знак точки). |
|
|
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 |
В качестве идентификатора ЖК должен быть указан идентификатор из текущего документа (он не может быть пустым). |
|
|
section |
В качестве идентификатора блока должен быть указан идентификатор из текущего документа (он не может быть пустым). |
|
|
layout |
В качестве идентификатора планировки должен быть указан идентификатор из текущего документа (он не может быть пустым). |
|
|
number |
Числовое значение должно указываться без разделителей
Номер этажа должен указываться числом |
|
6. Часто задаваемые вопросы
Как удалить объект, ранее добавленный через XML файл?
Для удаления объекта, который был добавлен на emirates.estate с помощью XML файла, необходимо удалить данный объект из этого XML файла. Во время очередного импорта данных все отсутствующие в файле объекты будут удалены. Обратите внимание, что идентификация объектов производится по значению тега id.
Мы обновили информацию об объекте в XML, но на emirates.estate изменения не появились
Такая ситуация возможна по двум причинам:
- Очередной импорт объектов еще не производился. Пожалуйста, обратите внимание, что импорт производится один раз в сутки.
- Не изменилась дата редактирования объекта – тег 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
100 100 300 100 300 300 100 300 <floor_id>dc1s1f1 400 100 600 100 600 500 400 500 <floor_id>dc1s1f2 600 100 800 100 800 500 600 500 <floor_id>dc1s1f3 dc1s2 2020-02-09T08:08:33+0000 dc001 dc1q1 http://domain.com/image5.jpg
100 100 300 100 300 300 100 300 <floor_id>dc1s2f1 400 100 600 100 600 500 400 500 <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
100 100 300 100 300 300 100 300 <apartment_id>dc1a1 400 100 600 100 600 500 400 500 <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.jpg6 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.jpgdc1l3 2020-06-22T08:08:35+0000 80000 EUR 120 3 2 3 dc001 dc1s3 <image_2D> http://domain.com/image2d.jpgdc1l4 2020-06-22T08:08:35+0000 150000 EUR 180 5 4 3 dc001