ძებნა

ნაცნობობა

მოგესალმებით ევროპული უძრავი ქონება XML იმპორტის სპეციფიკაცია. ეს დოკუმენტი შეიცავს ყველა ტექნიკურ დეტალს, რომელიც გჭირდებათ ჩვენს პლატფორმასთან ინტეგრირებული თვისებების არხის შესაქმნელად.

სწრაფი დაწყების რესურსები

შექმენით თქვენი არხი

შექმენით თქვენი XML არხი ამ დოკუმენტში მოცემული სპეციფიკაციის შესაბამისად. შეავსეთ თითოეული თვისებისთვის აუცილებელი ველები და გამოიყენეთ ელემენტების სახელები ზუსტად ისე, როგორც ჩამოთვლილია - ელემენტი, რომელიც ამ დოკუმენტში არ არის, არ იკითხება.

შეამოწმეთ თქვენი არხი

შეამოწმეთ თქვენი XML სტრუქტურა და სიმბოლოების კოდირება. გაგზავნამდე გამოიყენეთ სტანდარტული XML ვალიდატორი სინტაქსური შეცდომების შესამოწმებლად.

გაგზავნეთ განსახილველად

როგორც კი თქვენი არხი სწორად დადასტურდება, გაუგზავნეთ არხის URL ჩვენს გუნდს საბოლოო განხილვისთვის. ჩვენ დავადასტურებთ ინტეგრაციას და გავააქტიურებთ თქვენს ავტომატურ სინქრონიზაციას.

მიმოხილვა

ევროპული უძრავი ქონების XML არხი არის აბსოლუტური საკვები, რაც ნიშნავს, რომ ის უნდა შეიცავდეს თქვენს ყველა აქტიურ თვისებას ყოველი გენერირებისას.

⚠️ მნიშვნელოვანია: საკვების აბსოლუტური წესი თქვენი არხი უნდა შეიცავდეს ყველა აქტიურ თვისებას. პლატფორმა ოფლაინში არმყოფ თვისებას ხსნის, ამიტომ არასრული არხი საიტიდან ჩამონათვალს აქრობს.

როგორ ხდება თვისებების დამუშავება

სცენარიაქცია
ახალი <id> გამოვლინდაქონება არის ჩასმული როგორც ახალი ჩამონათვალი
არსებული <id> შეცვლილი მონაცემებითქონება არის სიახლეები ახალი ინფორმაციით
<id> არხიდან აკლიაქონება არის ოფლაინიდან გადაღებული სამი ზედიზედ სინქრონიზაციის შემდეგ. ის არ იშლება: თუ ის არხზე დაბრუნდება, შემდეგი სინქრონიზაციის შემდეგ ის კვლავ ონლაინ რეჟიმში დაბრუნდება, მისი სურათებითა და მონაცემებით ხელუხლებელი.
💡 რჩევა ის <id> არის გასაღები. პლატფორმა ადარებს ყველა სინქრონიზაციის ყველა თვისების მონაცემებს და ამუშავებს შეცვლილ მონაცემებს, ამიტომ არ არსებობს თარიღის ველი შესანარჩუნებლად: შეინახეთ <id> სტაბილური და გაგზავნეთ თქვენი მიმდინარე მნიშვნელობები.

სახელმძღვანელო პრინციპები და კონვენციები

ტექნიკური მოთხოვნები

  • ყველა XML თეგი უნდა იყოს პატარა ასოებით
  • არხი უნდა იყოს UTF-8 კოდირებული
  • აღწერილობაში ხაზის გადასვლები უნდა იყენებდეს რეალურ ახალი ხაზის სიმბოლოებს (\n)
  • Do არა გამოყენება CDATA სექციები და არ გაგზავნოთ HTML <desc>
  • URL-ები უნდა იყოს აბსოლუტური (მოიცავდეს სრულ URL-ებს) https:// პრეფიქსი)
  • თითოეულ ანგარიშს სჭირდება უნიკალური არხის URL
  • ქონების კვანძები უნდა იყოს პირდაპირი შვილები <root>

მონაცემთა ფორმატის სტანდარტები

