Россия - XML файл Недвижимость – Thribee

Если у вас есть сайт с объявлениями, вы можете включить ваши объявления в результаты поиска Trovit, Mitula! Это очень просто:

1. Создайте XML файл в специальном формате, указанном ниже.
2. Используйте нашу контактную форму для отправки URL (Например: http://www.ваше-доменное-имя.com/wp_feed.xml), на ваш XML файл.

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

Ваши объявления будут включены в результаты поиска Trovit, Mitula как можно раньше.

Если у вас есть вопросы или замечания, пожалуйста, свяжитесь с нами!

ФОРМАТ XML ФАЙЛА

Вот несколько простых инструкций для подготовки XML файла, для того, чтобы включить ваши объявления в результаты поиска Trovit, Mitula. Если вам необходима дополнительная информация о формате XML, рекомендуем обратиться к Wikipedia.

Кодировка файла должна быть UTF-8.

XML файл будет содержать один главный тег ‘trovit’ , который будет содержать множество объявлений, представленных блоками тегов ‘ad’. Каждый блок ‘ad’ содержит обязательные и необязательные поля:

ОБЯЗАТЕЛЬНЫЕ ПОЛЯ

Обязательные поля – это набор тегов XML, которые обеспечивают минимальное количество информации, необходимой для нашей системы, чтобы включить ваши объявления в результаты поиска Trovit, Mitula.

id: Идентификационный номер объявления на вашем сайте (цифровой или буквенно-цифровой, он должен быть уникальным, поскольку мы используем его, чтобы избежать дублирования записей).
url: Адрес объявления на вашем сайте.
title: Название объявления.
type: Тип объявления. Содержание этого поля должно быть одним из следующих:
- “For Rent”: Долгосрочная аренда жилой недвижимости (квартиры, комнаты, дома, дачи, коттеджи и т.д.);
- “For Sale”: Продажа жилой недвижимости (квартиры, комнаты, дома, дачи, коттеджи и т.д.);
- “Office For Rent”: Аренда офисов (скоро открытие);
- “Office For Sale”: Продажа офисов (скоро открытие);
- “Land For Sale”: Продажа земельных участков (скоро открытие);
- “For Rent Local”: Аренда помещений (скоро открытие);
- “For Sale Local”: Продажа помещений (скоро открытие).
content: Описание объявления (минимум 30 символов). Обратите внимание, что качество описания объявления имеет большое влияние на количество посетителей.
date: Дата публикации объявления. Допустимый формат: ДД/ММ/ГГГГ или ДД/ММ/ГГГГ ЧЧ:MM:СС и ГГГГ/MМ/ДД or ГГГГ/MМ/ДД ЧЧ:MM:СС.

ДОПОЛНИТЕЛЬНЫЕ ПОЛЯ

Дополнительные поля не являются обязательными для заполнения. Но если эти поля присутствуют в объявлениях на вашем сайте, вы можете включить их в свой XML файл. Алгоритм сортировки Trovit, Mitula ставит в приоритет качество объявления, поэтому, чем больше дополнительной информации включено в ваше объявление, тем выше ваша позиция!

mobile_url: URL объявления на вашем сайте, когда пользователь просматривает на мобильном устройстве. Полезно, если ваш сайт имеет мобильную версию.

price: Цена объекта недвижимости. Вы можете указать период (monthly, weekly) в качестве атрибута в этом таге:
```
<price period="monthly"><![CDATA[...]]></price>
<price period="weekly"><![CDATA[...]]></price>
```
См. технические характеристики, чтобы узнать какие ограничения по умолчанию существуют для каждого типа объявлений.

Если цена указана в валюте, которая не является официальной валютой страны, необходимо использовать атрибут ‘currency’. Вид валюты определяется по стандарту ISO-4217. Таким образом, Trovit, Mitula будет осуществлять конвертацию в официальную валюту страны.

Период по умолчанию ежемесячный, но также можно установить еженедельный. Синтаксис будет следующим:
```
<price period="weekly" currency="USD"><![CDATA[...]]></price>
```
В данном примере цена указана в неделю, в долларах. Символ валюты не должен находиться рядом с ценой.
property_type: Вид объекта недвижимости (например: квартира, дом, студия, пентхаус и т. д.). Применяется только в том случае, если тип объявления «For rent» или «For sale».
address: Адрес, по которому находиться объект недвижимости.
floor_number: Этаж, на котором находится объект недвижимости.
neighborhood: Район, в котором находится объект недвижимости.
city_area: Часть города (округ/окрестность), в которой находится объект недвижимости.
city: Город, в котором находится объект недвижимости.
postcode: Почтовый индекс.
region: Название области/Республики/края, в котором находится объект недвижимости.
latitude: Широта, на которой находится объект недвижимости. См. технические характеристики для более подробной информации.
longitude: Долгота, на которой находится объект недвижимости. См. технические характеристики для более подробной информации.
orientation: Информация об ориентации объекта недвижимости (север, юг, восток, запад и т. д.).
agency: Название агенства. См. поле by_owner для дополнительной информации.
floor_area: Площадь объекта недвижимости. Если единица измерения не указана, единицей измерения по умолчанию является квадратный метр. Вы можете указать единицу измерения при помощи атрибута ‘unit’:
```
<floor_area unit="feet"><![CDATA[...]]></floor_area>
<plot_area unit="acres"><![CDATA[...]]></plot_area>
```
Доступными значениями ‘unit’ являются: “meters” или “feet”.
plot_area: Площадь земельного участка, на котором находится объект недвижимости. Если единица измерения не указана, берется местная единица измерения по умолчанию. Вы можете указать единицу измерения при помощи атрибута ‘unit’:
```
<plot_area unit="feet"><![CDATA[...]]></plot_area>
<plot_area unit="acres"><![CDATA[...]]></plot_area>
```
Доступными значениями ‘unit’ являются: “meters”, “feet”, “acres” или “hectares”.
rooms: Количество комнат объекта недвижимости.
bathrooms: Количество ванных комнат объекта недвижимости.
condition: Информация о состоянии объекта недвижимости (например: недавно отремонтирован).
year: Год постройки объекта недвижимости. Допустимый формат: ГГГГ.
virtual_tour: URL на виртуальный тур по объекту недвижимости.
eco_score: Информация, в свободной форме, об энергоэффективности недвижимости.
pictures: Этот тег включает различные изображения объекта недвижимости.
Полем, которое определяет особенности конкретного изображения является <picture>:
- picture: Этот тег включает в себя поля, предназначеные для того, чтобы указывать URL и название изображения (опционально). С помощью атрибута ‘featured’, есть возможность указать будет ли это изображение показываться:
```
        <picture featured="true"><![CDATA[...]]></picture>
```
  Возможные значения атрибута ‘featured’: “true” или “false”.
  
  Поля, содержащиеся внутри тега <picture> :
  - - picture_url: URL изображения.
    - picture_title: Название изображения.
```
<pictures>
    <picture>
        <picture_url><![CDATA[...]]></picture_url>
        <picture_title><![CDATA[...]]>/picture_title>
    </picture> 

    <picture featured="true">
        <picture_url><![CDATA[...]]></picture_url>
        <picture_title><![CDATA[...]]>/picture_title>
    </picture>
        ...
</pictures>
```
  Изображение/фотография, которое будет показываться для объявления в Trovit, Mitula будет являться первым изображением/фотографией из всех изображений/фотографий, которые содержит объявление. Выберите наиболее подходящее изображение/фотографию, поскольку оно имеет большое влияние на количество кликов пользователей.
  
  Trovit, Mitula не позволяет использование корпоративных изображений/фотографий с надписями типа «доступных изображений нет». Если подобные изображения/фотографии будут обнаружены, Trovit, Mitula оставляет за собой право заблокировать ваши объявления.
  
  После того как ваши объявления будут добавлены в результаты поиска Trovit, Mitula изображения, связанные с объявлениями станут недоступными для изменения. Убедитесь, что новые объявления, которые вы добавляете в свой XML файл содержат правильные изображения/фотографии.
expiration_date: Дата, на которую истекает срок действия объявления. Допустимый формат: ДД/ММ/ГГГГ или ДД/ММ/ГГГГ ЧЧ:MM:СС и ГГГГ/MМ/ДД or ГГГГ/MМ/ДД ЧЧ:MM:СС.
Следующие поля должны быть заполнены в соответствии с тем, являются ли они «истинными» или «ложными». См. технические характеристики, чтобы узнать, какие значения представляют «истину» и какие «ложь».
by_owner: Предлагается ли объект недвижимости собственником. В случае отрицательного значения будет понятно, что объект предлагается агенством.
parking: Располагает ли объект недвижимости паркингом/гаражом.
is_rent_to_own: Сдается ли недвижимость в аренду с правом выкупа.
is_furnished: Меблирован ли объект недвижимости или нет.
is_new: Является ли объект недвижимости новостройкой.

XML файл будет иметь следующий вид:

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
    <id><![CDATA[...]]></id>
    <url><![CDATA[...]]></url>
    <title><![CDATA[...]]></title>
    <type><![CDATA[...]]></type>
    <content><![CDATA[...]]></content>
    <price><![CDATA[...]]></price>
    <property_type><![CDATA[...]]></property_type>
    <address><![CDATA[...]]></address>
    <floor_number><![CDATA[...]]></floor_number>
    <city_area><![CDATA[...]]></city_area>
    <city><![CDATA[...]]></city>
    <postcode><![CDATA[...]]></postcode>
    <region><![CDATA[...]]></region>
    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>
    <orientation><![CDATA[...]]></orientation>
    <agency><![CDATA[...]]></agency>
    <floor_area><![CDATA[...]]></floor_area>
    <plot_area unit="acres"><![CDATA[...]]></plot_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <condition><![CDATA[...]]></condition>
    <year><![CDATA[...]]></year>
    <virtual_tour><![CDATA[...]]></virtual_tour>
    <date><![CDATA[...]]></date>
    <by_owner><![CDATA[...]]></by_owner>
    <parking><![CDATA[...]]></parking>
    <foreclosure><![CDATA[...]]></foreclosure>
    <is_furnished><![CDATA[...]]></is_furnished>
    <is_new><![CDATA[...]]></is_new>
    <pictures>
        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        ...
    </pictures>
</ad>
<ad>
    ....
</ad>
</trovit>

Пример XML файла

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
	<id><![CDATA[7004578]]></id>
	<url><![CDATA[http://www.ваше-доменное-имя.com/ad/7004578]]></url>
	<title><![CDATA[2-комнатная квартира в Санкт-Петербурге]]></title>
	<type><![CDATA[For rent]]></type>
	<content><![CDATA[Уютная квартира с хорошим ремонтом в отличном районе, рядом с метро.]]></content>
        <price><![CDATA[24500]]></price>
	<property_type><![CDATA[Квартира]]></property_type>
	<address><![CDATA[Московский просп, д. 206]]></address>
	<floor_number><![CDATA[2]]></floor_number>
	<city_area><![CDATA[Московский район]]></city_area>
	<city><![CDATA[Санкт-Петербург]]></city>
	<postcode><![CDATA[196066]]></postcode>
	<region><![CDATA[Санкт-Петербург]]></region>
	<agency><![CDATA[Недвижимость Санкт-Петербурга]]></agency>
	<floor_area><![CDATA[40]]></floor_area>
	<rooms><![CDATA[2]]></rooms>
	<bathrooms><![CDATA[1]]></bathrooms>
	<condition><![CDATA[]]></condition>
	<year><![CDATA[2000]]></year>
	<virtual_tour><![CDATA[]]></virtual_tour>
        <date><![CDATA[31/05/2011 18:30:00]]></date>
        <by_owner><![CDATA[1]]></by_owner>
	<parking><![CDATA[1]]></parking>
	<is_furnished><![CDATA[0]]></is_furnished>
	<is_new><![CDATA[0]]></is_new>
        <pictures>
		<picture>
			<picture_url><![CDATA[http://www.ваше-доменное-имя.com/image.jpg]]></picture_url>
			<picture_title><![CDATA[кухня]]></picture_title>
		</picture>
	</pictures>
</ad>
<ad>
	<id><![CDATA[332A53BC2]]></id>
	<url><![CDATA[http://www.ваше-доменное-имя.com/ad/332A53BC2]]></url>
	<title><![CDATA[3-к квартира м. Пр-т Вернадского Ленинский  дом 92 корп. 1]]></title>
	<type><![CDATA[For sale]]></type>
	<content><![CDATA[3-комнатная квартира на 6-м этаже 30-и этажного дома. С/у - раздельный, без балкона]]></content>
	<price><![CDATA[30000000]]></price>
	<property_type><![CDATA[Квартира]]></property_type>
	<address><![CDATA[Ленинский пр. 92]]></address>
	<floor_number><![CDATA[6]]></floor_number>
	<city_area><![CDATA[Западный административный округ]]></city_area>
	<city><![CDATA[Москва]]></city>
	<postcode><![CDATA[119415]]></postcode>
	<region><![CDATA[Москва]]></region>
	<agency><![CDATA[]]></agency>
	<floor_area><![CDATA[137]]></floor_area>
	<plot_area><![CDATA[]]></plot_area>
	<rooms><![CDATA[3]]></rooms>
	<bathrooms><![CDATA[1]]></bathrooms>
	<condition><![CDATA[]]></condition>
	<year><![CDATA[2005]]></year>
	<virtual_tour><![CDATA[]]></virtual_tour>
        <date><![CDATA[15/06/2011]]></date>
        <by_owner><![CDATA[1]]></by_owner>
	<parking><![CDATA[0]]></parking>
	<is_furnished><![CDATA[]]></is_furnished>
	<is_new><![CDATA[]]></is_new>
	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.ваше-доменное-имя.com/image.jpg]]></picture_url>
			<picture_title><![CDATA[гостиная]]></picture_title>
		</picture>
	</pictures>
</ad>
</trovit>

Articles in this section

Россия - XML файл Недвижимость

ФОРМАТ XML ФАЙЛА

ОБЯЗАТЕЛЬНЫЕ ПОЛЯ

ДОПОЛНИТЕЛЬНЫЕ ПОЛЯ

Пример XML файла

Comments