Parametri di Interrogazione • Open Data Monuments

Come inserire la ricerca in un altro sito

È possibile utilizzare il presente engine per integrare la ricerca in siti di terze parti, importando l'intero catalogo o parte di esso attraverso l'Open Data presente nell'apposita sezione, oppure utilizzato le apposite API d'interrogazione diretta tramite i protocolli JSon, CSV e XML.

Sintassi di interrogazione

L'interrogazione può avvenire in modalità GET o POST tramite le API - json.php, cvs.php e xml.php.

Parametri d'interrogazione:

Parametro Tipo Descrizione
q <stringa>
 Ricerca generica
La stringa può ricercare anche tra le provincie se specificato
Esempi:
?q=BO
?q=Tempio Malatestiano
mid <intero>
Il valore deve essere > 0 		ricerca per id monumento.
Esempi:
?mid=1445
gm <intero>
Il valore deve essere > 0 		ricerca per gid mibact.
Esempi:
?gm=6556
m <stringa> Ricerca per nome monumento
Esempi:
?m=Tempio Malatestiano
?m=Tempio_Malatestiano
pr <stringa>
valori preimpostati:
('PC', 'PR', 'RE', 'MO', 'BO', 'FE', 'RA', 'FC', 'RN') 		Ricerca per sigla provinciale.
Esempi:
?pr=BO
?pr=fe
c <stringa> Ricerca nei campi comune e località.
Esempi:
?c=Pianoro
?c=Pianoro, Pieve del pino
dx* [da implementare] <float>
Coppia di numeri reali finiti a precisione variabile separati dal carattere virgola
La stringa rapprensenta il valore di una coppia di coordinate 		Ricerca per coordinate, punto di partenza
Esempi:
?dx=44.49429,11.34666
sx* [da implementare] <float>
Coppia di numeri reali finiti a precisione variabile separati dal carattere virgola
La stringa rapprensenta il valore di una coppia di coordinate 		Ricerca per coordinate, punto di arrivo
Esempi:
?sx=45.49429,12.34666
a <stringa> Ricerca per nome dell' autore.
Esempi:
?a=Mario Rossi
?a=Mario_Rossi
cc <stringa>
valori preimpostati:
('by', 'bync') 		Ricerca per licenza CC.
Esempi:
?cc=by
?cc=bync
s <stringa>
valori preimpostati:
('i', 'p', 'a', 'v')
  • valore 'i' Interni
  • valore 'p' Persone
  • valore 'v' Paesaggi
  • valore 'a' Opere d'arte
La stringa può contenere da uno a tutti gli elementi dell'insieme 		Ricerca per soggetto.
Esempi:
?s=i
?s=pia
cda <intero>, 1 tutti i risultati
?cda=1

*I campi sx e dx se usati in concomitanza eseguono una ricerca all'interno di un area geografica

Parametri di visualizzazione

Parametro Tipo Descrizione
result <intero>
il valore deve essere > 0 		numero di risultati proposti
?result=25
start <intero> il valore deve essere > 0 posizione di partenza
?start=10
all <intero>, 1 tutti i risultati non paginati o limitati
?all=1