概要
エンティティの MID、関連性スコア、クエリの一致を人間が理解するのに役立つ表示データを取得するだけでなく、出力パラメータを使用して、特定エンティティの構造化データを結果とともに返すようにリクエストすることもできます。フィルタ パラメータと同様に、このパラメータは、メタスキーマ述語または抽出するデータのパスのネストされたリストを含む可能性がある s 式です。結果の形式は、2 レベルのネストされた結果リストです。最初のレベルはリクエストされた元の述語またはパスをキーとし、2 番目のレベルは返された実際のパスをキーとします。
例:
「ブレードランナー」という名前のエンティティを見つけて、その貢献者を返します。
filter=(all name{phrase}:"Blade Runner")
&output=(contributor)スキーマ出力
出力パラメータは、上位レベルでデータが返されるエンティティに関するデータをリクエストするためにネストできます。ネストされた出力リストでは、最初の要素は前のレベル（または元の照合済みエンティティ）に接続するもので、他の要素はそのレベルで返されるエンティティに関するものです。
例:
米国大統領を検索し、その生年月日と配偶者の生年月日を返します。
filter=(all type:/government/us_president) &output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))
lang パラメータで複数の表示言語がリクエストされた場合、データが存在するすべての言語の文字列が、リクエスト内の言語の順序に従って返されます。インデックス登録されているすべての言語でデータを返すようにリクエストするには、特別な言語コード d/all を使用します。
例:
米国大統領を検索し、配偶者のカテゴリと職業をイタリア語、ロシア語、日本語、英語で返します。
filter=(all type:/government/us_president) &output=((/people/marriage/spouse category /people/person/profession)) &lang=it,ru,ja,en
高度な出力
出力パラメータは、インデックス登録されたすべてのメタスキーマ述語またはパス マッピングと、以下に示すいくつかの追加キーワードをサポートしています。
description、description:provenance
/common/topic/description の 3 つ組で検出されたテキストを返します。このテキストは、その provenance.process フィールドで検出された来歴キーワードでフィルタされる場合があります。
例:
米国の歴代大統領を検索し、ナレッジグラフ内の説明をソース別に返す
filter=(all type:/government/us_president) &output=(description)
米国大統領を検索し、英語と日本語のナレッジグラフで Wikipedia の説明を返す
filter=(all type:/government/us_president) &output=(description:wikipedia) &lang=d/en,d/ja
disambiguator、disambiguator:type、disambiguator:domain
曖昧さを解消するプロパティ（/freebase/property_hints/disambiguator でアノテーションが付けられている）を含むパスの値またはエンティティを返します。これらのプロパティを持つ型またはドメインでフィルタリングされる可能性があります。
例:
「ブレードランナー」を検索し、一致するデータから曖昧さ回避データを返す
filter=(all name:"Blade Runner") &output=(disambiguator)
「ブレードランナー」を検索し、/film/film の一致から曖昧さ回避データを返す
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
ジオコード
位置情報エンティティからジオコードデータを返します。
例:
サンフランシスコ フェリー ビルディングから 1,000 フィート以内のレストランを検索し、そのジオコードと料理の種類を返して
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
key、key:namespace
エンティティのキーまたは ID を返します。名前空間でフィルタリングできます。
例:
SF フェリー ビルディングから 1,000 フィート以内のレストランを検索し、その Google+ ID を返して
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(key:/authority/google/google_plus)
type
データが利用可能な場合、エンティティのタイプを知名度順にランク付けして返します。
例:
「ブレードランナー」を検索し、一致するデータから型データを返す
filter=(all name:"Blade Runner") &output=(type)
incompatible、incompatible:type
単独で使用すると、互換性がないことがわかっているエンティティの型を返します。
型とともに使用すると、この型がこのエンティティの型のいずれかと互換性がないことがわかっているかどうかを返します。
フィルタ パラメータの型とともに使用すると、使用されている型と互換性のない型を持つエンティティを返します。
例:
/people/person のインスタンスのうち、互換性のない型を持つものを検索して返す
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
all、all:type、all:domain
出力パラメータで返されるエンティティのインデックス付きデータをすべて返します。タイプまたはドメインでフィルタリングされる場合があります。
例:
「san francisco」を検索し、出力パラメータを介してアクセス可能なすべてのデータを返す
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all)
&limit=1例:
「san francisco」を検索し、出力パラメータを介してアクセス可能な、その場所に関するすべてのデータを返す
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all:/location)
&limit=1