ველის ტიპიფორმატიმაგალითი
ფასიმხოლოდ რიცხვითი, სიმბოლოების გარეშე250000
ფართობი (მ²)რიცხვითი, კვადრატული მეტრი150
GPS კოორდინატებიათწილადი გრადუსები36.5108, -4.8855
ქვეყანასახელი მხარდაჭერილი ქვეყნების სიიდან ან ISO 3166-1 alpha-2Spain or ES
წელიოთხი ციფრი2018

საკვების სტრუქტურა

ყველა არხი მიჰყვება ამ ძირითად სტრუქტურას: ფორმატის ვერსიის მქონე root ელემენტი, რომელსაც მოჰყვება თითოეული აქტიური თვისების ერთი თვისების კვანძი.

<?xml version="1.0" encoding="UTF-8"?>
<root>

<european_realestate>
<feed_version>2</feed_version>
</european_realestate>

<property>
<!-- Property 1 fields... -->
</property>

<property>
<!-- Property 2 fields... -->
</property>

<!-- Additional properties... -->

</root>

რას კითხულობს პლატფორმა არხიდან

Elementრაც იმას ნიშნავს,
<european_realestate>ფორმატის იდენტიფიკაცია. გაგზავნა <feed_version>2</feed_version>
<property>ერთი თვისება. ყველაფერი, რასაც პლატფორმა ინახავს, ​​ამ კვანძიდან მოდის.
💡 სააგენტოს დეტალები თქვენი სააგენტოს სახელი, ლოგო, საკონტაქტო ინფორმაცია და თქვენს არხსა და თქვენს ანგარიშს შორის ბმული ჩვენს მიერ რეგისტრირდება თითოეული არხით. ისინი არ იკითხება არხიდან, ამიტომ ფაილში არაფერია გასაგზავნი და არაფერია განახლებული. გამოგვიგზავნეთ შეტყობინება, როდესაც თქვენი სააგენტოს მონაცემები შეიცვლება.

თვისებების კვანძების მითითება

ქვემოთ მოცემული ყველა ელემენტი ერთ ელემენტშია მოთავსებული <property> კვანძი. ელემენტების სახელები ზუსტად ისეა, როგორც აქ არის დაწერილი.

ძირითადი ველები

საჭირო ტიპი: სტრიქონი/მთელი რიცხვი

ქონების უნიკალური იდენტიფიკატორი. ეს უნდა დარჩეს თანმიმდევრული არხის განახლებებში: ეს არის გასაღები, რომელსაც პლატფორმა ემთხვევა.

<id>987654</id>

პირობითი ტიპი: სიმებიანი

თქვენი შიდა ქონების საცნობარო კოდი. სიის დამატებით დეტალებში ნაჩვენებია, როგორც „საცნობარო“.

<ref>ABC-123</ref>

ფასები

საჭირო ტიპი: მთელი რიცხვი

ქონების ფასი რიცხვის სახით, ვალუტის სიმბოლოების ან გამყოფების გარეშე.

<price>250000</price>

პირობითი ტიპი: სიმებიანი ნაგულისხმევი: ევრო

ვალუტის კოდი. მხარდაჭერილია: EUR, GBP, USD, CHF, PLN, CZK, HUF, RON, SEK, NOK, DKK

<currency>EUR</currency>

საჭირო ტიპი: ნუმერაცია

იყიდება თუ ქირავდება ქონება, ხოლო ქირავდება შემთხვევაში - პერიოდი, რომელზეც ფასი ვრცელდება.

ღირებულებააღწერა
saleქონება იყიდება
monthქონება გაქირავებულია, ფასი თვეში
weekქონება გაქირავებულია, ფასი კვირაში
yearქონება გაქირავებულია, ფასი წელიწადში
<price_freq>sale</price_freq>

მდებარეობა

საჭირო ტიპი: სიმებიანი

ქონების ქვეყანა. გამოიყენეთ სახელი მხარდაჭერილი ქვეყნები სია; ასევე მიიღება ISO 3166-1 ალფა-2 კოდი.

<country>Spain</country>

საჭირო ტიპი: სიმებიანი

ქალაქის ან დაბის დასახელება, სადაც ქონება მდებარეობს.

<town>Marbella</town>

პირობითი ტიპი: სიმებიანი

პროვინცია, რეგიონი ან შტატი.

<province>Málaga</province>

