Présentation
En plus d'obtenir les métriques d'entité, les scores de pertinence et les données d'affichage qui aident les utilisateurs à comprendre les correspondances d'une requête, il est également possible de demander que des données structurées spécifiques à une entité soient renvoyées avec des résultats via le paramètre de sortie. À l'instar du paramètre de filtre, ce paramètre est une expression S contenant une liste éventuellement imbriquée de prédicats ou chemins d'accès aux métadonnées pour lesquels extraire des données. Le format des résultats est une liste imbriquée de résultats à deux niveaux, où le premier niveau est associé aux prédicats ou chemins d'origine demandés, et le second niveau est associé aux chemins réels renvoyés.
Par exemple :
Recherchez des entités nommées "Blade Runner" et renvoyez leurs contributeurs :
filter=(all name{phrase}:"Blade Runner")
&output=(contributor)
Résultat du schéma
Le paramètre de sortie peut être imbriqué pour demander des données sur des entités pour lesquelles des données sont renvoyées au niveau ci-dessus. Dans une liste de sortie imbriquée, le premier élément correspond à ce qui le connecte au niveau précédent (ou à l'entité correspondante d'origine), tandis que les autres éléments concernent les entités renvoyées à ce niveau.
Par exemple:
Identifiez les présidents américains et renvoyez leur date de naissance ainsi que leur conjoint(e) :
filter=(all type:/government/us_president) &output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))
Lorsque plusieurs langues d'affichage sont demandées via le paramètre "lang", les chaînes correspondant à toutes les langues contenant des données sont renvoyées, en respectant l'ordre des langues dans la requête. Pour demander le renvoi des données dans toutes les langues indexées, vous pouvez utiliser le code spécial d/toutes les langues.
Par exemple :
Recherchez des présidents aux États-Unis et renvoyez leurs conjoints et leur profession, en italien, en russe, en japonais et en anglais :
filter=(all type:/government/us_president) &output=((/people/marriage/spouse category /people/person/profession)) &lang=it,ru,ja,en
Résultat avancé
Le paramètre "output" accepte tous les prédicats ou les mappages de chemins de métadonnées indexés, ainsi qu'un certain nombre de mots clés supplémentaires répertoriés ci-dessous.
description, description:provenance
Renvoie le texte détecté dans les triples /common/topic/description , éventuellement filtrés par un mot clé de provenance , qui correspond au champ provenance.process.
Par exemple:
Rechercher des présidents aux États-Unis et afficher leur description dans le Knowledge Graph, par source
filter=(all type:/government/us_president) &output=(description)
Recherchez des présidents aux États-Unis et renvoyez leurs descriptions Wikipédia dans le Knowledge Graph en anglais ou en japonais.
filter=(all type:/government/us_president) &output=(description:wikipedia) &lang=d/en,d/ja
désambiguator, disambiguator:type, disambiguator:domain
Renvoie les valeurs ou les entités dans les chemins d'accès dont les propriétés sont ambiguës (annotées avec /freebase/property_hints/disambiguator ), éventuellement filtrées par un type ou un domaine contenant ces propriétés.
Par exemple:
Trouver le "Blade Runner" et renvoyer des données équivoques à partir de matchs
filter=(all name:"Blade Runner") &output=(disambiguator)
Trouver des Blade Runner et renvoyer des données ambiguës à partir de correspondances dans /film/film
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
géocode
Affiche les données de géocodage des entités de localisation.
Par exemple:
Rechercher des restaurants dans un rayon de 300 m autour du SF Ferry, puis renvoyer leur géocode et leur type de cuisine
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
clé, clé:espace de noms
Renvoie les clés/ ID des entités, éventuellement filtrées par un espace de noms.
Par exemple :
Trouver des restaurants dans un rayon de 300 m autour du SF Ferry et afficher son ID Google+
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(key:/authority/google/google_plus)
type
Renvoie le type d'une entité, classé par notabilité lorsque ces données sont disponibles.
Par exemple:
Rechercher des données sur le type "Blade Runner" et "Return Type" à partir des correspondances
filter=(all name:"Blade Runner") &output=(type)
incompatible, incompatible:type
Lorsqu'il est utilisé seul, il renvoie les types d'une entité connue pour être incompatible.
Utilisé avec un type. Indique si ce type est connu pour être incompatible avec l'un des types de cette entité.
Lorsque cet attribut est utilisé avec un type dans un paramètre de filtre, il renvoie les entités dont les types sont incompatibles avec celui utilisé.
Par exemple:
Rechercher des instances de /people/person dont les types ne sont pas compatibles et les renvoyer
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
all, all:type, all:domain
Renvoie toutes les données indexées pour une entité qui peuvent être renvoyées via le paramètre de sortie, éventuellement filtrées par type ou par domaine.
Par exemple :
Rechercher "San Francisco" et renvoyer toutes les données accessibles via le paramètre "output"
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all)
&limit=1
Par exemple :
Rechercher "San Francisco" et renvoyer toutes les données du domaine de l'emplacement qui sont accessibles via le paramètre "output"
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all:/location)
&limit=1