API QUOTAZIONI IMMOBILIARI GEOREFERENZIATE
Il servizio fornisce quotazioni immobiliari a livello di sigola via, di tutte le principali tipologie presenti nel territorio nazionale. La qualità dei dati forniti è garantita da un innovativo sistema statistico ed informativo di gestione e verifica dei valori.
- Indirizzo immobile
- Tipologia immobiliare
- Contratto (vendita/affitto)
- Nome zona immobiliare
- Valore minimo €/m2
- Valore medio €/m2
- Valore massino €/m2
- Abitazioni Economiche
- Abitazioni Civili
- Abitazioni Signorili
- Ville e Villini
- Negozi
- Uffici
- Box auto
- Posti Auto coperti
- Posti Auto scoperti
- Laboratori
- Magazzini
- Capannoni artigianali
- Capannoni industriali
METODI API QUOTAZIONI
Metodo
getImmobiliType()
Per recuperare l'elenco delle tipologie immobiliari di cui è possibile eseguire una Valuazione.
(Questo metodo, non necessita della chiave identificativa
Api Key
)
$immobili = file_get_contents("https://api.borsinopro.it/rest/standard-v1/getImmobiliType/");
Nell'esempio appena descritto, utiliziamo una semplice funzione del php "file_get_contents
"
Se invece stai utilizzando la nostra Classe PHP Borsino.class.php
puoi invocare lo stesso metodo in questo modo:
$immobili = $Borsino->getImmobiliType();
Cosa Restituisce
La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json
, che andremo successivamente a suddividere ed analizzare nel dettaglio
Metodo
getContractType()
Per recuperare l'elenco delle formule di contratto immobiliare di cui è possibile eseguire una Valuazione.
(Questo metodo, non necessita della chiave identificativa
Api Key
)
$contratti = file_get_contents("https://api.borsinopro.it/rest/standard-v1/getContractType/");
Come nella precedente chiamata, l'esempio appena descritto, utiliziamo una semplice funzione del php "file_get_contents
",
Se invece stai utilizzando la nostra Classe PHP Borsino.class.php
puoi invocare lo stesso metodo in questo modo:
$contratti = $Borsino->getContractType();
Cosa Restituisce
La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json
, che andremo successivamente a suddividere ed analizzare nel dettaglio
Metodo
getAddress()
- Per identificare l'esatta ubicazione dell'immobile oggetto valutazione.
- Per recuperare l'elenco dei campi e select necessari ad effettuare valutazione.
IMPORTANTE: Per il metodo getAddress()
và obbligatoriamente indicata la chiave identificativa Api Key
.
Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare dopo che l'utente ha indicato i campi preliminari obbligatori:
STEP One
È il nome con cui identificheremo la schermata iniziale di inserimento dati, prevista dal flusso Api di Elaborazione Stima Immobiliare.
# Struttura della chiamata:
End-Point: https://api.borsinopro.it/rest/standard-v1/getAddress/
$curl_call = curl_init();
curl_setopt($curl_call, CURLOPT_HEADER, false);
curl_setopt($curl_call, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl_call, CURLOPT_USERPWD, "Api Key");
curl_setopt($curl_call, CURLOPT_URL, "https://api.borsinopro.it/rest/standard-v1/getAddress/");
curl_setopt($curl_call, CURLOPT_POST, true);
curl_setopt($curl_call, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_call, CURLOPT_POSTFIELDS, $_POST);
curl_setopt($curl_call, CURLOPT_SSL_VERIFYPEER, false);
$result = curl_exec($curl_call);
curl_close($curl_call);
# Campi * obbligatori da inviare in POST
* address indirizzo immobile
Tipo Valore: String
Criteri: Min 5 e Max 255 caratteri alfanumerici
Esempio: Via Asmara 24 Roma
* type tipo di immobile
Tipo Valore: Integer
Criteri: Option Integer - Selezionato dalla lista restituita da getImmobiliType()
Esempio: 6 => "Uffici" , 20 => "Abitazioni in stabili civili"
* for tipo di contratto
Tipo Valore: String
Criteri: Option String - Selezionato dalla lista restituita da getContractType()
Esempio: sale => "Vendita" , rent => "Affitto"
Cosa Restituisce
La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json
, che andremo successivamente a suddividere ed analizzare nel dettaglio
Metodo
getValutazione()
- Per recuperare i risultati della valutazione.
IMPORTANTE: Per il metodo getValutazione()
và obbligatoriamente indicata la chiave identificativa Api Key
.
Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare:
STEP Two
È il nome con cui identificheremo la schermata iniziale di inserimento dati, prevista dal flusso Api di Elaborazione Stima Immobiliare.
# Struttura della chiamata:
End-Point: https://api.borsinopro.it/rest/standard-v1/getValutazione/
$curl_call = curl_init();
curl_setopt($curl_call, CURLOPT_HEADER, false);
curl_setopt($curl_call, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl_call, CURLOPT_USERPWD, "Api Key");
curl_setopt($curl_call, CURLOPT_URL, "https://api.borsinopro.it/rest/standard-v1/getValutazione/");
curl_setopt($curl_call, CURLOPT_POST, true);
curl_setopt($curl_call, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_call, CURLOPT_POSTFIELDS, $_POST);
curl_setopt($curl_call, CURLOPT_SSL_VERIFYPEER, false);
$result = curl_exec($curl_call);
curl_close($curl_call);
# Campi * obbligatori da inviare in POST
* i campi obbligatori sono indicati nella risposta $response->form restituiti nello Step One
Cosa Restituisce
La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json
, che andremo successivamente a suddividere ed analizzare nel dettaglio
Metodo
getQuotazione()
- Per identificare l'esatta ubicazione della zona immobiliare.
- Per recuperare le quotazioni risultanti.
IMPORTANTE: Per il metodo getQuotazioni()
và obbligatoriamente indicata la chiave identificativa Api Key
.
Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare dopo che l'utente ha indicato i campi preliminari obbligatori:
STEP Quote
È il nome con cui identificheremo la schermata iniziale di inserimento dati, prevista dal flusso Api di Elaborazione Stima Immobiliare.
# Struttura della chiamata:
End-Point: https://api.borsinopro.it/rest/standard-v1/getQuotazione/
$curl_call = curl_init();
curl_setopt($curl_call, CURLOPT_HEADER, false);
curl_setopt($curl_call, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl_call, CURLOPT_USERPWD, "Api Key");
curl_setopt($curl_call, CURLOPT_URL, "https://api.borsinopro.it/rest/standard-v1/getQuotazione/");
curl_setopt($curl_call, CURLOPT_POST, true);
curl_setopt($curl_call, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_call, CURLOPT_POSTFIELDS, $_POST);
curl_setopt($curl_call, CURLOPT_SSL_VERIFYPEER, false);
$result = curl_exec($curl_call);
curl_close($curl_call);
# Campi * obbligatori da inviare in POST
* address indirizzo immobile
Tipo Valore: String
Criteri: Min 5 e Max 255 caratteri alfanumerici
Esempio: Via Asmara 24 Roma
* type tipo di immobile
Tipo Valore: Integer
Criteri: Option Integer - Selezionato dalla lista restituita da getImmobiliType()
Esempio: 6 => "Uffici" , 20 => "Abitazioni in stabili civili"
* for tipo di contratto
Tipo Valore: String
Criteri: Option String - Selezionato dalla lista restituita da getContractType()
Esempio: sale => "Vendita" , rent => "Affitto"
Cosa Restituisce
La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json
, che andremo successivamente a suddividere ed analizzare nel dettaglio
Metodo
getConsoData()
IMPORTANTE: Per il metodo getConsoData()
di seguito descritta in questa Guida allo Sviluppo, và obbligatoriamente indicata la chiave identificativa Api Key
.
Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare con i relativi campi obbligatori:
# Struttura della chiamata:
End-Point: https://api.borsinopro.it/rest/standard-v1/getConsoData/
$curl_call = curl_init();
curl_setopt($curl_call, CURLOPT_HEADER, false);
curl_setopt($curl_call, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl_call, CURLOPT_USERPWD, "Api Key");
curl_setopt($curl_call, CURLOPT_URL, "https://api.borsinopro.it/rest/standard-v1/getConsoData/");
curl_setopt($curl_call, CURLOPT_POST, true);
curl_setopt($curl_call, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_call, CURLOPT_POSTFIELDS, $_POST);
curl_setopt($curl_call, CURLOPT_SSL_VERIFYPEER, false);
$result = curl_exec($curl_call);
curl_close($curl_call);
# Campi facoltativi in ordine di priorità
codcat codice catastale
Tipo Valore: String
Criteri: Min 3 e Max 7 caratteri alfanumerici
Esempio: H501
citta nome Comune
Tipo Valore: String
Criteri: Min 2 e Max 100 caratteri alfanumerici
Esempio: Fiano Romano
address indirizzo immobile
Tipo Valore: String
Criteri: Min 5 e Max 255 caratteri alfanumerici
Esempio: Via Asmara 24 Roma
# Campi * obbligatori da inviare in POST
* type tipo di immobile
Tipo Valore: Integer
Criteri: Option Integer - Selezionato dalla lista restituita da getImmobiliType()
Esempio: 6 => "Uffici" , 20 => "Abitazioni in stabili civili"
* for tipo di contratto
Tipo Valore: String
Criteri: Option String - Selezionato dalla lista restituita da getContractType()
Esempio: sale => "Vendita" , rent => "Affitto"
Cosa Restituisce
La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json
Le varianti del campo "message" in base ai criteri di ricerca
"Media Quotazione Valori Affitto - Comune: Fiano Romano - Tipologia: Abitazioni in stabili civili"
"Media Quotazione Valori Affitto - Via Asmara, 24, 00199 Roma RM - Abitazioni in stabili civili"