პირობითი ტიპი: სიმებიანი

საფოსტო ინდექსი.

<postal_code>29600</postal_code>

პირობითი ტიპი: სიმებიანი

დამატებითი ადგილმდებარეობის აღწერა (სამეზობლო, ურბანიზაცია, ტერიტორია). სიაში ნაჩვენებია, როგორც „ტერიტორია“.

<location_detail>Costa del Sol</location_detail>

პირობითი ტიპი: კონტეინერი

GPS კოორდინატები ათობით გრადუსებში. რუკაზე პინის გამოსაჩენად ორივე მნიშვნელობაა საჭირო.

<location>
<latitude>36.5108</latitude>
<longitude>-4.8855</longitude>
</location>

ქონების დეტალები

საჭირო ტიპი: ნუმერაცია

თვისების ტიპი. გამოიყენეთ მნიშვნელობა ქონების ტიპები სია. შესაბამისობისას რეგისტრისა და რეგისტრის მიმართ მგრძნობიარე არ არის.

<type>Apartment</type>

პირობითი ტიპი: მთელი რიცხვი

საძინებლების რაოდენობა.

<beds>3</beds>

პირობითი ტიპი: მთელი რიცხვი

სველი წერტილების რაოდენობა.

<baths>2</baths>

პირობითი ტიპი: მთელი რიცხვი (4 ციფრი)

წელი, როდესაც ქონება აშენდა.

<year_built>2020</year_built>

პირობითი ტიპი: კონტეინერი

აშენებული ფართობი და ნაკვეთის ფართობი კვადრატულ მეტრებში. ნაკვეთი მხოლოდ მიწის ნაკვეთისთვის და მიწის ნაკვეთით აღჭურვილი ქონებისთვისაა აზრიანი.

<surface_area>
<built>150</built>
<plot>500</plot>
</surface_area>

პირობითი ტიპი: კონტეინერი

ენერგოეფექტურობის რეიტინგები, ასოები A-დან G-მდე. გაგზავნა X როდესაც სერტიფიკატი არ არის ხელმისაწვდომი.

<energy_rating>
<consumption>B</consumption>
<emissions>C</emissions>
</energy_rating>

Content

საჭირო ტიპი: სიმებიანი

ქონების სრული აღწერა ინგლისურ ენაზე, შეფუთული ფორმატში <en> ელემენტი. თარგმანები ავტომატურად გენერირდება. აბზაცის გადასვლისთვის გამოიყენეთ რეალური ახალი ხაზები, არ გაგზავნოთ HTML და არ გამოიყენოთ CDATA.

<desc>
<en>Beautiful modern apartment located in the heart of Marbella.</en>
</desc>

პირობითი ტიპი: URL

თქვენს ვებსაიტზე განთავსებული ქონების ბმული, შეფუთული <en> ელემენტი.

<url>
<en>https://example.com/property/123456</en>
</url>

მედია

პირობითი მაქს: 20 სურათი

ქონების სურათები. პირველი სურათი არის გარეკანი. თითო განცხადებაში ინახება მაქსიმუმ 20 სურათი. რეკომენდებული ზომაა 1920x1280 პიქსელი, მინიმუმ 800x600 პიქსელი.

<images>
<image>
<url>https://example.com/images/main.jpg</url>
</image>
<image>
<url>https://example.com/images/bedroom.jpg</url>
</image>
</images>

პირობითი ტიპი: URL

ვირტუალური ტურის URL (Matterport, iGuide და მსგავსი).

<virtual_tour_url>https://my.matterport.com/show/?m=XXXXX</virtual_tour_url>

პირობითი ტიპი: URL

ქონების ვიდეოს URL: YouTube, Vimeo ან პირდაპირი MP4/WebM ფაილი.

<video_url>https://www.youtube.com/watch?v=XXXXX</video_url>

პირობითი ტიპი: კონტეინერი

ქონების მახასიათებლების სია. გამოიყენეთ სახელები მახასიათებლების სიაშესაბამისობა არ არის მგრძნობიარე რეგისტრისა და რეგისტრის მიმართ. გაგზავნეთ მხოლოდ შესაბამისი ფუნქციები.

<features>
<feature>Swimming Pool</feature>
<feature>Sea views</feature>
<feature>Air Conditioning</feature>
</features>

