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.
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/price_type | Il tipo del prezzo.
|
|
| 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/items/item/energy_class | Classe Energetica- A+
- A
- 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". |
Utilizza questo modulo per sottoporre alla verifica di validità il tuo Feed XML.
Utilizza questo modulo per segnalare allo staff di iCase.it l'esistenza di un Feed XML di annunci immobiliari.