Visão geral
Além de obter mids de entidades, pontuações de relevância e dados de exibição que ajudam os humanos a entender as correspondências de uma consulta, também é possível solicitar que dados estruturados de entidades específicas sejam retornados com os resultados usando o parâmetro de saída. Assim como o parâmetro de filtro, esse parâmetro é uma expressão S que contém uma lista possivelmente aninhada de predicados de metaesquema ou caminhos para extrair dados. O formato do resultado é uma lista aninhada de dois níveis em que o primeiro nível é baseado nos predicados ou caminhos originais solicitados, e o segundo nível é baseado nos caminhos reais retornados.
Por exemplo:
Encontre entidades chamadas "Blade Runner" e retorne os colaboradores delas:
filter=(all name{phrase}:"Blade Runner") &output=(contributor)
Saída do esquema
O parâmetro de saída pode ser aninhado para solicitar dados sobre entidades para as quais os dados são retornados no nível acima. Em uma lista de saída aninhada, o primeiro elemento é o que a conecta ao nível anterior (ou à entidade correspondente de origem), e os outros elementos são sobre as entidades retornadas nesse nível.
Por exemplo:
Encontre os presidentes dos EUA e retorne a data de nascimento deles e dos cônjuges:
filter=(all type:/government/us_president) &output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))
Quando mais de um idioma de exibição é solicitado pelo parâmetro "lang", as strings em todos os idiomas para os quais há dados são retornadas, respeitando a ordem dos idiomas na solicitação. Para solicitar que os dados sejam retornados em todos os idiomas indexados, use o código de idioma especial d/all.
Por exemplo:
Encontre os presidentes dos EUA e retorne as categorias e profissões dos cônjuges em italiano, russo, japonês e inglês:
filter=(all type:/government/us_president) &output=((/people/marriage/spouse category /people/person/profession)) &lang=it,ru,ja,en
Saída avançada
O parâmetro de saída é compatível com todos os predicados de metaesquema ou mapeamentos de caminhos indexados e várias palavras-chave extras listadas abaixo.
description, description:provenance
Retorna o texto encontrado em triplas /common/topic/description, possivelmente filtrado por uma palavra-chave de procedência encontrada no campo provenance.process.
Por exemplo:
Encontre os presidentes dos EUA e retorne as descrições deles no Mapa de informações, por fonte
filter=(all type:/government/us_president) &output=(description)
Encontre presidentes dos EUA e retorne as descrições da Wikipédia no gráfico de conhecimento em inglês e japonês
filter=(all type:/government/us_president) &output=(description:wikipedia) &lang=d/en,d/ja
disambiguator, disambiguator:type, disambiguator:domain
Retorna os valores ou entidades em caminhos com propriedades de desambiguação (anotadas com /freebase/property_hints/disambiguator), possivelmente filtrados por um tipo ou um domínio que contém essas propriedades.
Por exemplo:
Encontre "blade runner" e retorne dados de desambiguação das correspondências
filter=(all name:"Blade Runner") &output=(disambiguator)
Encontre "blade runner" e retorne dados de desambiguação de correspondências em /film/film
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
geocode
Retorna os dados de geocodificação das entidades de local.
Por exemplo:
Encontre restaurantes a 300 metros do SF Ferry Building e retorne o geocódigo e o tipo de culinária
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
key, key:namespace
Retorna as chaves ou os IDs das entidades, possivelmente filtrados por um namespace.
Por exemplo:
Encontre restaurantes a 300 metros do Ferry Building de São Francisco e retorne o ID do Google+ deles
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(key:/authority/google/google_plus)
tipo
Retorna o tipo de uma entidade, classificada por notoriedade quando esses dados estão disponíveis.
Por exemplo:
Encontre "blade runner" e retorne dados de tipo das correspondências
filter=(all name:"Blade Runner") &output=(type)
incompatible, incompatible:type
Quando usado sozinho, retorna os tipos em uma entidade que se sabe serem incompatíveis entre si.
Quando usado com um tipo, retorna se esse tipo é conhecido por ser incompatível com algum dos tipos dessa entidade.
Quando usado com um tipo em um parâmetro de filtro, retorna entidades que têm tipos incompatíveis com o usado.
Por exemplo:
Encontre instâncias de /people/person que tenham tipos incompatíveis com ele e retorne-as
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
all, all:type, all:domain
Retorna todos os dados indexados de uma entidade que podem ser retornados pelo parâmetro de saída, possivelmente filtrados por um tipo ou domínio.
Por exemplo:
Encontre "san francisco" e retorne todos os dados acessíveis sobre ela pelo parâmetro de saída
filter=(all name{full}:"San Francisco" type:/location/citytown) &output=(all) &limit=1
Por exemplo:
Encontre "san francisco" e retorne todos os dados no domínio de local sobre isso que estão acessíveis pelo parâmetro de saída
filter=(all name{full}:"San Francisco" type:/location/citytown) &output=(all:/location) &limit=1