Ricerche semantiche su Wikipedia

‹ Pagina delle API

---

Percorso: ./API/Semantic_data/
Tipo di accesso: libero

Usando queste API si richiamerà la classe get_semantic_data che consente di estrapolare alcuni dati da Wikipedia attraverso l'impiego di query semantiche.
La classe effettua una ricerca usando le API ufficiali di Wikipedia, e con il primo risultato attinente effettua una query SPARQL su dbpedia, estrapolando così i relativi dati semantici.

È possibile ricavare dati sui seguenti temi:

• Libri
• Album musicali
• Film
• Personaggi storici o di fama
• Cose o oggetti

Fare una ricerca

Contesto

| Operatore | Descrizione | URL | | :--- | :--- | :--- | :--- | | album | Ricerca il titolo dell'album musicale indicato | ./API/Semantic_data/?album=titolo | | book | Ricerca il titolo del libro indicato | ./API/Semantic_data/?book=titolo | | film | Ricerca il titolo del film indicato | ./API/Semantic_data/?film=titolo | | person | Ricerca il nome dell'artista o personaggio | ./API/Semantic_data/?person=titolo | | thing | Ricerca il nome di un oggetto o di una cosa | ./API/Semantic_data/?person=titolo |

Nota: le query di ricerca possono essere concatenate.
Di default il risultato verrà esportato in formato json

Cambiare il formato di esportazione

| Operatore | Descrizione | URL | Note | | :--- | :--- | :--- | :--- | :--- | | array | Visualizza la struttura dell'array | ./API/Semantic_data/?contesto=titolo&format=array | | | json | Esporta in json | ./API/Semantic_data/?contesto=titolo&format=json | | | jsonp | Esporta in json (leggibile) | ./API/Semantic_data/?contesto=titolo&format=jsonp | default | | html | Esporta in html | ./API/Semantic_data/?contesto=titolo&format=html | |

Nota: è possibile aggiungere il parametro opzionale &output=html nel caso in cui si desideri che il testo all'interno della struttura sia pre-formattato in html.

Debug

È possibile fare un debug della ricerca e dei risultati ottenuti aggiungendo semplicemente debug=true.

Cambiare l'output del debug

| Operatore | Descrizione | URL | Note | | :--- | :--- | :--- | :--- | :--- | | array | Visualizza solo i risultati semantici sotto forma di array | ./API/Semantic_data/?contesto=titolo&debug=true&output=array | | | object | Visualizza solo i risultati semantici sotto forma di oggetto | ./API/Semantic_data/?contesto=titolo&debug=true&output=object | | | all | Visualizza i risultati semantici sia sotto forma di oggetto che di array | ./API/Semantic_data/?contesto=titolo&debug=true&output=all | default |

Usare la classe di codice

Seguire il seguente esempio:

require_once("get_semantic_data.class.php");
$semantic_data = new semantic_data();
	// As example
	$semantic_data->output("html");
	$semantic_data->format("array");
$semantic_data->thing(rawurldecode($_GET["thing"]));
// Set "false" if you want the output in a variable or nothing if you want to print to screen directly
$result = $semantic_data->export(false);