iCase.it | Standard Feed di iCase 1.0

Home Page - iCase | Visual - iCase | News - Pubblica i tuoi annunci Gratis

I Miei Preferiti - Registrati - Accedi

Standard Feed di iCase 1.0

Come funziona?

Il funzionamento è semplice se vengono seguiti questi passi:

1 leggi con attenzione le specifiche relative al file XML che dovrai realizzare e confronta l'esempio proposto;

2 tramite il linguaggio di programmazione che preferisci realizza un piccolo programma che estrapola dal tuo database gli annunci e le visualizza secondo le specifiche al "punto 1";

3 verifica la correttezza del file che hai generato tramite il nostro validatore on-line;

4 segnalaci tramite questo modulo che hai realizzato ed è disponibile un Feed XML di annunci immobiliari per iCase.it;

5 in breve tempo i tuoi annunci saranno indicizzati e ricercabili da migliaia di utenti su iCase.it!

Specifiche del Feed XML iCase 1.0

Leggere con attenzione le specifiche del Feed XML di iCase 1.0 di seguito illustrate.


feed	Questo è il nodo root e contiene tutto il Feed XML di iCase.it. Obbligatorio.

feed/version	Il numero di versione del Feed XML di iCase.it: attualmente 1.0. Obbligatorio.

feed/info	Il nodo contiene tutte le informazioni relative al feed specifico. Obbligatorio.

feed/info/publisher	Informazioni relative all'editore. Obbligatorio.

feed/info/publisher/name	Il nome dell'editore. Esempio: "Immobili & Co.". Obbligatorio.

feed/info/publisher/site	Il sito dell'editore. Esempio: "http://www.example.com/". Obbligatorio.

feed/info/publisher/email	La mail del referente del Feed XML dell'editore. Esempio: "info@example.com". Obbligatorio.

feed/info/build-date	La data relativa alla generazione di questo specifico Feed XML (non alla realizzazione del programma che genera il feed stesso) in formato RFC 2822. Esempio: "Fri, 27 Mar 2009 21:10:34 +0100" Obbligatorio.

feed/info/engine	Per iCase.it questo valore è sempre "realestate". Obbligatorio.

feed/info/multipage	Questo macro-nodo contiene informazioni relative ai feed multipagina qualora il numero degli annunci fosse molto elevato. Un Feed XML di iCase.it può infatti essere suddiviso in più feed di dimensioni inferiori. È consigliato non far superare ad un unico feed circa 1.000 annunci.

feed/info/multipage/base-url	Il nodo contiene la URL di base del feed senza il parametro che controlla il numero di pagina richiesto. Obbligatorio se presente multipage.

feed/info/multipage/page-param	Questo nodo contiene il nome del parametro da aggiungere alla url nel formato "?nome_parametro=valore" (tramite richieste HTTP GET). Obbligatorio se presente multipage.

feed/info/multipage/pages	Il macro-nodo pages contiene informazioni relative alla pagina corrente e all'ultima pagina disponibile. Obbligatorio se presente multipage.

feed/info/multipage/pages/current	È il nodo che contiene la pagina del feed correntemente generata (deve essere uguale al valore del parametro page-param della richiesta GET inviata o contentere il valore "1" qualora la richiesta sia stata effettuata senza specificare alcun parametro). La richiesta successiva verrà fatta con questo valore incrementato di una unità (fino al valore del nodo last, compreso). Obbligatorio se presente multipage.

feed/info/multipage/pages/last	Questo nodo contiene il numero dell'ultima pagina del feed. iCase.it scorrerà tutte le pagine dalla 1 al numero contenuto nel presente parametro. Obbligatorio se presente multipage.

feed/items	Il macro-nodo items contiene tutti gli annunci all'interno dei nodi item. Obbligatorio.

feed/items/item[@kind]	Il macro-nodo item contiene le informazioni relative ad un singolo annuncio. È obbligatorio specificare l'attributo kind che può assumere i seguenti valori: new : tutti i nodi obbligatori devono essere specificati; l'annuncio viene considerato nuovo e indicizzato su iCase.it; deleted : l'annuncio viene cancellato dagli indici di iCase.it. L'unico nodo che occorre specificare è unique-reference. Obbligatorio tag e attributo @kind.

feed/items/item/metadata	Questo macro-nodo contiene informazioni descrittive dell'annuncio. Obbligatorio.

