- Contraintes textuelles
- Restrictions linguistiques
- Contraintes de schéma
- Contraintes de métaschéma
- Évaluation et classement
- Autres contraintes
Cette page contient une liste de recettes pour différentes méthodes de limitation des requêtes de recherche à l'aide du service de recherche.
Contraintes textuelles
Les données textuelles d'une entité Freebase proviennent d'abord de son nom et de ses alias, puis de ses clés et autres propriétés textuelles, et enfin de ses données d'ancrage Wikipédia si elles ont été rapprochées avec un sujet Wikipédia spécifique à une langue.
Les contraintes textuelles sont spécifiques à une langue. Actuellement, 18 langues sont acceptées. L'anglais est de loin le champ d'action le plus étendu et est la langue par défaut.
Pour obtenir la liste de tous les codes de langue actuellement acceptés, consultez les pages suivantes:
https://www.googleapis.com/freebase/v1/search?help=langs&indent=true
Une contrainte textuelle est spécifiée avec le paramètre query. Sa langue est spécifiée par le paramètre lang. Exemple :
query: "gore" query: "gore" lang: "fr" query: "gore" lang: "de"
Lors de l'indexation, les données textuelles sont normalisées en fonction de la langue. Par exemple, en anglais, le texte est converti en minuscules et les accents sont supprimés. Au moment de la requête, la même normalisation est appliquée au texte de la requête. Exemple :
query: "beyoncé" query: "beyonce"
Plusieurs paramètres contrôlent la mise en correspondance d'une contrainte textuelle. Définir le paramètre prefixed sur true déclenche une correspondance de préfixe uniquement sur le nom et les alias (et une correspondance standard sur d'autres données textuelles). Exemple :
query: "bob dy" prefixed: true
Si vous définissez stemmed sur true, la correspondance n'est déclenchée qu'avec les noms et les alias (ainsi qu'avec les autres données textuelles). Les correspondances dérivées d'un même radical peuvent être utilisées pour coller les différences de suffixe propres à une langue introduites par des pluriels ou d'autres formes grammaticales. Exemple :
query: "potatos" stemmed: true
Entourer le texte de la requête de guillemets (") permet de déclencher une expression exacte. Les jetons de texte de la requête doivent apparaître l'un à côté de l'autre dans les données textuelles de l'entité correspondante. Exemple :
query: "\"to be or not to be\""
Utilisez les paramètres name, alias et type pour rechercher les personnes et les entités dont le nom contient le mot que vous souhaitez rechercher. Exemple :
filter: "(all name:gore alias:gore type:/people/person)"
De même, l'exemple suivant correspond aux entités /people/person avec un alias correspondant uniquement, et non leur name :
filter: "(all (not name:gore) alias:gore type:/people/person)"
En plus de spécifier les champs de texte qui doivent être mis en correspondance, vous pouvez également spécifier la manière dont la correspondance doit se produire en insérant l'un des modificateurs suivants entre l'opérande et le champ de texte:
-
{word}: les mots de la chaîne doivent correspondre aux mots du champ correspondant dans le document. (par défaut) {phrase}: les mots doivent apparaître l'un à côté de l'autre dans le même ordre dans la zone de texte correspondante du document.-
{full}: comme dans{phrase}, l'expression doit également correspondre parfaitement au champ de texte, et pas seulement à l'intérieur de celui-ci. En d'autres termes, une correspondance complète.
Par exemple, pour trouver le single musical Home de Marc Brussard, utilisez un filtre comme suit:
filter: "(all type:/music/single name{full}:home /music/track/artist:"Marc Broussard")"
Contraintes liées à la langue
Comme décrit avec les contraintes textuelles, le paramètre lang permet de spécifier les règles de normalisation de langage à utiliser pour transformer le texte en jetons de requête. La langue de la requête conditionne également le classement des résultats, car freebase-search reçoit un signal de pertinence propre à la langue à partir de Wikipédia.
Neuf langues sont actuellement disponibles: allemand (de), anglais (en), espagnol (es), français (fr), italien (it), chinois (zh), japonais (ja) et portugais (pt). L'anglais est de loin le champ d'action le plus étendu et est la langue par défaut.
Effectuer des recherches dans plusieurs langues en même temps
Le paramètre lang accepte une liste de codes de langues séparés par une virgule, ce qui permet d'effectuer la recherche dans toutes les langues spécifiées. Les résultats sont alors classés dans la première langue de la liste, puis affichés dans la première langue de la liste, dont le nom correspond à l'entité.
Exemple :
Les recherches suivantes portent sur le terme allemand "Sonnenblume" en allemand et en français. Il classe les résultats en français:
query: "Sonnenblume" lang: "fr,de"
Les recherches suivantes concernent les films dont la langue est le coréen et qui affichent leur nom coréen. La partie anglaise de la requête est le mot "coréen" dans la contrainte expressed_by:
filter: "(all expressed_by:korean type:/film/film)" lang: "ko,en"
Contraintes du schéma
Les contraintes de schéma sont spécifiées à l'aide des paramètres type et domain. type correspond aux valeurs de propriété /type/object/type d'une entité.
Par exemple, les éléments suivants limitent la recherche aux utilisateurs:
query: "gore" type: "/people/person"
domain correspond aux valeurs /type/type/domain de toutes les valeurs /type/object/type d'une entité.
Par exemple, la requête suivante limite la recherche aux entités en français du domaine /film uniquement:
query: "babar" domain: "/film" lang: "fr"
Vous pouvez également filtrer une requête à l'aide de propriétés Freebase individuelles. Par exemple, les options suivantes permettent de limiter la recherche aux personnes résidant au Canada:
query "john" filter: "(all type:/people/person /people/person/nationality:"Canada")"
Contraintes de métaschémaes
Les contraintes Metaschema filtrent les entités par prédicats sémantiques. Ces prédicats sont des concepts de niveau supérieur conçus à partir de collections de propriétés Freebase décrivant des relations sémantiques similaires.
Les contraintes de métaschéma sont spécifiées à l'aide des opérandes des paramètres filter combinés à un nom d'entité ou à une contrainte MID.
Opérandes de filtre Metaschema prises en charge
Les opérandes de filtre Metaschema suivants sont pris en charge par Freebase Search. Testez chaque exemple en cliquant sur le lien dans le tableau ou en utilisant l'exemple d'application de recherche Freebase.
| Nom de l'opérande | Exemple(s) |
|---|---|
abstraction |
fettuccine plats" (Essayer)
filter: "(all abstraction:fettuccine)" |
abstraction_of |
"class of the Western Bulwark locomotive" (Essayer.)
filter: "(all abstraction_of:"Western Bulwark")" |
adaptation |
"Works La Traviata est une adaptation de" (Essayer).
filter: "(all adaptation_of:"La Traviata")" |
administered_by |
"Cannes Awards (Essayer)
filter: "(all type:awards administered_by:cannes)" |
administers |
" Qui gère le journal Synapse ? (Essayer)
filter: "(all administers:synapse)" |
appears_in |
personnages de la flûte magique (Essayer)
filter: "(all appears_in:"magic flute")"" Figuren in der Zauberflöte" (Essayer.) filter: "(all appears_in:"Die Zauberflöte")" lang: "de" |
broader_than |
Ligne d'avion à laquelle l'Airbus 319 appartient (Essayer)
filter: "(all broader_than:"Airbus A319")" |
category |
Actrices françaises (Essayer)
filter: "(all category:female origin:france notable:actor)"" Actrices françaises&variantes (Essayer) filter: "(all category:female origin:france practitioner_of:actor)""californie ou volcans français (essayez.) filter: "(all category:volcano (any part_of:california part_of:france))" " plats de pâtes" (Essayer) filter: "(all category:pasta)" |
center |
"airlines with a hub in San Francisco" (Essayer.)
filter: "(all type:airline center:"San Francisco")"" compagnies aériennes avec des hubs à San Francisco et Atlanta" (Essayer.) filter: "(all type:airline center:"San Francisco" center:atlanta)""journaux centrés à San Francisco" (Essayer.) filter: "(all type:/book/newspaper center:/m/0d6lp)" |
center_for |
" installations sportives pour les 49ers de San Francisco (Essayer).
filter: "(all center_for:"san francisco 49ers")" |
certification |
Films classés R par Wim Wenders" (Essayer)
filter: "(all type:/film/film contributor:wenders certification:r)" |
character |
"œuvres qui utilisent Papageno comme personnage (Essayez.)
filter: "(all character:papageno)" |
child |
&parents of Bill Clinton" (Essayer)
filter: "(all child:"bill clinton")" |
contributed_to |
"Qui a contribué à Blade Runner ?? (Essayer)
filter: "(all contributed_to:"Blade Runner")" |
contributor |
"movies de Steven Spielberg" (Essayer)
filter: "(all type:/film/film contributor:"Steven Spielberg")""films de Steven Spielberg& ; utilisant le MID au lieu du nom du contributeur (Essayer) filter: "(all type:/film/film contributor:/m/06pj8)""films avec Harrison Ford& ; (essayer) filter: "(all type:/film/film contributor:"Harrison Ford")" |
created |
"qui a créé " la sonnerie des sonneries&&39;" (Essayez.)
filter: "(all created:"for whom the bell tolls")" |
created_by |
"software by Google" (Essayer).
filter: "(all notable:software created_by:google)" |
discovered |
"discoverers of radium" (Essayer)
filter: "(all discovered:radium)" |
discovered_by |
"discoverys by Curie" (Essayer)
filter: "(all discovered_by:curie)" |
distributed_by |
&Nt shows (essayer).
filter: "(all type:show distributed_by:npr)" |
exhibited |
où la loi a été présentée (essayer).
filter: "(all exhibited:"down by law")" |
exhibited_at |
Éléments nominés au Festival de Cannes 2010 (Essayer)
filter: "(all type:"nominated work" exhibited_at:"2010 Cannes Film festival")" |
expressed_by |
"books in esperanto" (Essayer.)
filter: "(all type:book expressed_by:esperanto)" |
fictional_link |
Personnages fictifs associés à Mickey Mouse (Essayer)
filter: "(all type:/fictional_universe/fictional_character fiction_link:"mickey mouse")" |
genre |
"cathédrales gothiques (Essayer)
filter: "(all category:cathedral genre:gothic)""cathédrales gothiques de Viollet-le-duc& (Essayez) filter: "(all category:cathedral genre:gothic created_by:viollet)" |
identifies |
" Qu'est-ce qui identifie Southwest Airlines ? (Essayer)
filter: "(all identifies:"Southwest Airlines")" |
leader |
"Mitch Kapor organizations" (Essayer)
filter: "(all type:company leader:kapor)" |
leader_of |
Maires de Paris (Essayer)
filter: "(all title:mayor leader_of:paris)" |
made_of |
"cire peintures. (Essayer)
filter: "(all type:painting made_of:wax)" |
means_of_demise |
"exécuted politicians" (Essayer)
filter: "(all type:politician means_of_demise:"capital punishment")" |
member_of |
"monarques africains" (Essayer.)
filter: "(all type:monarch member_of:africa)"" Personnalités politiques et acteurs célèbres (Essayer) filter: "(all type:politician member_of:democratic notable:actor)" |
narrower_than |
Exemples de moteurs v8 (Essayer)
filter: "(all type:engine narrower_than:"v8 engine")" |
occurs_in |
"langues parlées en Roumanie (Essayer)
filter: "(all type:language occurs_in:romania)" |
origin |
&got gouverneurs républicains d'Autriche (Essayer)
filter: "(all title:governor member_of:republican origin:austria)" |
owner |
"s owns by Ford" (Essayer)
filter: "(all type:make owner:ford)" |
owns |
Le propriétaire des Mavericks (Essayer)
filter: "(all owns:mavericks)" |
parent |
Enfants d'Al Gore (Essayer)
filter: "(all parent:"al gore")""Descendants du langage de programmation Lisp (Essayer) filter: "(all type:/computer/programming_language parent:lisp)" |
part_of |
"swedish Lakes" (Essayer)
filter: "(all type:lake part_of:sweden)""concours des Jeux olympiques d'été de 2008& (Essayez.) filter: "(all type:competition part_of:"2008 summer olympics")" |
participant |
"Bowie concerts" (Essayer)
filter: "(all participant:bowie type:concert)" |
participated_in |
" Célèbres skieurs autrichiens qui ont participé aux Jeux olympiques (Essayer)
filter: "(all notable:skier member_of:austria participated_in:olympics)"' |
peer_of |
"politicians peers of Al Gore" (Essayer)
filter: "(all notable:politician peer_of:gore)" |
permits_use_of |
"Moteurs diesel" (Essayer)
filter: "(all permits_use_of:diesel)" |
portrayed |
acteurs qui ont dépeint John Lennon" (Essayer)
filter: "(all notable:actor portrayed:"john lennon")" |
portrayed_by |
personnages représentés par Harrison Ford& (Essayer)
filter: "(all portrayed_by:"Harrison Ford")" |
practitioner_of |
"avocats african-american" (Essayer.)
filter: "(all category:female category:"african american" practitioner_of:lawyer)" |
preceeding |
Suites du Seigneur des anneaux, les deux tours (Essayer)
filter: "(all type:/film/film preceeding:"The Lord of the Rings, the two Towers")" |
produced_by |
"Apple computer" (Essayer.)
filter: "(all type:computers produced_by:apple)" |
publication |
" quel livre a /m/0clw238 comme première édition quot; (Essayer.
filter: "(all publication:/m/0clw238)" |
publication_of |
Releases de La Traviata (Essayer)
filter: "(all publication_of:"La Traviata")" |
service_area |
&diffanteurs californiens (Essayer)
filter: "(all type:broadcaster service_area:california)" |
status |
" wiss glaciers glaciers" (Essayer)
filter: "(all type:glacier status:retreating part_of:switzerland)" |
subclass_of |
types de maillots de bain (Essayer)
filter: "(all subclass_of:swimwear)" |
subject |
"films sur l'Holocauste" (Essayer.)
filter: "(all type:film subject:holocaust)""livres sur les mathématiques" (Essayer) filter: "(all type:book subject:mathematics)" |
subsequent |
" préludes au Seigneur des anneaux, les deux tours (Essayer).
filter: "(all type:/film/film subsequent:"The Lord of the Rings, the two Towers")" |
succeeded_by |
" Automobile : la plate-forme Ford B3 a réussi ! (Essayer)
filter: "(all succeeded_by:"ford b3 platform")" |
succeeds |
"Qui a succédé à la maison de Stuart "></quot; (Essayer.)
filter: "(all succeeds:stuart)" |
superclass_of |
"Classes coronaropathie appartient à& (Essayer.)
filter: "(all superclass_of:"coronary heart disease")" |
title |
"Ingénieurs Google" (Essayer.)
filter: "(all title:engineer member_of:google)" |
tookplace_at |
Batailles qui ont eu lieu à Marengo (Essayer)
filter: "(all type:battles tookplace_at:marengo)" |
use_permitted_by |
"Fichiers compatibles avec l'iPhone" (Essayer)
filter: "(all type:"file format" use_permitted_by:iphone)" |
Évaluation et classement
Les entités Freebase ont un score de pertinence (classement) intrinsèque calculé en fonction de leur nombre de liens entrants et sortants dans Freebase et Wikipédia. Certaines entités Freebase populaires enregistrent également un score de popularité calculé par Google. Par défaut, les deux scores sont combinés lors des requêtes.
Lorsqu'une contrainte textuelle est présente, un score de correspondance textuel est calculé à partir du nombre d'appels renvoyés par l'index de recherche. Il est combiné au score de pertinence.
Les résultats FreebaseSearch sont toujours triés par score final (le score le plus élevé en premier).
Le paramètre de score permet de contrôler les composants du score de pertinence utilisés pour calculer le score final:
freebase: n'utilisez que le score de pertinence Freebase.
query: "beyoncé" scoring: freebase
entity : utilisez les deux niveaux de pertinence, qui remplacent les scores Google manquants à 1,0. Il s'agit de la valeur par défaut.
query: "beyoncé" scoring: entity
schema: utilisez cette option lorsque vous recherchez des entités de schéma telles que des types, des propriétés ou des domaines. Le nombre de liens des entités de schéma est calculé différemment.
query: "performance" scoring: schema
Autres contraintes
Les entités peuvent être filtrées par tag d'index avec ou sans les paramètres. Les entités sont marquées lors de l'indexation, chaque balise correspondant à une ou plusieurs requêtes Freebase qui seraient trop coûteuses pour s'exécuter lors de la recherche:
commons est une balise qui permet de limiter une recherche de schéma au renvoi uniquement d'un schéma Freebase Commons.
Par exemple, les types Freebase Commons correspondant au mot "color"
query: "color" type: "/type/type" with: "commons"
gg est une balise permettant de limiter une recherche aux entités pour lesquelles il existe un score de popularité Google.
query: "1923" type: "/people/person" with: "gg" query: "1923" type: "/people/person" without: "gg"
Le paramètre without est équivalent au"néga"dans une expression de filtre.
query: "color" limit: 5 type: "/type/type" without: "commons" query: "color" limit: 5 type: "/type/type" filter: "(not with:commons)"