iCase.it

Standard Feed di iCase 1.0

ATTENZIONE: Il seguente feed non è più supportato per visionare i formati accettati clicca qui.

Come funziona?

Il funzionamento è semplice se vengono seguiti questi passi:

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

2tramite 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";

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

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

5in 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.

feedQuesto è il nodo root e contiene tutto il Feed XML di iCase.it.
Obbligatorio.
feed/versionIl numero di versione del Feed XML di iCase.it: attualmente 1.0.
Obbligatorio.
feed/infoIl nodo contiene tutte le informazioni relative al feed specifico.
Obbligatorio.
feed/info/publisherInformazioni relative all'editore.
Obbligatorio.
feed/info/publisher/nameIl nome dell'editore. Esempio: "Immobili & Co.".
Obbligatorio.
feed/info/publisher/siteIl sito dell'editore. Esempio: "http://www.example.com/".
Obbligatorio.
feed/info/publisher/emailLa mail del referente del Feed XML dell'editore. Esempio: "info@example.com".
Obbligatorio.
feed/info/build-dateLa 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/enginePer iCase.it questo valore è sempre "realestate".
Obbligatorio.
feed/info/multipageQuesto 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-urlIl 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-paramQuesto 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/pagesIl 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/lastQuesto 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/itemsIl 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/metadataQuesto 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/urlIl 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/locationQuesto 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/istat Codice ISTAT della città.
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/contactQuesto 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/roomsNumero dei locali.
feed/items/item/bedroomsNumero delle camere da letto.
feed/items/item/bathroomsNumero 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/price_type Il tipo del prezzo.
  • 1: Tratt. Riservata
feed/items/item/descriptionIl 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/picturesQuesto 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-urlURL alla foto o pianta dell'immobile. Sono ammesse foto nel formato JPG.
Obbligatorio se presente pictures.
feed/items/item/energy_class Classe Energetica
  • A4
  • A3
  • A2
  • A1/b>
  • B
  • C
  • D
  • E
  • F
  • G
  • ND: Esente da certificazione
Obbligatorio dal 2012

La legge regionale n. 3/2011 (Collegato ordinamentale 2011), entrata in vigore l'11 marzo 2011,
stabilisce infatti all'articolo 17 che la Giunta regionale detta disposizioni per
"rendere obbligatoria la dichiarazione della classe e dell'indice di prestazione energetica dell'edificio o della singola unità abitativa in tutti gli annunci commerciali finalizzati alla relativa vendita o anche locazione".
feed/items/item/ipe l'indice di prestazione energetica (IPE)
Nel caso di edifici residenziali espresso in kWh/m2 anno.
Nel caso di altri edifici espresso in kWh/m3 anno.

Obbligatorio dal 2012

La legge regionale n. 3/2011 (Collegato ordinamentale 2011), entrata in vigore l'11 marzo 2011,
stabilisce infatti all'articolo 17 che la Giunta regionale detta disposizioni per
"rendere obbligatoria la dichiarazione della classe e dell'indice di prestazione energetica dell'edificio o della singola unità abitativa in tutti gli annunci commerciali finalizzati alla relativa vendita o anche locazione".

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 2010 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>
		<energy_class>B</energy_class>
		<ipe>35,0</ipe>
		<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.

Standard del feed:
URL del feed da verificare: