Вход
Коттеджные поселки Подмосковья


Формат XML

Заголовок и структура

 

XML-файл имеет следующую структуру:

 

<?xml version="1.0" encoding="utf-8"?>

 <mosposelok-feed date="2012-09-01 17:00">

  <offer>

    ...

  </offer>

    ............

  <offer>

    ...

  </offer>

 </mosposelok-feed>

 

Атрибут date содержит дату и время генерации XML-файла. Формат: YYYY-MM-DD hh:mm.

 

Элемент <offer>

 

Содержимое XML-файла составляют предложения партнера. Предложение – сущность, содержащая: (а) информацию, необходимую для идентификации объекта – коттеджного поселка (название поселка, шоссе, расстояние от Москвы в км. и.т.п.), и (б) информацию о ценах, заявляемом сроке сдачи поселка и, главное, URL соответствующей страницы на сайте партнера. Каждое предложение задается в XML-файле элементом <offer>, который включает в себя следующие подэлементы (обязательные подэлементы отмечены звездочкой):

 

<offer>

 <id>...</id>*

 <object>...</object>*

 <url>...</url>*

 <price>...</price>

 <ready>...</ready>

</offer>

 

Элемент <id>

 

Обязательный элемент. Целое число. Идентификатор предложения в базе компании-партнера. У разных элементов <offer> в XML-файле должны быть разные элементы <id>.

Пример:

 

<id>31415</id>

 

Элемент <object>

 

Обязательный элемент. Может содержать следующие подэлементы (обязательные отмечены звездочкой):

<name>*

Произвольная текстовая строка (спецсимволы, в частности, кавычки, должны быть закодированы). Коммерческое наименование объекта, например, «КП &quot;Простоквашино&quot;», «Коттеджный поселок &quot;Мечта&quot;», «Дачный поселок &quot;Дубки&quot;»и.т.д.

<road>*

Текстовая строка – название шоссе, без слова «шоссе».

<distance>*

Целое число – расстояние до поселка от МКАД .

<region>*

Текстовая строка – название области, без слова «область».

<town>

Текстовая строка - ближайший к поселку населенный пункт (географическое наименование, не содержащее указания на район).

Примеры: «деревня Каменка», «Каменка», «сельское поселение Вороново».

<district>

Текстовая строка – название района области, без слова «район».

<mosposelok_id>

Целое число. Идентификатор объекта в базе Моспоселок.ру (числовое значение в строке адреса объекта, например, 1795 для объекта http://mosposelok.ru/realty/1795/). Смысл этого поля «Компания, предоставляющая XML-данные хотела бы, чтобы данный объект компании был проассоциирован с таким-то объектом в базе Моспоселок.ру». Редакция Моспоселок.ру с благодарностью принимает к сведению эту информацию, но оставляет за собой право проигнорировать данное поле.

 

Примеры:

 

<object>

 <name>Дачный поселок &quot;Талицкие берега&quot;</name>

 <road>Ярославское</road>

 <distance>35</road>

 <region>Московская</region>

 <district>Пушкинский</district>

 <town>Ашукино</town >

 <mosposelok_id>1795</mosposelok_id>

</object>

 

<object>

 <name>Коттеджный поселок &quot;Капитанская дочка&quot;</name>

 <road>Симферопольское</road>

 <distance>90</road>

 <region>Тульская</region>

</object>

 

 

Элемент <url>

 

Обязательный элемент. Ссылка на конкретную страницу на сайте партнера, отвечающую именно этому поселку (а не всему разделу, категории, результатам поиска и.т.п.). Текстовая строка, начинающаяся с «http».

 

Пример:

 

<url>http://www.agentstvo.ru/Moscow/Base/Info.aspx?ObjID=37045</url>

 

Элемент <price>

 

Необязательный элемент. Содержит следующие подэлементы (обязательные отмечены звездочкой):

<min>*

Целое число. Минимальная цена за домовладение (участок, дом, таунхаус) в валюте, указанной в поле <currency>

<max>*

Целое число. Максимальная цена за домовладение (участок, дом, таунхаус) в валюте, указанной в поле <currency>

<currency>*

Идентификатор валюты предложения. Одна из следующих текстовых строк: «RUR», «USD», «EUR».

 

Примеры:

 

<price>

 <min>4560000</min>

 <max>8480000</max>

 <currency>RUR</currency>

</price>

 

<price>

 <min>125000</min>

 <max>125000</max>

 <currency>USD</currency>

</price>

 

Элемент <ready>

 

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

<year>*

Целое число – год сдачи в формате «YYYY»

<quarter>

Целое число – номер квартала сдачи – одно из значений: «1», «2», «3» или «4».

 

<ready>

 <year>2014</year>

 <quarter>4<quarter>

</ready>

 

<ready>

 <year>2015</year>

</ready>