Übersicht
Neben der Möglichkeit, Entity-MIDs, Relevanzwerte und Anzeigedaten abzurufen, die Menschen helfen, die Übereinstimmungen einer Anfrage zu verstehen, kann über den Ausgabeparameter auch angefordert werden, dass bestimmte strukturierte Daten von Entitäten mit den Ergebnissen zurückgegeben werden. Wie der Filterparameter ist dieser Parameter ein S-Ausdruck, der eine möglicherweise verschachtelte Liste von Metaschema-Prädikaten oder Pfaden zum Extrahieren von Daten enthält. Das Ergebnis ist eine zweistufige, verschachtelte Liste von Ergebnissen, wobei die erste Ebene auf den angeforderten ursprünglichen Prädikaten oder Pfaden und die zweite Ebene auf den zurückgegebenen tatsächlichen Pfaden basiert.
Beispiel:
Entitäten mit dem Namen „Blade Runner“ finden und ihre Mitwirkenden zurückgeben:
filter=(all name{phrase}:"Blade Runner")
&output=(contributor)Schemaausgabe
Der Ausgabeparameter kann verschachtelt werden, um Daten zu Einheiten anzufordern, für die Daten auf der Ebene darüber zurückgegeben werden. In einer verschachtelten Ausgabeliste ist das erste Element das, was sie mit der vorherigen Ebene (oder der ursprünglichen übereinstimmenden Entität) verbindet. Die anderen Elemente beziehen sich auf die auf dieser Ebene zurückgegebenen Entitäten.
Beispiel:
Finde US-Präsidenten und gib ihr Geburtsdatum sowie das Geburtsdatum ihrer Ehepartner an:
filter=(all type:/government/us_president) &output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))
Wenn über den Parameter „lang“ mehrere Anzeigesprachen angefordert werden, werden Strings in allen Sprachen zurückgegeben, für die Daten vorhanden sind. Dabei wird die Reihenfolge der Sprachen in der Anfrage berücksichtigt. Wenn Daten in allen indexierten Sprachen zurückgegeben werden sollen, kann der spezielle Sprachcode „d/all“ verwendet werden.
Beispiel:
Finde US-Präsidenten und gib die Kategorien und Berufe ihrer Ehepartner auf Italienisch, Russisch, Japanisch und Englisch zurück:
filter=(all type:/government/us_president) &output=((/people/marriage/spouse category /people/person/profession)) &lang=it,ru,ja,en
Erweiterte Ausgabe
Der Ausgabeparameter unterstützt alle indexierten Metaschema-Prädikate oder Pfadzuordnungen sowie eine Reihe zusätzlicher Keywords, die unten aufgeführt sind.
description, description:provenance
Gibt den Text zurück, der in /common/topic/description-Tripeln gefunden wurde, möglicherweise gefiltert nach einem Herkunftsschlüsselwort, das im Feld „provenance.process“ gefunden wurde.
Beispiel:
Finde US-Präsidenten und gib ihre Beschreibungen im Knowledge Graph nach Quelle zurück.
filter=(all type:/government/us_president) &output=(description)
Finde US-Präsidenten und gib ihre Wikipedia-Beschreibungen im Wissensdiagramm auf Englisch und Japanisch zurück.
filter=(all type:/government/us_president) &output=(description:wikipedia) &lang=d/en,d/ja
disambiguator, disambiguator:type, disambiguator:domain
Gibt die Werte oder Entitäten in Pfaden mit disambiguierenden Attributen zurück (mit /freebase/property_hints/disambiguator annotiert), die möglicherweise nach einem Typ oder einer Domain gefiltert werden, die diese Attribute enthält.
Beispiel:
Finde „Blade Runner“ und gib die Daten zur Begriffsklärung für die Treffer zurück.
filter=(all name:"Blade Runner") &output=(disambiguator)
Finde „Blade Runner“ und gib die Daten zur Begriffsklärung von Treffern in /film/film zurück.
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
Geocode
Gibt die Geocodedaten von Standortentitäten zurück.
Beispiel:
Finde Restaurants im Umkreis von 300 Metern um das Ferry Building in San Francisco und gib ihren Geocode und ihre Art der Küche zurück.
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
key, key:namespace
Gibt die Schlüssel oder IDs für Entitäten zurück, die möglicherweise nach einem Namespace gefiltert werden.
Beispiel:
Finde Restaurants im Umkreis von 300 Metern um das Ferry Building in San Francisco und gib ihre Google+-ID zurück.
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(key:/authority/google/google_plus)
Typ
Gibt den Typ für eine Entität zurück, der nach Bekanntheit eingestuft wird, wenn diese Daten verfügbar sind.
Beispiel
Finde „Blade Runner“ und gib Typdaten aus den Ergebnissen zurück.
filter=(all name:"Blade Runner") &output=(type)
incompatible, incompatible:type
Gibt bei alleiniger Verwendung die Typen einer Entität zurück, die bekanntermaßen inkompatibel sind.
Gibt bei Verwendung mit einem Typ zurück, ob dieser Typ bekanntermaßen mit einem der Typen dieser Entität inkompatibel ist.
Bei Verwendung mit einem Typ in einem Filterparameter werden Entitäten zurückgegeben, deren Typen mit dem verwendeten Typ inkompatibel sind.
Beispiel:
Finde Instanzen von /people/person, die inkompatible Typen haben, und gib sie zurück.
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
all, all:type, all:domain
Gibt alle für eine Entität indexierten Daten zurück, die über den Ausgabeparameter zurückgegeben werden können, möglicherweise gefiltert nach einem Typ oder einer Domain.
Beispiel:
Suche nach „San Francisco“ und gib alle Daten dazu zurück, auf die über den Ausgabeparameter zugegriffen werden kann.
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all)
&limit=1Beispiel
Suche nach „San Francisco“ und gib alle Daten in der Standortdomain dazu zurück, die über den Ausgabeparameter zugänglich sind.
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all:/location)
&limit=1