ნაცნობობა
მოგესალმებით ევროპული უძრავი ქონება 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-2 | Spain 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>წელი, როდესაც ქონება აშენდა.
<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>თქვენს ვებსაიტზე განთავსებული ქონების ბმული, შეფუთული <en> ელემენტი.
<url>
<en>https://example.com/property/123456</en>
</url>მედია
ქონების სურათები. პირველი სურათი არის გარეკანი. თითო განცხადებაში ინახება მაქსიმუმ 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 (Matterport, iGuide და მსგავსი).
<virtual_tour_url>https://my.matterport.com/show/?m=XXXXX</virtual_tour_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> ველი. შესაბამისობა არ არის მგრძნობიარე რეგისტრისა და დიდი ასოების მიმართ.
ბინები
ვილა
ტაუნ ჰაუსები
სოფლის სახლები
მიწა და ნანგრევები
Კომერციული საკუთრება
სხვა
მახასიათებლების სია
მიუთითეთ მხოლოდ ის მახასიათებლები, რომლებიც თქვენს ქონებას ეხება, ერთი <feature> თითოეული ელემენტი. გამოიყენეთ ეს სახელები; შესაბამისობა არ არის მგრძნობიარე რეგისტრისა და დიდი/დიდი რგოლის მიმართ.
სწორია:
<feature>Swimming Pool</feature>
იგნორირებულია:
<feature>swimming_pool</feature>მხარდაჭერილი ქვეყნები
გამოიყენეთ ქვეყნის სახელი <country> ველი, ან ISO 3166-1 ალფა-2 კოდი.
| ქვეყანა | ISO | ქვეყანა | ISO |
|---|---|---|---|
| Albania | AL | ლატვიის | LV |
| ავსტრიაში | AT | ლიტვის | LT |
| ბელგია | BE | ლუქსემბურგში | LU |
| ბოსნია და ჰერცოგოვინა | BA | Malta | MT |
| Bulgaria | BG | მოლდოვა | MD |
| ხორვატია | HR | Montenegro | ME |
| კვიპროსი | CY | ნორვეგია | არა |
| ჩეხეთი | CZ | პოლონეთი | PL |
| დანია | DK | Portugal | PT |
| ესტონეთი | EE | რუმინეთი | RO |
| ფინეთი | FI | სერბეთი | RS |
| France | FR | სლოვაკეთი | SK |
| საქართველო | GE | სლოვენია | SI |
| გერმანია | DE | ესპანეთი | ES |
| Greece | GR | შვედეთი | SE |
| უნგრეთი | HU | შვეიცარიაში | CH |
| ისლანდიის | IS | ნიდერლანდები | NL |
| Ireland | IE | გაერთიანებული სამეფო | GB |
| იტალიაში | IT |
სიმბოლოების კოდირება
თქვენი არხი უნდა იყოს UTF-8 კოდირებულიტექსტის კონტენტში სპეციალური სიმბოლოები სწორად უნდა იყოს გამოყოფილი:
| ხასიათი | პირი | გამოყენება |
|---|---|---|
| < | < | ნაკლები |
| > | > | Უფრო მეტი ვიდრე |
| & | & | Ampersand |
| " | " | ორმაგი ბრჭყალი (საჭიროა მხოლოდ ატრიბუტის შიგნით) |
| ' | ' | აპოსტროფი (საჭიროა მხოლოდ ატრიბუტის შიგნით) |
✅ სწორია <en>Property with pool & garden</en>
❌ არასწორია <en>Property with pool & garden</en>
თქვენი არხის ტესტირება
ნაბიჯი 1: XML სტრუქტურის ვალიდაცია
გაგზავნამდე შეამოწმეთ თქვენი არხი XML ვალიდატორით:
- W3C მარკირების ვალიდაციის სერვისი
- XMLValidation.com
- თანამედროვე ბრაუზერების უმეტესობა (გახსენით XML ფაილი პირდაპირ)
ნაბიჯი 2: შეამოწმეთ სიმბოლოების კოდირება
დარწმუნდით, რომ თქვენი არხი სწორად არის კოდირებული UTF-8-ში:
ნაბიჯი 3: სავალდებულო ველების შემოწმება
ყველა ქონებას სჭირდება შემდეგი ელემენტები:
<id>— უნიკალური ქონების ID<price>— ქონების ფასი<price_freq>— გაყიდვა ან გაქირავება<type>— ქონების ტიპი<country>— ქვეყანა<town>— ქალაქი ან დაბა<desc><en>— ქონების აღწერა
განახლებების ავტომატიზაცია
თქვენი არხის დამტკიცების შემდეგ, ჩვენი სისტემა ავტომატურად სინქრონიზაციას გაუკეთებს თქვენს თვისებებს ყოველ ღამე.
სინქრონიზაციის გრაფიკი
- არხები ავტომატურად მუშავდება ყოველ 24 საათი
- დამუშავება იწყება შემდეგ 01:00 ც და გრძელდება დილამდე
- დიდი რაოდენობით საკვების დამუშავებას შესაძლოა მეტი დრო დასჭირდეს
საუკეთესო პრაქტიკა
- ყოველთვის ჩართეთ ყველა აქტიური თვისება თქვენს არხში
- შეინახეთ
<id>ქონების სტაბილურობა მთელი სიცოცხლის განმავლობაში - გაგზავნა მდე სურათების სურათი თითო ქონებაზე; პირველი არის საფარი
- გაგზავნეთ აბსოლუტური სურათების URL-ები, რომლებიც ხელმისაწვდომი რჩება; სურათები მხოლოდ ერთხელ იტვირთება
- დარწმუნდით, რომ თქვენი არხის URL თანმიმდევრული და ხელმისაწვდომი რჩება
- ჩვენი გუნდის მიერ დაფიქსირებული ნებისმიერი ვალიდაციის შეცდომის მონიტორინგი
მიღება დახმარება
თუ გაქვთ შეკითხვები ან პრობლემები XML არხთან დაკავშირებით:
- ელ-ფოსტა: info@european.realestate
- Საკონტაქტო ფორმა: european.realestate/კონტაქტი
მხარდაჭერის სამსახურთან დაკავშირებისას, გთხოვთ, მიუთითოთ:
- თქვენი არხის URL
- თქვენი სააგენტოს სახელი European Real Estate-ზე
- რამდენიმე
<id>ჩართული ღირებულებები - საკითხის აღწერა
- მიღებული ნებისმიერი შეცდომის შეტყობინება