- Vincoli testuali
- Vincoli di lingua
- Vincoli dello schema
- Vincoli dello schema
- Punteggio e ranking
- Altri vincoli
Questa pagina contiene un elenco di ricette per diversi modi di vincolare le query di ricerca utilizzando il servizio di ricerca.
Vincoli testuali
I dati testuali di un'entità Freebase provengono innanzitutto dal nome e dagli alias, poi dalle chiavi e da altre proprietà testuali e infine dai dati di ancoraggio di Wikipedia, se è stata riconciliata con un argomento di Wikipedia specifico per la lingua.
I vincoli testuali sono specifici per la lingua; al momento sono supportate 18 lingue. L'inglese è di gran lunga la lingua con la maggiore copertura ed è la lingua predefinita.
Per un elenco di tutti i codici lingua attualmente supportati, visita la pagina:
https://www.googleapis.com/freebase/v1/search?help=langs&indent=true
Un vincolo testuale viene specificato con il parametro query. La lingua è specificata con il parametro lang. Ad esempio:
query: "gore" query: "gore" lang: "fr" query: "gore" lang: "de"
Durante l'indicizzazione, i dati testuali vengono normalizzati in modo specifico per la lingua. Ad esempio, in inglese il testo viene convertito in minuscolo e gli accenti vengono rimossi. Al momento della query, sul testo della query viene eseguita la stessa normalizzazione specifica per la lingua. Ad esempio:
query: "beyoncé" query: "beyonce"
Diversi parametri controllano la corrispondenza di un vincolo testuale. Se imposti il parametro prefixed su true, viene attivata una corrispondenza del prefisso solo per il nome e gli alias (e una corrispondenza normale per gli altri dati di testo). Ad esempio:
query: "bob dy" prefixed: true
L'impostazione stemmed su true attiva una corrispondenza con stemming solo per il nome e gli alias (e una corrispondenza normale per gli altri dati di testo). Le corrispondenze con stemming possono essere utilizzate per incollare le differenze di suffisso specifiche della lingua introdotte da plurali o altre forme grammaticali. Ad esempio:
query: "potatos" stemmed: true
Se racchiudi il testo della query tra virgolette doppie (""), viene attivata una corrispondenza a frase. I token di testo nella query devono apparire uno accanto all'altro nei dati testuali dell'entità corrispondente. Ad esempio:
query: "\"to be or not to be\""
Utilizza i parametri name, alias e type per trovare corrispondenze con persone ed entità persona il cui nome contiene la parola che vuoi trovare. Ad esempio:
filter: "(all name:gore alias:gore type:/people/person)"
Allo stesso modo, l'esempio seguente corrisponde solo alle entità /people/person con un alias corrispondente e non al relativo name:
filter: "(all (not name:gore) alias:gore type:/people/person)"
Oltre a specificare i campi di testo da abbinare, è anche possibile specificare la modalità di abbinamento inserendo uno dei seguenti modificatori tra l'operando e il campo di testo:
-
{word}: richiedono che le parole nella stringa corrispondano a quelle nel campo di testo corrispondente del documento. (predefinito) {phrase}: richiedono che le parole si trovino una accanto all'altra nello stesso ordine nel campo di testo corrispondente del documento.-
{full}: come{phrase}, ma richiede anche che la frase corrisponda completamente al campo di testo, non solo al suo interno. In altre parole, una corrispondenza esatta.
Ad esempio, per trovare il singolo musicale intitolato Home di Marc Broussard, utilizza un filtro come il seguente:
filter: "(all type:/music/single name{full}:home /music/track/artist:"Marc Broussard")"Vincoli relativi alla lingua
Come descritto per i vincoli testuali, il parametro lang viene utilizzato per specificare le regole di normalizzazione della lingua da utilizzare per trasformare il testo in token di query. La lingua della query condiziona anche la classificazione dei risultati, in quanto freebase-search riceve un segnale di pertinenza specifico per la lingua dalla pagina di Wikipedia corrispondente.
Al momento sono supportate nove lingue: inglese (en), spagnolo (es), francese (fr), tedesco (de), italiano (it), portoghese (pt), cinese (zh), giapponese (ja) e coreano (ko). L'inglese è di gran lunga la lingua con la maggiore copertura ed è la lingua predefinita.
Ricerca in più lingue contemporaneamente
Il parametro lang accetta un elenco separato da virgole di codici di lingua che fanno sì che la ricerca venga eseguita in tutte le lingue specificate e che i risultati vengano classificati nella prima lingua elencata e visualizzati nella prima lingua dell'elenco che ha un nome per l'entità.
Ad esempio:
Le seguenti ricerche della parola tedesca "Sonnenblume" in tedesco e francese. Classifica e visualizza i risultati in francese:
query: "Sonnenblume" lang: "fr,de"
Le seguenti ricerche in inglese di film in lingua coreana mostrano il nome coreano. La parte in inglese della query è la parola "coreano" nel vincolo expressed_by:
filter: "(all expressed_by:korean type:/film/film)" lang: "ko,en"
Vincoli dello schema
I vincoli dello schema sono specificati con i parametri type e domain. type corrisponde ai valori della proprietà /type/object/type di un'entità.
Ad esempio, il seguente codice limita la ricerca alle sole persone:
query: "gore" type: "/people/person"
domain corrisponde ai valori /type/type/domain di tutti i valori /type/object/type di un'entità.
Ad esempio, il seguente codice limita una ricerca alle entità in francese solo nel dominio /film:
query: "babar" domain: "/film" lang: "fr"
Puoi anche utilizzare singole proprietà di Freebase per filtrare una query. Ad esempio, il seguente codice limita la ricerca alle persone provenienti dal Canada:
query "john" filter: "(all type:/people/person /people/person/nationality:"Canada")"
Vincoli di metaschema
Metaschema filtra le entità in base ai predicati semantici. Questi predicati sono concetti di livello superiore creati a partire da raccolte di proprietà Freebase che descrivono relazioni semantiche simili.
I vincoli dello schema vengono specificati utilizzando gli operandi del parametro filter combinati con un vincolo di nome dell'entità o MID.
Operandi del filtro Metaschema supportati
I seguenti operandi del filtro Metaschema sono supportati dalla ricerca Freebase. Prova ogni esempio facendo clic sul link nella tabella o utilizzando l'app di esempio di ricerca Freebase.
| Nome operando | Esempio/i |
|---|---|
abstraction |
"fettuccine dishes" (prova)
filter: "(all abstraction:fettuccine)" |
abstraction_of |
"class of the Western Bulwark locomotive" (prova)
filter: "(all abstraction_of:"Western Bulwark")" |
adaptation |
"L'opera La Traviata è un adattamento di" (prova)
filter: "(all adaptation_of:"La Traviata")" |
administered_by |
"Cannes awards" (prova)
filter: "(all type:awards administered_by:cannes)" |
administers |
"Chi dirige il giornale Synapse?" (Prova.)
filter: "(all administers:synapse)" |
appears_in |
"personaggi del Flauto Magico" (prova)
filter: "(all appears_in:"magic flute")" filter: "(all appears_in:"Die Zauberflöte")" lang: "de" |
broader_than |
"line of aircraft that the Airbus 319 belongs to" (Prova.)
filter: "(all broader_than:"Airbus A319")" |
category |
"french actresses" (prova)
filter: "(all category:female origin:france notable:actor)" filter: "(all category:female origin:france practitioner_of:actor)" filter: "(all category:volcano (any part_of:california part_of:france))" "pasta dishes" (prova) filter: "(all category:pasta)" |
center |
"compagnie aeree con un hub a San Francisco" (Prova.)
filter: "(all type:airline center:"San Francisco")" filter: "(all type:airline center:"San Francisco" center:atlanta)" filter: "(all type:/book/newspaper center:/m/0d6lp)" |
center_for |
"impianti sportivi dei San Francisco 49ers" (prova)
filter: "(all center_for:"san francisco 49ers")" |
certification |
"Film vietati ai minori di 17 anni di Wim Wenders" (prova)
filter: "(all type:/film/film contributor:wenders certification:r)" |
character |
"works which have Papageno as character" (prova)
filter: "(all character:papageno)" |
child |
"genitori di Bill Clinton" (prova)
filter: "(all child:"bill clinton")" |
contributed_to |
"Chi ha contribuito a Blade Runner?" (Prova.)
filter: "(all contributed_to:"Blade Runner")" |
contributor |
"movies by Steven Spielberg" (film di Steven Spielberg) (Prova.)
filter: "(all type:/film/film contributor:"Steven Spielberg")" filter: "(all type:/film/film contributor:/m/06pj8)" filter: "(all type:/film/film contributor:"Harrison Ford")" |
created |
"chi ha scritto 'Per chi suona la campana'" (prova)
filter: "(all created:"for whom the bell tolls")" |
created_by |
"software di Google" (prova)
filter: "(all notable:software created_by:google)" |
discovered |
"scopritori del radio" (Prova.)
filter: "(all discovered:radium)" |
discovered_by |
"scoperte di Curie" (Prova.)
filter: "(all discovered_by:curie)" |
distributed_by |
"NPR shows" (prova)
filter: "(all type:show distributed_by:npr)" |
exhibited |
"where was 'down by law' presented ?" (Prova.)
filter: "(all exhibited:"down by law")" |
exhibited_at |
"nominated works shown at the 2010 Cannes Film Festival" (prova)
filter: "(all type:"nominated work" exhibited_at:"2010 Cannes Film festival")" |
expressed_by |
"libri in esperanto" (prova)
filter: "(all type:book expressed_by:esperanto)" |
fictional_link |
"fictional characters related to Mickey Mouse" (prova)
filter: "(all type:/fictional_universe/fictional_character fiction_link:"mickey mouse")" |
genre |
"cattedrali gotiche" (prova)
filter: "(all category:cathedral genre:gothic)" filter: "(all category:cathedral genre:gothic created_by:viollet)" |
identifies |
"Che cosa identifica Southwest Airlines?" (Prova.)
filter: "(all identifies:"Southwest Airlines")" |
leader |
"Mitch Kapor companies" (prova)
filter: "(all type:company leader:kapor)" |
leader_of |
"Sindaci di Parigi" (prova)
filter: "(all title:mayor leader_of:paris)" |
made_of |
"wax paintings" (prova)
filter: "(all type:painting made_of:wax)" |
means_of_demise |
"executed politicians" (prova)
filter: "(all type:politician means_of_demise:"capital punishment")" |
member_of |
"african monarchs" (Prova.)
filter: "(all type:monarch member_of:africa)" filter: "(all type:politician member_of:democratic notable:actor)" |
narrower_than |
"examples of v8 engines" (Prova.)
filter: "(all type:engine narrower_than:"v8 engine")" |
occurs_in |
"languages spoken in Romania" (prova)
filter: "(all type:language occurs_in:romania)" |
origin |
"Governatori repubblicani dell'Austria" (prova)
filter: "(all title:governor member_of:republican origin:austria)" |
owner |
"makes owned by Ford" (Prova.)
filter: "(all type:make owner:ford)" |
owns |
"Chi è il proprietario dei Mavericks?" (Prova.)
filter: "(all owns:mavericks)" |
parent |
"Al Gore's children" (prova)
filter: "(all parent:"al gore")" filter: "(all type:/computer/programming_language parent:lisp)" |
part_of |
"swedish lakes" (prova)
filter: "(all type:lake part_of:sweden)" filter: "(all type:competition part_of:"2008 summer olympics")" |
participant |
"Concerti di Bowie" (Prova.)
filter: "(all participant:bowie type:concert)" |
participated_in |
"Notable austrian skiers who participated in Olympics" (prova)
filter: "(all notable:skier member_of:austria participated_in:olympics)"' |
peer_of |
"politicians peers of Al Gore" (prova)
filter: "(all notable:politician peer_of:gore)" |
permits_use_of |
"Motori diesel" (Prova)
filter: "(all permits_use_of:diesel)" |
portrayed |
"attori che hanno interpretato John Lennon" (prova)
filter: "(all notable:actor portrayed:"john lennon")" |
portrayed_by |
"personaggi interpretati da Harrison Ford" (prova)
filter: "(all portrayed_by:"Harrison Ford")" |
practitioner_of |
"female african american lawyers" (prova)
filter: "(all category:female category:"african american" practitioner_of:lawyer)" |
preceeding |
"sequels to The Lord of the Rings, the two Towers" (Try it.)
filter: "(all type:/film/film preceeding:"The Lord of the Rings, the two Towers")" |
produced_by |
"Computer Apple" (prova)
filter: "(all type:computers produced_by:apple)" |
publication |
"which book has /m/0clw238 as first edition ?" (Prova.)
filter: "(all publication:/m/0clw238)" |
publication_of |
"uscite di La Traviata" (prova)
filter: "(all publication_of:"La Traviata")" |
service_area |
"Emittenti della California" (prova)
filter: "(all type:broadcaster service_area:california)" |
status |
"ritiro dei ghiacciai svizzeri" (prova)
filter: "(all type:glacier status:retreating part_of:switzerland)" |
subclass_of |
"kinds of swimwear" (Prova.)
filter: "(all subclass_of:swimwear)" |
subject |
"film sull'olocausto" (prova)
filter: "(all type:film subject:holocaust)" filter: "(all type:book subject:mathematics)" |
subsequent |
"prequel de Il Signore degli Anelli, le due torri" (Prova.)
filter: "(all type:/film/film subsequent:"The Lord of the Rings, the two Towers")" |
succeeded_by |
"Quale piattaforma automobilistica è stata sostituita dalla piattaforma Ford B3?" (Prova.)
filter: "(all succeeded_by:"ford b3 platform")" |
succeeds |
"Chi è succeduto alla Casa Stuart?" (Prova.)
filter: "(all succeeds:stuart)" |
superclass_of |
"Classes coronary heart disease belongs to" (Prova.)
filter: "(all superclass_of:"coronary heart disease")" |
title |
"Google engineers" (prova)
filter: "(all title:engineer member_of:google)" |
tookplace_at |
"battaglie che si sono svolte a Marengo" (prova)
filter: "(all type:battles tookplace_at:marengo)" |
use_permitted_by |
"Formati di file supportati su un iPhone" (Prova)
filter: "(all type:"file format" use_permitted_by:iphone)" |
Punteggio e ranking
Le entità Freebase hanno un punteggio di pertinenza (ranking) intrinseco calcolato durante l'indicizzazione, che è funzione del numero di link in entrata e in uscita in Freebase e Wikipedia. Alcune entità Freebase popolari hanno anche un punteggio di popolarità calcolato da Google. Per impostazione predefinita, entrambi i punteggi vengono combinati durante le query.
Quando è presente un vincolo testuale, viene calcolato un punteggio di corrispondenza testuale dal numero di risultati restituiti dall'indice di ricerca e viene combinato con il punteggio di pertinenza.
I risultati di FreebaseSearch sono sempre ordinati in base al punteggio finale, dal più alto al più basso.
Il parametro di punteggio consente di controllare quali componenti del punteggio di pertinenza vengono utilizzati per calcolare il punteggio finale:
freebase: utilizza solo il punteggio di pertinenza di Freebase.
query: "beyoncé" scoring: freebase
entity: utilizza entrambi i punteggi di pertinenza, che sostituiscono eventuali punteggi Google mancanti con 1.0. Questa è l'impostazione predefinita.
query: "beyoncé" scoring: entity
schema: utilizza questa opzione quando cerchi entità dello schema come tipi, proprietà o domini. Il conteggio dei link delle entità dello schema viene calcolato in modo diverso.
query: "performance" scoring: schema
Altri vincoli
Le entità possono essere filtrate in base al tag di indice utilizzando i parametri con o senza. Le entità vengono taggate durante l'indicizzazione e ogni tag corrisponde a una o più query Freebase che sarebbero troppo costose da eseguire durante la ricerca:
commons è un tag che può essere utilizzato per limitare una ricerca dello schema in modo che restituisca solo lo schema Freebase Commons.
Ad esempio, i tipi di Freebase Commons che corrispondono alla parola "colore"
query: "color" type: "/type/type" with: "commons"
gg è un tag che può essere utilizzato per limitare una ricerca alle entità per le quali è presente o meno un punteggio di popolarità Google.
query: "1923" type: "/people/person" with: "gg" query: "1923" type: "/people/person" without: "gg"
Il parametro without equivale a un valore negato in un'espressione di filtro.
query: "color" limit: 5 type: "/type/type" without: "commons" query: "color" limit: 5 type: "/type/type" filter: "(not with:commons)"