feed/items/item/metadata/unique-reference	Questo è il nodo più importante del macro-nodo metadata: contiene infatti l'identificatore univoco dell'annuncio. iCase.it utilizzerà questo identificatore per riferirsi all'annuncio inserito. Qualora l'identificatore esista già nei nostri indici (per lo stesso publisher/name) verrà scartato (se si esegue un'operazione [@kind = "new"]) oppure cancellato (se si esegue un'operazione [@kind = "deleted"]). Obbligatorio.

feed/items/item/metadata/title	Questo nodo contiene il titolo dell'annuncio

feed/items/item/metadata/url	Il nodo contiene la URL di questo annuncio. Tale indirizzo sarà utilizzato nelle pagine dei risultati per condurre l'utente alla visualizzazione dell'inserzione sul sito dell'editore. Obbligatorio.

feed/items/item/metadata/date-publishing	Data di pubblicazione dell'annuncio sul sito dell'editore (per le specifiche del formato data confronta feed/info/build-date). Obbligatorio.

feed/items/item/metadata/date-expiration	Data di scadenza dell'annuncio. Dopo tale data l'annuncio potrà essere cancellato dagli indici di iCase.it (per le specifiche del formato data confronta feed/info/build-date).

feed/items/item/metadata/location	Questo macro-nodo contiene informazioni relative al luogo ove è ubicato l'immobile. Obbligatorio.

feed/items/item/metadata/location/address	È l'indirizzo completo nella forma "Nome strada, numero civico, CAP Città, Provincia estesa (Regione), Italy". Obbligatorio.

feed/items/item/metadata/location/country-code	Il codice della Nazione in formato ISO 3166 (Alpha 2). Obbligatorio.

feed/items/item/metadata/location/administrative-area	Il nome esteso della regione. Esempio: Lazio, Toscana, Puglia, ... Obbligatorio.

feed/items/item/metadata/location/sub-administrative-area	Il nome esteso della provincia. Esempio: Roma, Firenze, Bari, ... Obbligatorio.

feed/items/item/metadata/location/locality	Il nome della città. Esempio: Pienza, Montepulciano, Chianciano Terme, ... Obbligatorio.

feed/items/item/metadata/location/thoroughfare	La strada comprensiva di numero civico. Esempio: "Via Roma, 10" (Se inserito verrà attivata anche la funzionalità di google Maps)

feed/items/item/metadata/location/postal-code-number	Il CAP (Codice di Avviamento Postale)

