Résultats de recherche

  1. Présentation
  2. Sortie du schéma
  3. Sortie avancée

Présentation

En plus d'obtenir des mids d'entités, des scores de pertinence et des 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 d'entités spécifiques soient renvoyées avec les résultats via le paramètre de sortie. Comme le paramètre de filtre, ce paramètre est une s-expression contenant une liste éventuellement imbriquée de prédicats de métaschéma ou de chemins d'accès pour extraire les données. Le format du résultat est une liste imbriquée à deux niveaux. 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.

Exemple :
Trouver les entités nommées "Blade Runner" et renvoyer leurs contributeurs :

filter=(all name{phrase}:"Blade Runner")
&output=(contributor)

Sortie du schéma

Le paramètre de sortie peut être imbriqué pour demander des données sur les entités pour lesquelles des données sont renvoyées au niveau supérieur. Dans une liste de sortie imbriquée, le premier élément est celui qui la relie au niveau précédent (ou à l'entité correspondante d'origine). Les autres éléments concernent les entités renvoyées à ce niveau.

Exemple :
Trouve les présidents des États-Unis et renvoie leur date de naissance ainsi que celle de leur conjoint :

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 de toutes les langues pour lesquelles il existe des données sont renvoyées, en respectant l'ordre des langues dans la requête. Pour demander que les données soient renvoyées dans toutes les langues indexées, vous pouvez utiliser le code de langue spécial d/all.

Exemple :
Trouve les présidents américains et renvoie les catégories et professions de leurs conjoints, 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

Sortie avancée

Le paramètre de sortie est compatible avec tous les prédicats ou mappages de chemin du métaschéma indexés, ainsi qu'avec un certain nombre de mots clés supplémentaires listés ci-dessous.

description, description:provenance

Renvoie le texte trouvé dans les triplets /common/topic/description, éventuellement filtré par un mot clé de provenance trouvé dans leur champ provenance.process.

Par exemple :
Trouve les présidents des États-Unis et renvoie leurs descriptions dans le Knowledge Graph, par source

filter=(all type:/government/us_president)
&output=(description)

Trouve les présidents américains et renvoie leurs descriptions Wikipédia dans le Knowledge Graph en anglais et en japonais.

filter=(all type:/government/us_president)
&output=(description:wikipedia)
&lang=d/en,d/ja

disambiguator, disambiguator:type, disambiguator:domain

Renvoie les valeurs ou les entités dans les chemins avec des propriétés de clarification (annotées avec /freebase/property_hints/disambiguator), éventuellement filtrées par un type ou un domaine contenant ces propriétés.

Exemple :
Trouve "blade runner" et renvoie les données de clarification des correspondances

filter=(all name:"Blade Runner")
&output=(disambiguator)

Trouve "blade runner" et renvoie les données de désambiguïsation des correspondances dans /film/film

filter=(all name:"Blade Runner")
&output=(disambiguator:/film/film)

geocode

Renvoie les données de géocodage des entités de localisation.

Par exemple :
Trouve les restaurants situés à moins de 300 mètres du Ferry Building de San Francisco et renvoie 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)

key, key:namespace

Renvoie les clés ou les ID des entités, éventuellement filtrés par un espace de noms.

Exemple :
Trouve les restaurants situés à moins de 300 mètres du Ferry Building de San Francisco et renvoie leur 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 notoriété lorsque ces données sont disponibles.

Exemple :
Trouver "blade runner" et renvoyer les données de type des correspondances

filter=(all name:"Blade Runner")
&output=(type)

incompatible, incompatible:type

Lorsqu'il est utilisé seul, renvoie les types d'une entité connus pour être incompatibles les uns avec les autres.
Lorsqu'il est utilisé avec un type, renvoie si ce type est connu pour être incompatible avec l'un des types de cette entité.
Lorsqu'il est utilisé avec un type dans un paramètre de filtre, renvoie les entités dont les types sont incompatibles avec celui utilisé.

Exemple :
Trouve les instances de /people/person qui ont des types incompatibles et renvoie-les.

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 :
Trouve "san francisco" et renvoie toutes les données accessibles à ce sujet via le paramètre de sortie

filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all)
&limit=1

Exemple :
Trouve "san francisco" et renvoie toutes les données du domaine géographique qui y sont associées et accessibles via le paramètre de sortie

filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all:/location)
&limit=1