Začínáme
Vítejte Evropské nemovitosti Specifikace importu XML. Tento dokument poskytuje všechny technické podrobnosti potřebné k vytvoření feedu nemovitostí, který se integruje s naší platformou.
Zdroje pro rychlý start
Vytvořte si svůj kanál
Vytvořte si XML feed podle specifikace uvedené v tomto dokumentu. Vyplňte povinná pole pro každou vlastnost a použijte názvy prvků přesně tak, jak jsou uvedeny – prvek, který není v tomto dokumentu, se nepřečte.
Otestujte svůj feed
Ověřte strukturu XML a kódování znaků. Před odesláním použijte standardní validátor XML ke kontrole syntaktických chyb.
Odeslat na recenzi
Jakmile bude váš feed správně ověřen, odešlete URL adresu feedu našemu týmu k finální kontrole. Ověříme integraci a aktivujeme automatickou synchronizaci.
Přehled
XML feed pro evropské nemovitosti je absolutní posuv, což znamená, že by měl při každém vygenerování obsahovat všechny vaše aktivní vlastnosti.
Jak se zpracovávají nemovitosti
| Scénář | Akce |
|---|---|
Nový <id> detekována | Nemovitost je VLOŽENO jako nový inzerát |
Stávající <id> se změněnými údaji | Nemovitost je AKTUALIZOVÁNO s novými informacemi |
<id> chybí ve feedu | Nemovitost je STÁHNUTO OFFLINE po třech po sobě jdoucích synchronizacích. Nebude smazán: pokud se vrátí do kanálu, bude při další synchronizaci opět online s neporušenými obrázky a daty. |
<id> je klíčové. Platforma porovnává data každé vlastnosti při každé synchronizaci a zpracovává ta, která se změnila, takže není třeba uchovávat žádné pole s datem: ponechte
<id> stabilní a odešlete své aktuální hodnoty.Pokyny a konvence
Technické požadavky
- Všechny tagy XML MUSÍ být malými písmeny
- Krmivo MUSÍ být kódováno UTF-8
- Zalomení řádků v popisech musí používat skutečné znaky nového řádku (
\n) - Do NENÍ použití
CDATAsekce a neodesílat HTML<desc> - URL adresy musí být absolutní (včetně celých
https://předpona) - Každý účet vyžaduje jedinečnou URL adresu zdroje.
- Uzly vlastností musí být přímými potomky uzlů vlastností
<root>
Standardy datových formátů
| Typ pole | Formát | Příklad |
|---|---|---|
| Cena | Pouze čísla, žádné symboly | 250000 |
| Plocha (m²) | Číselné, metry čtvereční | 150 |
| Souřadnice GPS | Desetinné stupně | 36.5108, -4.8855 |
| Země | Název ze seznamu podporovaných zemí nebo ISO 3166-1 alpha-2 | Spain or ES |
| Rok výroby | Čtyři číslice | 2018 |
Struktura krmných kanálů
Každý feed se řídí touto základní strukturou: kořenový element s verzí formátu, následovaný jedním uzlem vlastnosti pro každou aktivní vlastnost.
<?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>Co platforma čte z feedu
| Prvek | Význam |
|---|---|
<european_realestate> | Identifikace formátu. Odeslat <feed_version>2</feed_version> |
<property> | Jedna vlastnost. Vše, co platforma ukládá, pochází z tohoto uzlu. |
Referenční informace o uzlech vlastností
Každý níže uvedený prvek patří do jednoho <property> uzel. Názvy prvků jsou přesně tak, jak jsou zde napsány.
Klíčová pole
Jedinečný identifikátor vlastnosti. Ten musí zůstat konzistentní napříč aktualizacemi kanálu: je to klíč, podle kterého platforma vyhledává shody.
<id>987654</id>Váš interní referenční kód nemovitosti. V dalších podrobnostech nabídky se zobrazuje jako „Referenční číslo“.
<ref>ABC-123</ref>Ceník
Cena nemovitosti jako číslo bez symbolů měn a oddělovačů.
<price>250000</price>Kód měny. Podporované měny: EUR, GBP, USD, CHF, PLN, CZK, HUF, RON, SEK, NOK, DKK
<currency>EUR</currency>Zda je nemovitost na prodej nebo k pronájmu a v případě pronájmu období, na které se cena vztahuje.
| Hodnota | Popis |
|---|---|
sale | Nemovitost je na prodej |
month | Nemovitost je k pronájmu, cena za měsíc |
week | Nemovitost je k pronájmu, cena za týden |
year | Nemovitost je k pronájmu, cena za rok |
<price_freq>sale</price_freq>Aktuální poloha
Země nemovitosti. Použijte název z Podporované země seznam; akceptován je také kód ISO 3166-1 alpha-2.
<country>Spain</country>Název města nebo obce, kde se nemovitost nachází.
<town>Marbella</town>Provincie, region nebo stát.
<province>Málaga</province>Poštovní směrovací číslo.
<postal_code>29600</postal_code>Další popis lokality (sousedství, urbanizace, oblast). V nabídce je uvedeno jako „Oblast“.
<location_detail>Costa del Sol</location_detail>GPS souřadnice v desetinných stupních. Obě hodnoty jsou potřeba k zobrazení mapového špendlíku.
<location>
<latitude>36.5108</latitude>
<longitude>-4.8855</longitude>
</location>Podrobnosti o nemovitosti
Typ vlastnosti. Použijte hodnotu z Typy vlastností seznam. Při porovnávání se nerozlišují velká a malá písmena.
<type>Apartment</type>Počet ložnic.
<beds>3</beds>Počet koupelen.
<baths>2</baths>Rok, kdy byla nemovitost postavena.
<year_built>2020</year_built>Zastavěná plocha a velikost pozemku v metrech čtverečních. Pozemek má smysl pouze u pozemků a nemovitostí s pozemky.
<surface_area>
<built>150</built>
<plot>500</plot>
</surface_area>Energetická náročnost, písmena A až G. Odeslat X když není k dispozici žádný certifikát.
<energy_rating>
<consumption>B</consumption>
<emissions>C</emissions>
</energy_rating>Obsah
Úplný popis nemovitosti v angličtině, zabalený v <en> element. Překlady se generují automaticky. Pro zalomení odstavců používejte skutečné znaky nového řádku, neodesílejte HTML a nepoužívejte CDATA.
<desc>
<en>Beautiful modern apartment located in the heart of Marbella.</en>
</desc>Odkaz na nemovitost na vašem webu, zabalený v <en> prvek.
<url>
<en>https://example.com/property/123456</en>
</url>Media
Obrázky nemovitosti. První obrázek je titulní. Na inzerát je možné uložit maximálně 20 obrázků. Doporučená velikost 1920x1280px, minimálně 800x600px.
<images>
<image>
<url>https://example.com/images/main.jpg</url>
</image>
<image>
<url>https://example.com/images/bedroom.jpg</url>
</image>
</images>URL adresa virtuální prohlídky (Matterport, iGuide a podobné).
<virtual_tour_url>https://my.matterport.com/show/?m=XXXXX</virtual_tour_url>URL adresa videa z nemovitosti: YouTube, Vimeo nebo přímý soubor MP4/WebM.
<video_url>https://www.youtube.com/watch?v=XXXXX</video_url>Seznam vlastností nemovitosti. Použijte názvy z Seznam VlastnostiPři hledání se nerozlišují velká a malá písmena. Odesílejte pouze ty vlastnosti, které se vztahují k danému tématu.
<features>
<feature>Swimming Pool</feature>
<feature>Sea views</feature>
<feature>Air Conditioning</feature>
</features>Typy vlastností
Použijte tyto hodnoty pro <type> pole. Při porovnávání se nerozlišují velká a malá písmena.
Apartmány
Villas
Městské domy
Venkovské domy
Země a ruiny
komerční objekt
Ostatní
Seznam Vlastnosti
Uveďte pouze vlastnosti, které se vztahují k vaší nemovitosti, jednu <feature> element pro každý prvek. Použijte tyto názvy; při porovnávání se nerozlišují velká a malá písmena.
Opravit:
<feature>Swimming Pool</feature>
Ignorováno:
<feature>swimming_pool</feature>Podporované země
Použijte název země pro <country> pole nebo kód ISO 3166-1 alpha-2.
| Země | ISO | Země | ISO |
|---|---|---|---|
| Albánie | AL | Lotyšsko | LV |
| Rakousko | AT | Litva | LT |
| Belgie | BE | Lucembursko | LU |
| Bosna a Hercegovina | BA | Malta | MT |
| Bulharsko | BG | Moldavsko | MD |
| Chorvatsko | HR | Černá Hora | ME |
| Kypr | CY | Norsko | NE |
| Česko | CZ | Polsko | PL |
| Dánsko | DK | Portugalsko | PT |
| Estonsko | EE | Rumunsko | RO |
| Finsko | FI | Srbsko | RS |
| Francie | FR | Slovensko | SK |
| Georgia | GE | Slovinsko | SI |
| Německo | DE | Španělsko | ES |
| Řecko | GR | Švédsko | SE |
| Maďarsko | HU | Švýcarsko | CH |
| Island | IS | Nizozemí | NL |
| Irsko | IE | Velká Británie | GB |
| Itálie | IT |
Kódování znaků
Váš kanál MUSÍ být kódováno UTF-8Speciální znaky v textovém obsahu musí být správně escapovány:
| Znak | bytost | Používání |
|---|---|---|
| < | < | Méně než |
| > | > | Větší než |
| & | & | ampersand |
| " | " | Dvojité uvozovky (nutné pouze uvnitř atributu) |
| ' | ' | Apostrof (potřebný pouze uvnitř atributu) |
✅ Správné <en>Property with pool & garden</en>
❌ Nesprávné <en>Property with pool & garden</en>
Testování vašeho feedu
Krok 1: Ověření struktury XML
Před odesláním ověřte svůj feed pomocí validátoru XML:
- Služba ověřování značky W3C
- XMLValidation.com
- Většina moderních prohlížečů (otevření souboru XML přímo)
Krok 2: Zkontrolujte kódování znaků
Ověřte, zda je váš feed správně kódován v UTF-8:
Krok 3: Ověřte povinná pole
Každá nemovitost potřebuje tyto prvky:
<id>— Jedinečné ID nemovitosti<price>— Cena nemovitosti<price_freq>— Prodej nebo pronájem<type>— Typ nemovitosti<country>— Země<town>— Město nebo obec<desc><en>— Popis nemovitosti
Automatizace aktualizací
Jakmile je váš feed schválen, náš systém každou noc automaticky synchronizuje vaše vlastnosti.
Plán synchronizace
- Feedy se zpracovávají automaticky každých 24 hodin
- Zpracování začíná po 01:00 SEČ a pokračuje až do časného rána
- Zpracování velkých zdrojů může trvat déle
Doporučené postupy
- Vždy zahrnout VŠECHNY aktivní nemovitosti ve vašem feedu
- Udržujte
<id>nemovitosti stabilní po celou dobu její životnosti - Odeslat až do 20 obrázků na nemovitost; první je krytí
- Odesílejte absolutní URL adresy obrázků, které zůstanou dosažitelné; obrázky se stáhnou pouze jednou
- Zajistěte, aby adresa URL vašeho zdroje zůstala konzistentní a přístupná
- Sledujte případné chyby ověřování hlášené naším týmem
Získání nápovědy
Pokud máte dotazy nebo narazíte na problémy s vaším XML feedem:
- Koordinátorka: Ivana Durgarian email: info@european.realestate
- Kontaktní formulář: european.realestate/contact
Při kontaktování podpory prosím uveďte:
- URL adresa vašeho kanálu
- Název vaší agentury na European Real Estate
- Pár z
<id>hodnoty zahrnuté - Popis problému
- Veškeré přijaté chybové zprávy