feed/items/item/metadata/location/longitude	La longitudine esatta del luogo al quale ci si riferisce (nell'intervallo +180/-180 per indicare rispettivamente 180° EST/180° OVEST)

feed/items/item/metadata/location/latitude	La latitudine esatta del luogo al quale ci si riferisce (nell'intervallo +90/-90 per indicare rispettivamente 90° NORD/90° SUD)

feed/items/item/metadata/contact	Questo macro-nodo contiene informazioni relative ai contatti di riferimento per l'immobile.

feed/items/item/metadata/contact/advertiser	Il nome dell'entità (privato o azienda) che offre in vendita o affitto l'immobile. Esempio: Immobili & Co. S.r.l.

feed/items/item/metadata/contact/email	L'indirizzo di posta elettronica di feed/items/item/metadata/contact/advertiser.

feed/items/item/metadata/contact/phone-number	Il numero telefonico di feed/items/item/metadata/contact/advertiser. È possibile ripetere più volte questo nodo per indicare numeri telefonici aggiuntivi.

feed/items/item/transaction-type	Indica se l'immobile è in affitto o vendita. I valori ammessi sono: S: immobile in VENDITA (for Sale); R: immobile in AFFITTO (for Rent). Obbligatorio.

feed/items/item/category	Questo nodo indica se si tratta di un'offerta Commerciale, Residenziale o Affitto Vacanze. I valori ammessi sono: C: immobile COMMERCIALE (Commercial); R: immobile RESIDENZALE (Residential). H: immobile AFFITTO VACANZE (holiday). Obbligatorio.

feed/items/item/property-type	Indica il tipo di immobile. I valori ammessi sono quelli indicati in questa tabella: Appartamenti. appartamento attico / mansarda Case. casa indipendente multiproprietà rustico / casale Ville. villa villa a schiera Edifici. palazzo / stabile palazzina commerciale Commerciali. albergo / hotel / pensione attività / licenza comm. azienda agricola bar / ristorante capannone laboratorio magazzino negozio / locale comm. ufficio / studio ambulatorio agriturismo Terreni. terreno edificabile terreno Altri. altro box / garage loft / open space bed & breakfast ( attenzione usare: <![CDATA[bed & breakfast]]> ) camera d'albergo baita / chalet / trullo / stazzo residence Obbligatorio.

feed/items/item/rooms	Numero dei locali.

feed/items/item/bedrooms	Numero delle camere da letto.

feed/items/item/bathrooms	Numero dei bagni.

feed/items/item/size[@unit]	Dimensione dell'immobile e unità di misura utilizzata. Il valore dell'attributo unit deve essere scelto dalla seguente tabella: m2: metro quadrato; sq_ft: square foot; ac: acre; Obbligatorio.

feed/items/item/price[@currency]	Il prezzo dell'immobile. Nell'attributo @currency sarà specificata la valuta nel formato ISO 4217. Esempio: "EUR". Obbligatorio.

feed/items/item/description	Il testo della descrizione dettagliata e completa dell'immobile. Non può contenere tag HTML e deve essere ovviamente codificato in UTF-8. Tale testo non deve essere troncato o abbreviato. Obbligatorio.

feed/items/item/pictures	Questo macro-nodo contiene i riferimenti alle immagini o piante relative all'immobile. Questo nodo può contenere più sotto-nodi di tipo picture-url qualora vi siano più immagini.

feed/items/item/pictures/picture-url	URL alla foto o pianta dell'immobile. Sono ammesse foto nel formato JPG. Obbligatorio se presente pictures.

Feed XML di esempio per iCase.it

<?xml version="1.0" encoding="UTF-8" ?> <feed> <version>1.0</version> <info> <publisher> <name>Publisher Name</name> <site>http://www.example.com/</site> <email>info@example.com</email> </publisher> <build-date>Fri, 01 May 2009 12:00:00 +0200</build-date> <engine>realestate</engine> <multipage> <base-url>http://www.example.com/icase-feed.php</base-url> <page-param>page</page-param> <pages> <current>1</current> <last>10</last> </pages> </multipage> </info> <items> <item kind="new"> <metadata> <unique-reference>DFRTGYH</unique-reference> <title>Trilocale in Vendita a Roma (libero subito)</title> <url>http://www.example.com/case/toscana-siena-pienza/vendita/rustico/CODID-Z9A8B43</url> <date-publishing>Fri, 01 May 2009 12:00:00 +0200</date-publishing> <date-expiration>Wed, 01 May 2011 12:00:00 +0200</date-expiration> <location> <address>Via Roma, 3, 20100 Sesto San Giovanni, Milano (Lombardia), Italy</address> <country-code>IT</country-code> <administrative-area>Lombardia</administrative-area> <sub-administrative-area>Milano</sub-administrative-area> <locality>Sesto San Giovanni</locality> <thoroughfare>Via Roma, 3</thoroughfare> <postal-code-number>20100</postal-code-number> <longitude>13.678409</longitude> <latitude>48.076547</latitude> </location> <contact> <advertiser>Mario Rossi</advertiser> <email>mario.rossi@example.com</email> <phone-number>0341234567</phone-number> <phone-number>3391234567</phone-number> </contact> </metadata> <transaction-type>S</transaction-type> <category>R</category> <property-type>appartamento</property-type> <rooms>3</rooms> <bedrooms>2</bedrooms> <bathrooms>1</bathrooms> <size unit="m2">150</size> <price currency="EUR">900000</price> <description>in zona tranquilla e residenziale, in prossimità delle scuole elementari e comunque vicino al centro storico, disponibile da subito.</description> <pictures> <picture-url>http://www.example.com/images/DFRTGYH/image1.jpg</picture-url> <picture-url>http://www.example.com/images/DFRTGYH/image2.jpg</picture-url> </pictures> </item> <item kind="deleted"> <metadata> <unique-reference>FRTGSYHY</unique-reference> </metadata> </item> </items> </feed>

Modulo di verifica validità del Feed XML

Utilizza questo modulo per sottoporre alla verifica di validità il tuo Feed XML di iCase.it.

URL del feed da verificare:

Modulo di segnalazione di nuovo Feed XML

Utilizza questo modulo per segnalare allo staff di iCase.it l'esistenza di un Feed XML di annunci immobiliari.

URL del feed da segnalare:
Email di contatto:
Breve descrizione: (opzionale)