ქონების ტიპები

გამოიყენეთ ეს მნიშვნელობები <type> ველი. შესაბამისობა არ არის მგრძნობიარე რეგისტრისა და დიდი ასოების მიმართ.

ბინები

ბინა
Penthouse
სტუდია
Duplex
ტრიპლექსი
თაუნჰაუსი

ვილა

ვილა
ბუნგალო
ცალკე სახლი

ტაუნ ჰაუსები

Ქალაქის სახლი
ნახევრად იზოლირებული სახლი
Ტერასიანი სახლი
სოფლის სახლი

სოფლის სახლები

Chalet
შატო
ფერმა
ფინკა
მეურნეობა
მეურნეობა
Აგარაკი
გამოქვაბულის სახლი

მიწა და ნანგრევები

მიწის ნაკვეთი
ისლანდიის
Ruin

Კომერციული საკუთრება

Business
Კომერციული საკუთრება
კომპლექსი
სასტუმრო
მაღაზია

სხვა

საწყისი
Ავტოსადგომი
💡 რჩევა გაგზავნეთ თვისების ტიპი ისე, როგორც ის უნდა გამოჩნდეს სიაში. თუ იყენებთ მნიშვნელობას, რომელიც ამ სიაში არ არის, სია გამოქვეყნდება თვისების ტიპის გარეშე.

მახასიათებლების სია

მიუთითეთ მხოლოდ ის მახასიათებლები, რომლებიც თქვენს ქონებას ეხება, ერთი <feature> თითოეული ელემენტი. გამოიყენეთ ეს სახელები; შესაბამისობა არ არის მგრძნობიარე რეგისტრისა და დიდი/დიდი რგოლის მიმართ.

ხელმისაწვდომი ქონება
ჰაერის კონდიცირება
მწვადი
სარდაფი
ლიფტი
დამონტაჟებული კარადები
კეთილმოწყობილი
ავტოსადგომი
ეზო
სპორტ - დარბაზი
ინტერნეტი
სამრეცხაო
Lawn
ქსელის გარეთ
გარე საშხაპე
პარკინგი
Სატელეფონო ხაზი
საუნა
ზღვის ხედები
შენახვის ოთახი
საცურაო აუზი
ტერასა
სატელევიზიო საკაბელო
WiFi
ფანჯრის მოპირკეთება
⚠️ გამოაგზავნეთ ეს სახელები და არა კოდები ზემოთ მოცემული სახელები ჩვენი პლატფორმის ფუნქციებია. მნიშვნელობა, რომელიც ამ სიაში არ არის, იგნორირებულია, ამიტომ ის სიაში არ ჩანს.
სწორია: <feature>Swimming Pool</feature>
იგნორირებულია: <feature>swimming_pool</feature>

მხარდაჭერილი ქვეყნები

გამოიყენეთ ქვეყნის სახელი <country> ველი, ან ISO 3166-1 ალფა-2 კოდი.

ქვეყანაISOქვეყანაISO
AlbaniaALლატვიისLV
ავსტრიაშიATლიტვისLT
ბელგიაBEლუქსემბურგშიLU
ბოსნია და ჰერცოგოვინაBAMaltaMT
BulgariaBGმოლდოვაMD
ხორვატიაHRMontenegroME
კვიპროსიCYნორვეგიაარა
ჩეხეთიCZპოლონეთიPL
დანიაDKPortugalPT
ესტონეთიEEრუმინეთიRO
ფინეთიFIსერბეთიRS
FranceFRსლოვაკეთიSK
საქართველოGEსლოვენიაSI
გერმანიაDEესპანეთიES
GreeceGRშვედეთიSE
უნგრეთიHUშვეიცარიაშიCH
ისლანდიისISნიდერლანდებიNL
IrelandIEგაერთიანებული სამეფოGB
იტალიაშიIT

სიმბოლოების კოდირება

თქვენი არხი უნდა იყოს UTF-8 კოდირებულიტექსტის კონტენტში სპეციალური სიმბოლოები სწორად უნდა იყოს გამოყოფილი:

