Twoje ogłoszenia w Trovit Polska

Plik XML – Nieruchomości

Zaktualizowano: Jan 14, 2014 @ 12:05

Jeśli posiadasz stronę z ogłoszeniami, możesz je zawrzeć w Trovit! Wystarczą 3 proste kroki:

  1. Stwórz plik UTF-8 XML według poniższej specyfikacji.
  2. Ściągnij nasz Walidator XML i sprawdź czy plik jest poprawnie skonstruowany. Walidacja pliku XML jest ważna aby zapewnić poprawne zindeksowanie Twoich ogłoszeń.
  3. Prześlij nam URL, gdzie znajduje się XML (na przykład: http://www.twojadomena.pl/trovit_feed.xml) korzystając z naszego formularza kontaktu.

Od tego momentu, będziemy regularnie sczytywać plik XML aby indeksować nowe ogłoszenia, modyfikować ogłoszenia, w których została wprowadzona jakakolwiek zmiana oraz usuwać ogłoszenia nieaktualne, których już nie ma w pliku!

Twoje ogłoszenia zostaną wprowadzone do wyników wyszukiwania Trovit jak najszybciej możliwie!

W razie jakichkolwiek wątpliwości skontaktuj się z nami!

Format pliku XML

Poniżej znajduje się kilka wskazówek mających pomóc Tobie utworzyć plik XML, dzięki któremu zawrzesz swoje ogłoszenia w Trovit. Gdybyś potrzebował więcej informacji na temat pliku XML zajrzyj do Wikipedii.

Plik powinien posiadać kodowanie UTF-8

Plik powinien zawierać wszystkie aktualne oferty.

Plik XML powinien zawierać jeden element główny ‘trovit’, który zawiera wiele elementów ‘ad’. Z kolei każdy element ‘ad’ posiada pola zarówno obowiązkowe, jak i opcjonalne:

Skonsultuj również specyfikację techniczną pól.

POLA OBOWIĄZKOWE

Aby zawrzeć ogłoszenia w Trovit należy wypełnić wszystkie pola obowiązkowe. Dostarczają one informację zapewniającą minimalną jakość każdego ogłoszenia.

  • id: id ogłoszenia na Twojej stronie (może być numeryczny lub alfanumeryczny, ale musi być unikalny, aby uniknąć duplikatów)
  • url: URL ogłoszenia na Twojej stronie
  • title: tytuł ogłoszenia (musi być całkowicie powiązany z ogłoszeniem, nie może zawierać ani nazwy ani URL Twojej strony)
  • type: rodzaj ogłoszenia:
    • “For Rent”: wynajem domu lub mieszkania
    • “For Sale”: sprzedaż domu lub mieszkania
    • “Roommate”: wynajem pokoi
    • “Office For Rent”: wynajem biura
    • “Office For Sale”: sprzedaż biura
    • “Land For Sale”: działka na sprzedaż
    • “For Rent Local”: wynajem lokalu użytkowego/handlowego
    • “For Sale Local”: sprzedaż lokalu użytkowego/handlowego
    • “Warehouse For Rent”: wynajem magazynu
    • “Warehouse For Sale”: sprzedaż magazynu
  • content: opis nieruchomości (minimum 30 znaków). Pamiętaj, że im dokładniejszy opis tym chętniej czytany!
  • date: data ogłoszenia, akceptowane formaty: DD/MM/RRRR, DD/MM/RRRR HH:MM:SS, RRRR/MM/DD lub RRRR/MM/DD HH:MM:SS

Skonsultuj również specyfikację techniczną pól.

POLA OPCJONALNE

Pola opcjonalne, jak sama nazwa wskazuje, nie są obowiązkowe. Jednak, jeśli pola te pojawiają się na Twojej stronie najlepiej umieścić je również w pliku. Algorytm Trovit, ustalający kolejność pojawiania się ogłoszeń, bierze pod uwagę także ich jakość, stąd im bogatsze ogłoszenie tym lepsza jego pozycja w Trovit!

  • mobile_url: URL ogłoszenia oglądane na mobilnej wersji strony (nowe)
  • price: cena; tylko liczba całkowita, bez waluty ani przecinków, kropek i spacji. Dla ofert wynajmu można sprecyzować okres wynajmu, dla którego podana jest cena (wartość domyślna to miesiąc). Należy wtedy wybrać jedną z wartości: monthly, weekly, daily w sposób następujący:
    <price period="weekly"><![CDATA[...]]></price>

    Jeśli cena podana jest w walucie innej niż PLN należy również użyć atrybut waluty. W ten sposób Trovit będzie mógł zastosować przelicznik na PLN.

    <price period="weekly" currency="USD"><![CDATA[...]]></price>

    W ten sposób został określony koszt wynajmu za tydzień w dolarach w Polsce. Trovit przeliczy to na koszt miesięczny w PLN.

  • region: województwo
  • city: miasto
  • city_area: dzielnica
  • postcode: kod pocztowy
  • property_type: Jedno z: mieszkanie, dom, wolnostojący, bliźniak, kawalerka, segment, apartament, dwupoziomowe lub willa. Dotyczy jedynie ogłoszeń typu “For Sale” i “For Rent”.
  • floor_area: powierzchnia nieruchomości (liczba całkowita). Jeśli powierzchnia podana jest w innej jednostce niż metry kwadratowe można wskazać to w następujący sposób:
    <floor_area unit="feet"><![CDATA[...]]></floor_area>

    Możliwe jednostki to: “meters”, “feet”, “acres”, “hectares”

  • rooms: liczba pokoi
  • bathrooms: liczba łazienek
  • address: adres
  • year : rok budowy w formacie RRRR
  • latitude: szerokość geograficzna
  • longitude: długość geograficzna
  • agency: nazwa agencji
  • virtual_tour (nowe): URL’e wirtualnej wizyty nieruchomości
  • floor_number: piętro
  • plot_area (nowe): powierzchnia działki, na której znajduje się nieruchomość (liczba całkowita)
  • orientation : położenie nieruchomości: północ, południe, wschód lub zachód
  • is_furnished: czy nieruchomość jest umeblowana (0 = Nie, 1 = Tak)
  • parking: 0 jeśli brak parkingu, 1 jeśli jest parking
  • is_new: 0 dla rynku wtórnego, 1 dla rynku pierwotnego
  • expiration_date: data wygaśnięcia ogłoszenia, akceptowane formaty: DD/MM/RRRR, DD/MM/RRRR HH:MM:SS, RRRR/MM/DD lub RRRR/MM/DD HH:MM:SS
  • condition : na przykład “ostatnio odnowione”
  • by_owner : 1 dla nieruchomości oferowanej przez osobę prywatną. Nie trzeba wypełniać tego pola dla nieruchomości oferowanych przez agencje.
    Jeśli nieruchomość oferowana jest przez agencję nie trzeba wpisywać zera, należy po prostu pominąć to pole.
  • eco_score: informacja o zużyciu energii (wolny tekst)
  • is_rent_to_own: jeśli jest to nieruchomość na wynajem z opcją kupna
  • pictures: W tym polu zawarte są zdjęcia nieruchomości. Pole to może zawierać jedno lub więcej elementów ‘picture’.
    • picture: Pole to zawiera URL i tytuł zdjęcia (tytuł jest opcjonalny). Możesz określić, które zdjęcie ma być zdjęciem głównych korzystając z atrybutu ‘featured’ w sposób następujący:
              <picture featured="true"><![CDATA[...]]></picture>

      Należy wpisać jedną z dwóch wartości: “true” lub “false

      Pole ‘picture’ zawiera następujące 2 elementy:

      • picture_url: URL zdjęcia na twojej stronie
      • picture_title: tytuł zdjęcia
      <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>

      Pierwsze zdjęcie ogłoszenia będzie pokazywane w Trovit.
      Wybierz zdjęcie, które wzbudzi największe zainteresowanie!

      Trovit nie akceptuje zdjęć z logiem firmy z napisem “brak zdjęcia”. Jeśli zostanie wykryte takie zdjęcie Trovit może nie zindeksować danego ogłoszenia.

      Zdjęcia powinny posiadać minimum 186×186 px oraz nie przekraczać 1MB.

      Po zindeksowaniu danego ogłoszenia jego zdjęcie nie może już zostać zmienione. Dlatego upewnij się, że ogłoszenia zawierają poprawne zdjęcia.

Plik XML powinien wyglądać w następujący sposób:

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

<ad>
    <id><![CDATA[...]]></id>
    <url><![CDATA[...]]></url>
    <mobile_url><![CDATA[...]]></mobile_url>
    <title><![CDATA[...]]></title>
    <type><![CDATA[...]]></type>
    <date><![CDATA[...]]></date>
    <agency><![CDATA[...]]></agency>
    <content><![CDATA[...]]></content>

    <price><![CDATA[...]]></price>

    <property_type><![CDATA[...]]></property_type>

    <floor_area unit="feet"><![CDATA[...]]></floor_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <parking><![CDATA[...]]></parking>
    <address><![CDATA[...]]></address>
    <city><![CDATA[...]]></city>
    <city_area><![CDATA[...]]></city_area>
    <postcode><![CDATA[...]]></postcode>
    <region><![CDATA[...]]></region>
    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>
    <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>

    <virtual_tour><![CDATA[...]]></virtual_tour>

</ad>

<ad>
    ....
</ad>

<ad>
    ....
</ad>

...

</trovit>

Przykład pliku XML

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
	<id><![CDATA[7004578]]></id>
	<url><![CDATA[http://www.twojadomena.pl/ad/7004578]]></url>
        <mobiel_url><![CDATA[http://www.m.twojadomena.pl/ad/7004578]]></mobile_url>
	<title><![CDATA[Mieszkanie 62m2, Warszawa, Mokotów]]></title>
	<type><![CDATA[For Rent]]></type>

	<agency><![CDATA[Agencja Nieruchomości AAA]]></agency>
	<content><![CDATA[Mieszkanie 3-pokojowe z balkonem 7m2, odnowione, jasna kuchnia. ]]></content>
        <date><![CDATA[10/08/2012 13:50:00]]></date>
	<price><![CDATA[2900]]></price>

	<property_type><![CDATA[Mieszkanie]]></property_type>
	<floor_area unit="meters"><![CDATA[62]]></floor_area>
	<rooms><![CDATA[3]]></rooms>

	<bathrooms><![CDATA[1]]></bathrooms>
	<parking><![CDATA[0]]></parking>

	<address><![CDATA[ul. Szarotki]]></address>
	<city><![CDATA[Warszawa]]></city>

	<city_area><![CDATA[Mokotów]]></city_area>
	<postcode><![CDATA[02-609]]></postcode>
	<region><![CDATA[Mazowieckie]]></region>

	<latitude><![CDATA[41.409583]]></latitude>

	<longitude><![CDATA[2.187223]]></longitude>

	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.twojadomena.pl/zdjecie.jpg]]></picture_url>
			<picture_title><![CDATA[salon]]></picture_title>
		</picture>
	</pictures>

</ad>

<ad>
	<id><![CDATA[332A53BC2]]></id>
	<url><![CDATA[CDATA[http://www.twojadomena.pl/ad/332A53BC2]]></url>
        <mobile_url><![CDATA[CDATA[http://www.m.twojadomena.pl/ad/332A53BC2]]></mobile_url>
	<title><![CDATA[Sprzedam dom 170m2, Wieliczka]]></title>

	<type><![CDATA[For Sale]]></type>
	<content><![CDATA[Przestronny dom w spokojnej okolicy, wybudowany w 2005 roku.]]></content>
        <date><![CDATA[15/11/2012 17:30:00]]></date>
	<price><![CDATA[640000]]></price>

	<address><![CDATA[ul. Orzechowa]]></address>
	<city><![CDATA[Wieliczka]]></city>
	<postcode><![CDATA[32-020]]></postcode>
	<region><![CDATA[Małopolskie]]></region>

	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.twojadomena.pl/zdjecie1123.jpg]]></picture_url>
			<picture_title><![CDATA[salon]]></picture_title>

		</picture>
	</pictures>

</ad>
</trovit>

Specyfikacja techniczna

Jeśli potrzebujesz więcej informacji, skonsultuj specyfikację techniczną pól.