Содержание

• Обзор
• XML-формат DOM.ria.ua XML
  • Определения тегов XML
  • Пример DOM.ria.ua XML
• Местоположение файлов DOM.ria.ua XML
• Проверка Вашего DOM.ria.ua XML
• Разрешение проблем

Комплект инструментов для веб-мастеров позволяет легко и бесплатно сделать сайт удобнее для Агентств недвижимости, которые публикуют свои объявление на DOM.ria.ua.

Протокол DOM.ria.ua XML позволяет Вам организовать импорт обїявлений по недвижимости на сайт DOM.ria.ua а также на сайты наших партнеров. В простейшей форме DOM.ria.ua XML, использующий протокол DOM.ria.ua XML — это файл XML, в котором перечислены объявления для импорта.

Формат протокола DOM.ria.ua XML состоит из тегов XML. Для всех значений данных в DOM.ria.ua XML должно использоваться маскирование. Для самого файла должна использоваться кодировка UTF-8.

Ниже приведен пример DOM.ria.ua XML, в который включен только одно объявление, но используются некоторые необязательные теги.

<?xml version="1.0" encoding="UTF-8"?>
  <realties xmlns="http://xml.ria.ua/schemas/dom/0.1" 
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
          xsi:schemaLocation="http://www.xml.ria.ua/schemas/dom/0.1
          http://www.xml.ria.ua/schemas/dom/0.1/dom.xsd">
  
    <realty>
    
      <email>your@email.com</email>
      <local_realty_id>1234</local_realty_id>
      
      <type_ob_id>sale</type_ob_id>
      <type_realty_id>commercial_real_estate</type_realty_id>
      <obl_id>1</obl_id>
      <city_id>1</city_id>
      <area_id>15106</area_id>
      <street>первомайская, 140</street>
   
      <all_sq>885.00</all_sq>
      <type_wall_id>brick</type_wall_id>

      <price>200000</price>
      <type_price_id>for_all</type_price_id>
      
      <sotok>10.0</sotok>

      <name>Здание офисн., развл., гост. назначения</name>
      <zastroi>true</zastroi>
      <is_new>false</is_new>

      <publish_weeks>4</publish_weeks>

      <photos_urls>
        <loc>http://example.com/images/image1.jpg</loc>
        <loc>http://example.com/images/image2.jpg</loc>
        <loc>http://example.com/images/image3.jpg</loc>
      </photos_urls>  

      <videos_urls>
        <loc>http://example.com/videos/video1.avi</loc>
        <loc>http://example.com/videos/video2.avi</loc>
      </videos_urls>  

      <options>
        <option_item>
          <option_id>40</option_id>
          <option_value></option_value>
        </option_item>  
        <option_item>
          <option_id>46</option_id>
          <option_value></option_value>
        </option_item>  
        <option_item>
          <option_id>48</option_id>
          <option_value></option_value>
        </option_item>  
        <option_item>
          <option_id>49</option_id>
          <option_value></option_value>
        </option_item>  
      </options>  

      <description>Здание офисн., развл., 
        гост. назначения, общ.пл. 900 кв.м., 3/3 эт., h=3, 
        отличное сост., 10 сот.; возможное прим.: офис, представит., 
        банк; отдельностоящее с ремонтом 
      </description>
   
    </realty>  

  </realties>

Sitemap должен:

• Начинаться открывающим тегом <realties> и заканчиваться закрывающим тегом </realties>.
• Включать запись <realty>; для каждого обїявления как родительский тег XML.
• Включать дочерние тэги <email>, <type_ob_id>, <type_realty_id>, <obl_id>, <city_id> <all_sq>, <price>, <publish_weeks> для каждого родительского тэга <url>.

Определения тегов XML:

Ниже описаны доступные теги XML.

Маскирование символов

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

Местоположение Вашего DOM.ria.ua XML может быть задано в виде URL и соответсвовать RFC 2396 (http://www.ietf.org/rfc/rfc2396.txt), например: http://mySite.com/dom.xml или http://mySite.com/myPath/myScript.php?param1=value1, файл будет сканироваться с частотой, оговоренной с администрацией сайта.

DOM.ria.ua использует схему XML для определения элементов и атрибутов, которые могут появляться в Вашем файле DOM.ria.ua XML. Эту схему можно загрузить с помощью приведенных ниже ссылок:

DOM.ria.ua XML: dom.xsd

Ряд инструментальных средств может помочь при проверке структуры Вашего DOM.ria.ua XML на основе его схемы. Вы можете найти список относящихся к XML инструментальных средств в каждом из следующих местоположений:

http://www.w3.org/XML/Schema#Tools
http://www.xml.com/pub/a/2000/12/13/schematools.html

Для проверки Вашего DOM.ria.ua XML по этой схеме в файле XML должны быть дополнительные заголовки. Заголовок в файле XML должен выглядеть так, как это показано в примерах ниже.

<?xml version='1.0' encoding='UTF-8'?>
  <realties xmlns="http://www.xml.ria.ua/schemas/dom/0.1" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
	xsi:schemaLocation="http://www.xml.ria.ua/schemas/dom/0.1 
	http://www.xml.ria.ua/schemas/dom/0.1/dom.xsd">

Если Вы отправили DOM.ria.ua XML, который создан в соответствии с этим протоколом, и получили сообщение об ошибке разбора или другой ошибке, относящейся к протоколу, выполните проверку своего DOM.ria.ua XML по схеме XML. Обычно можно получить дополнительную информацию о конкретных проблемах с файлом DOM.ria.ua XML в процессе проверки.

Если при отправке Вашего DOM.ria.ua XML Вы получили сообщение о том, что DOM.ria.ua не может извлеч некоторые из Ваших объявлений, убедитесь, что правильно установлена кодировка и маскирование для содержания.