ხასიათიპირიგამოყენება
<&lt;ნაკლები
>&gt;Უფრო მეტი ვიდრე
&&amp;Ampersand
"&quot;ორმაგი ბრჭყალი (საჭიროა მხოლოდ ატრიბუტის შიგნით)
'&apos;აპოსტროფი (საჭიროა მხოლოდ ატრიბუტის შიგნით)

✅ სწორია <en>Property with pool &amp; garden</en>

❌ არასწორია <en>Property with pool & garden</en>

თქვენი არხის ტესტირება

ნაბიჯი 1: XML სტრუქტურის ვალიდაცია

გაგზავნამდე შეამოწმეთ თქვენი არხი XML ვალიდატორით:

ნაბიჯი 2: შეამოწმეთ სიმბოლოების კოდირება

დარწმუნდით, რომ თქვენი არხი სწორად არის კოდირებული UTF-8-ში:

ნაბიჯი 3: სავალდებულო ველების შემოწმება

ყველა ქონებას სჭირდება შემდეგი ელემენტები:

  • <id> — უნიკალური ქონების ID
  • <price> — ქონების ფასი
  • <price_freq> — გაყიდვა ან გაქირავება
  • <type> — ქონების ტიპი
  • <country> — ქვეყანა
  • <town> — ქალაქი ან დაბა
  • <desc><en> — ქონების აღწერა
💡 როგორ ხდება განცხადება გამოქვეყნებული ახალი განცხადებები იქმნება მონახაზის სახით და ავტომატურად ქვეყნდება, როგორც კი მათი სურათები ხელმისაწვდომი გახდება ჩვენს მედია საცავში. განცხადებები სურათების გარეშე ქვეყნდება დაუყოვნებლივ. სურათების დამუშავება, როგორც წესი, პირველი სინქრონიზებიდან 24 საათის განმავლობაში მთავრდება და განცხადებები მაინც გამოქვეყნდება 48 საათის შემდეგ.

განახლებების ავტომატიზაცია

თქვენი არხის დამტკიცების შემდეგ, ჩვენი სისტემა ავტომატურად სინქრონიზაციას გაუკეთებს თქვენს თვისებებს ყოველ ღამე.

სინქრონიზაციის გრაფიკი

  • არხები ავტომატურად მუშავდება ყოველ 24 საათი
  • დამუშავება იწყება შემდეგ 01:00 ც და გრძელდება დილამდე
  • დიდი რაოდენობით საკვების დამუშავებას შესაძლოა მეტი დრო დასჭირდეს

საუკეთესო პრაქტიკა

  • ყოველთვის ჩართეთ ყველა აქტიური თვისება თქვენს არხში
  • შეინახეთ <id> ქონების სტაბილურობა მთელი სიცოცხლის განმავლობაში
  • გაგზავნა მდე სურათების სურათი თითო ქონებაზე; პირველი არის საფარი
  • გაგზავნეთ აბსოლუტური სურათების URL-ები, რომლებიც ხელმისაწვდომი რჩება; სურათები მხოლოდ ერთხელ იტვირთება
  • დარწმუნდით, რომ თქვენი არხის URL თანმიმდევრული და ხელმისაწვდომი რჩება
  • ჩვენი გუნდის მიერ დაფიქსირებული ნებისმიერი ვალიდაციის შეცდომის მონიტორინგი
⚠️ გახსოვდეთ თქვენს არხში არ არსებული ქონება სამი ზედიზედ სინქრონიზაციის შემდეგ ოფლაინიდან იხსნება და ავტომატურად ბრუნდება არხში დაბრუნებისას. პირველივე გამოტოვების შემთხვევაში თქვენი ანგარიშიდან არაფერი იშლება, მაგრამ არხში, რომელსაც რამდენიმე დღის განმავლობაში აკლია განცხადებები, ისინი საიტიდან წაიშლება.

მიღება დახმარება

თუ გაქვთ შეკითხვები ან პრობლემები XML არხთან დაკავშირებით:

მხარდაჭერის სამსახურთან დაკავშირებისას, გთხოვთ, მიუთითოთ:

  • თქვენი არხის URL
  • თქვენი სააგენტოს სახელი European Real Estate-ზე
  • რამდენიმე <id> ჩართული ღირებულებები
  • საკითხის აღწერა
  • მიღებული ნებისმიერი შეცდომის შეტყობინება