XML Стандарт
На портал KVARTIRAzaMKAD.ru возможна выгрузка объявлений о продаже квартир в новостройках в автоматическом режиме.
Файлы для загрузки объявлений должны соответствовать стандарту XML.
Корректность XML-фида Вы можете проверить самостоятельно на странице валидатора кода.
Не разрешено использовать первые 32 ASCII-символа в текстовых полях (исключения — табуляция, перевод строки, возврат каретки). Также стандарт строго требует кодировать в тексте следующие символы:
" | " |
& | & |
> | > |
< | < |
' | ' |
Формат даты:
Все даты и время следует указывать согласно стандарту ISO 8601. В общем случае дата и время по этому стандарту следует указывать в формате YYYY-MM-DDTHH:mm:ss+00:00, где
-
YYYY — год;
-
MM — месяц;
-
DD — день;
-
HH — час;
-
mm — минута;
-
ss — секунда;
-
+00:00 — указание часового пояса (для Москвы — +04:00).
Кодировка:
Файл должен быть создан в кодировке UTF-8.
Заголовок документа:
Корневой элемент:
...
Корневой элемент realty-feed содержит элементы offer, каждое из которых содержит информацию из одного объявления.
У элемента offer есть обязательный атрибут internal-id, который должен быть уникальным для каждого объявления. Этот атрибут можно заполнять, например, идентификатором объявления в вашей базе данных.
- элемент объявления может содержать следующие элементы:
Обязательные элементы отмечены символом «*»
Элементы | Описание |
building-name | Новостройка ("ЖК «Ольховка»"). Полный перечень объектов |
location | География* |
price | Цена* |
area | Площадь* |
rooms | Количество комнат |
floor | Этаж |
floors-total | Общее количество этажей в доме |
description | Описание (не более 10 000 знаков) |
sales-agent | Информация о продавце* |
creation-date | Дата создания |
expire-date | Дата окончания |
images | Фото |
Информация о продавце*
Элементы | Описание |
name | ФИО* (не более 250 символов) |
phone | телефон* (до 50 символов) |
organization | Организация (не более 250 символов) |
Цена
Элементы | Описание |
value | Значение* |
Площадь
Элементы | Описание |
value | Значение* |
География
Элементы | Описание |
locality-name | название города* |
direction | шоссе |
address | адрес |
latitude | широта |
longitude | долгота |
Фото
Элементы | Описание |
image* | URL изображения ("http://kvartirazamkad.ru/css/images/kzm.gif") |
Пример валидного xml
<?xml version="1.0" encoding="UTF-8"?> <realtyfeed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06"> <generation-date>2010-10-05T16:36:00+04:00</generation-date> <offer internal-id="1234"> <building-name>ЖК «Ольховка»</building-name> <location> <locality-name>Володарского</locality-name> <direction>Молоковское</direction> <address>5, 5</address> <latitude>56.00461704059796</latitude> <longitude>37.5330223862304</longitude> </location> <price> <value>5000000</value> </price> <area> <value>322</value> </area> <rooms>3</rooms> <floor>4</floor> <floors-total>10</floors-total> <description>Это тестовове объявление</description> <sales-agent> <name>Сергей</name> <phone>8628734234</phone> <organization>Организация</organization> </sales-agent> <images> <image>http://kvartirazamkad.ru/css/images/kzm.gif</image> </images> <creation-date>2013-02-25 12:03:14</creation-date> <expire-date>2013-03-01 12:03:14</expire-date> </offer> </realtyfeed>