- Restrições textuais
- Restrições de idioma
- Restrições de esquema
- Restrições de metasquema
- Pontuação e classificação
- Outras restrições
Esta página contém uma lista de receitas para diferentes maneiras de restringir consultas de pesquisa usando o Serviço de pesquisa.
Restrições textuais
Os dados textuais de uma entidade do Freebase vêm primeiro do nome e dos aliases dela, depois das chaves e de outras propriedades textuais e, por fim, dos dados de âncora da Wikipédia, se ela foi reconciliada com um tópico da Wikipédia específico de um idioma.
As restrições textuais são específicas de um idioma. No momento, 18 idiomas são compatíveis. O inglês tem de longe a maior cobertura e é o idioma padrão.
Para conferir uma lista de todos os códigos de idioma compatíveis atualmente, acesse:
https://www.googleapis.com/freebase/v1/search?help=langs&indent=true
Uma restrição textual é especificada com o parâmetro query. O idioma é especificado com o parâmetro lang. Exemplo:
query: "gore" query: "gore" lang: "fr" query: "gore" lang: "de"
Durante a indexação, os dados textuais são normalizados de maneira específica para cada idioma. Por exemplo, em inglês, o texto é convertido em minúsculas e os acentos são removidos. No momento da consulta, a mesma normalização específica do idioma é realizada no texto da consulta. Exemplo:
query: "beyoncé" query: "beyonce"
Vários parâmetros controlam como uma restrição textual é correspondida. Definir o parâmetro prefixed como true aciona uma correspondência de prefixo apenas em nome e aliases (e uma correspondência regular em outros dados textuais). Exemplo:
query: "bob dy" prefixed: true
Definir stemmed como true aciona uma correspondência com radicalização apenas em nome e aliases (e uma correspondência regular em outros dados textuais). As correspondências com radicalização podem ser usadas para substituir diferenças de sufixos específicos do idioma introduzidas por plurais ou outras formas gramaticais. Exemplo:
query: "potatos" stemmed: true
Colocar o texto da consulta entre aspas duplas ("") aciona uma correspondência de frase. Os tokens de texto na consulta precisam aparecer lado a lado nos dados textuais da entidade correspondente. Exemplo:
query: "\"to be or not to be\""
Use os parâmetros name, alias e type para corresponder a pessoas e entidades de pessoas cujo nome contenha a palavra que você quer corresponder. Exemplo:
filter: "(all name:gore alias:gore type:/people/person)"
Da mesma forma, o exemplo a seguir corresponde a entidades /people/person com um alias correspondente apenas e não o name delas:
filter: "(all (not name:gore) alias:gore type:/people/person)"
Além de especificar quais campos de texto devem ser correspondidos, também é possível especificar como a correspondência deve ocorrer inserindo um dos seguintes modificadores entre o operando e o campo de texto:
-
{word}: exige que as palavras na string correspondam às palavras no campo de texto correspondente no documento. (padrão) {phrase}: exigem que as palavras apareçam lado a lado na mesma ordem no campo de texto correspondente do documento.-
{full}: como{phrase}, mas também exige que a frase corresponda completamente ao campo de texto, não apenas dentro dele. Em outras palavras, uma correspondência exata.
Por exemplo, para encontrar o single Home de Marc Broussard, use um filtro como este:
filter: "(all type:/music/single name{full}:home /music/track/artist:"Marc Broussard")"Restrições de idioma
Conforme descrito nas restrições textuais, o parâmetro lang é usado para especificar quais regras de normalização de linguagem usar para transformar texto em tokens de consulta. O idioma da consulta também condiciona a classificação dos resultados, já que a pesquisa do Freebase recebe um indicador de relevância específico do idioma da Wikipédia correspondente.
No momento, há suporte para nove idiomas: inglês (en), espanhol (es), francês (fr), alemão (de), italiano (it), português (pt), chinês (zh), japonês (ja) e coreano (ko). O inglês tem de longe a maior cobertura e é o idioma padrão.
Pesquisar em vários idiomas ao mesmo tempo
O parâmetro lang aceita uma lista separada por vírgulas de códigos de idioma que fazem com que a pesquisa seja feita em todos os idiomas especificados e os resultados sejam classificados no primeiro idioma listado e exibidos no primeiro idioma da lista que tem um nome para a entidade.
Exemplo:
A pesquisa a seguir procura a palavra alemã "Sonnenblume" em alemão e francês. Ele classifica e mostra os resultados em francês:
query: "Sonnenblume" lang: "fr,de"
As pesquisas a seguir em inglês procuram filmes em coreano e mostram o nome deles nesse idioma. A parte em inglês da consulta é a palavra "korean" na restrição expressed_by:
filter: "(all expressed_by:korean type:/film/film)" lang: "ko,en"
Restrições de esquema
As restrições de esquema são especificadas com os parâmetros type e domain. type corresponde aos valores da propriedade /type/object/type de uma entidade.
Por exemplo, o seguinte restringe uma pesquisa apenas a pessoas:
query: "gore" type: "/people/person"
domain corresponde aos valores /type/type/domain de todos os valores /type/object/type de uma entidade.
Por exemplo, o comando a seguir restringe uma pesquisa a entidades em francês apenas no domínio /film:
query: "babar" domain: "/film" lang: "fr"
Também é possível usar propriedades individuais do Freebase para filtrar uma consulta. Por exemplo, o seguinte restringe uma pesquisa a pessoas do Canadá:
query "john" filter: "(all type:/people/person /people/person/nationality:"Canada")"
Restrições de metaesquema
As restrições de metasquema filtram entidades por predicados semânticos. Esses predicados são conceitos de nível mais alto criados com base em coleções de propriedades da Freebase que descrevem relações semânticas semelhantes.
As restrições de metaesquema são especificadas usando os operandos do parâmetro filter combinados com um nome de entidade ou uma restrição de MID.
Operandos de filtro do Metaschema compatíveis
A Pesquisa do Freebase é compatível com os seguintes operandos de filtro do Metaschema. Clique no link na tabela ou use o Freebase Search Example App para testar cada exemplo.
| Nome do operando | Exemplos |
|---|---|
abstraction |
"pratos de fettuccine" (Teste.)
filter: "(all abstraction:fettuccine)" |
abstraction_of |
"classe da locomotiva Western Bulwark" (Teste agora.)
filter: "(all abstraction_of:"Western Bulwark")" |
adaptation |
"Works La Traviata is an adaptation of" (Teste agora.)
filter: "(all adaptation_of:"La Traviata")" |
administered_by |
"Prêmios de Cannes" (Teste agora.)
filter: "(all type:awards administered_by:cannes)" |
administers |
"Quem administra o jornal Synapse?" (Faça um teste.)
filter: "(all administers:synapse)" |
appears_in |
"personagens da Flauta Mágica" (Teste agora.)
filter: "(all appears_in:"magic flute")" filter: "(all appears_in:"Die Zauberflöte")" lang: "de" |
broader_than |
"linha de aeronaves a que o Airbus 319 pertence" (Teste agora.)
filter: "(all broader_than:"Airbus A319")" |
category |
"atrizes francesas" (Teste agora.)
filter: "(all category:female origin:france notable:actor)" filter: "(all category:female origin:france practitioner_of:actor)" filter: "(all category:volcano (any part_of:california part_of:france))" "pratos de massa" (Teste agora.) filter: "(all category:pasta)" |
center |
"companhias aéreas com um hub em São Francisco" (Teste agora.)
filter: "(all type:airline center:"San Francisco")" filter: "(all type:airline center:"San Francisco" center:atlanta)" filter: "(all type:/book/newspaper center:/m/0d6lp)" |
center_for |
"instalações esportivas do San Francisco 49ers" (Teste agora.)
filter: "(all center_for:"san francisco 49ers")" |
certification |
"Filmes com classificação R de Wim Wenders" (Teste agora.)
filter: "(all type:/film/film contributor:wenders certification:r)" |
character |
"obras que têm Papageno como personagem" (Teste agora.)
filter: "(all character:papageno)" |
child |
"pais de Bill Clinton" (teste)
filter: "(all child:"bill clinton")" |
contributed_to |
"Quem contribuiu para Blade Runner?" (Faça um teste.)
filter: "(all contributed_to:"Blade Runner")" |
contributor |
"filmes de Steven Spielberg" (Teste.)
filter: "(all type:/film/film contributor:"Steven Spielberg")" filter: "(all type:/film/film contributor:/m/06pj8)" filter: "(all type:/film/film contributor:"Harrison Ford")" |
created |
"quem criou 'por quem os sinos dobram'" (Teste agora.)
filter: "(all created:"for whom the bell tolls")" |
created_by |
"software do Google" (Teste agora.)
filter: "(all notable:software created_by:google)" |
discovered |
"descobridores do rádio" (Faça um teste.)
filter: "(all discovered:radium)" |
discovered_by |
"descobertas de Curie" (Teste agora.)
filter: "(all discovered_by:curie)" |
distributed_by |
"Programas da NPR" (Teste agora.)
filter: "(all type:show distributed_by:npr)" |
exhibited |
"Onde 'Down by Law' foi apresentado?" (Teste.)
filter: "(all exhibited:"down by law")" |
exhibited_at |
"obras indicadas exibidas no Festival de Cannes de 2010" (Teste agora.)
filter: "(all type:"nominated work" exhibited_at:"2010 Cannes Film festival")" |
expressed_by |
"livros em esperanto" (Teste.)
filter: "(all type:book expressed_by:esperanto)" |
fictional_link |
"personagens fictícios relacionados ao Mickey Mouse" (Teste agora.)
filter: "(all type:/fictional_universe/fictional_character fiction_link:"mickey mouse")" |
genre |
"catedrais góticas" (faça um teste)
filter: "(all category:cathedral genre:gothic)" filter: "(all category:cathedral genre:gothic created_by:viollet)" |
identifies |
"O que identifica a Southwest Airlines?" (Faça um teste.)
filter: "(all identifies:"Southwest Airlines")" |
leader |
"Empresas de Mitch Kapor" (Teste agora.)
filter: "(all type:company leader:kapor)" |
leader_of |
"Prefeitos de Paris" (Teste agora.)
filter: "(all title:mayor leader_of:paris)" |
made_of |
"pinturas com cera" (Teste agora.)
filter: "(all type:painting made_of:wax)" |
means_of_demise |
"políticos executados" (Faça um teste.)
filter: "(all type:politician means_of_demise:"capital punishment")" |
member_of |
"monarcas africanos" (Teste agora.)
filter: "(all type:monarch member_of:africa)" filter: "(all type:politician member_of:democratic notable:actor)" |
narrower_than |
"exemplos de mecanismos v8" (Teste agora.)
filter: "(all type:engine narrower_than:"v8 engine")" |
occurs_in |
"idiomas falados na Romênia" (Teste agora.)
filter: "(all type:language occurs_in:romania)" |
origin |
"Governadores republicanos da Áustria" (Teste agora.)
filter: "(all title:governor member_of:republican origin:austria)" |
owner |
"marcas da Ford" (Teste agora.)
filter: "(all type:make owner:ford)" |
owns |
"Quem é o dono dos Mavericks?" (Faça um teste.)
filter: "(all owns:mavericks)" |
parent |
"Filhos de Al Gore" (Teste agora.)
filter: "(all parent:"al gore")" filter: "(all type:/computer/programming_language parent:lisp)" |
part_of |
"lagos suecos" (Teste agora.)
filter: "(all type:lake part_of:sweden)" filter: "(all type:competition part_of:"2008 summer olympics")" |
participant |
"Shows do Bowie" (Teste agora.)
filter: "(all participant:bowie type:concert)" |
participated_in |
"Esquiadores austríacos notáveis que participaram das Olimpíadas" (Teste agora.)
filter: "(all notable:skier member_of:austria participated_in:olympics)"' |
peer_of |
"políticos colegas de Al Gore" (Faça um teste.)
filter: "(all notable:politician peer_of:gore)" |
permits_use_of |
"Motores a diesel" (Faça um teste.)
filter: "(all permits_use_of:diesel)" |
portrayed |
"atores que interpretaram John Lennon" (Teste agora.)
filter: "(all notable:actor portrayed:"john lennon")" |
portrayed_by |
"personagens interpretados por Harrison Ford" (Teste agora.)
filter: "(all portrayed_by:"Harrison Ford")" |
practitioner_of |
"advogadas afro-americanas" (Teste agora.)
filter: "(all category:female category:"african american" practitioner_of:lawyer)" |
preceeding |
"sequências de O Senhor dos Anéis, as duas Torres" (Teste.)
filter: "(all type:/film/film preceeding:"The Lord of the Rings, the two Towers")" |
produced_by |
"Computadores Apple" (Faça um teste.)
filter: "(all type:computers produced_by:apple)" |
publication |
"qual livro tem /m/0clw238 como primeira edição?" (Teste agora.)
filter: "(all publication:/m/0clw238)" |
publication_of |
"lançamentos de La Traviata" (Teste agora.)
filter: "(all publication_of:"La Traviata")" |
service_area |
"Emissoras da Califórnia" (Teste agora.)
filter: "(all type:broadcaster service_area:california)" |
status |
"retração das geleiras suíças" (faça um teste)
filter: "(all type:glacier status:retreating part_of:switzerland)" |
subclass_of |
"tipos de roupa de banho" (Faça um teste.)
filter: "(all subclass_of:swimwear)" |
subject |
"filmes sobre o Holocausto" (teste agora)
filter: "(all type:film subject:holocaust)" filter: "(all type:book subject:mathematics)" |
subsequent |
"prequels to The Lord of the Rings, the two Towers" (Teste agora.)
filter: "(all type:/film/film subsequent:"The Lord of the Rings, the two Towers")" |
succeeded_by |
"Qual plataforma automotiva foi substituída pela plataforma Ford B3?" (Teste agora.)
filter: "(all succeeded_by:"ford b3 platform")" |
succeeds |
"Quem sucedeu a Casa de Stuart?" (Teste.)
filter: "(all succeeds:stuart)" |
superclass_of |
"Classes coronary heart disease belongs to" (Teste agora.)
filter: "(all superclass_of:"coronary heart disease")" |
title |
"Engenheiros do Google" (Teste agora.)
filter: "(all title:engineer member_of:google)" |
tookplace_at |
"batalhas que aconteceram em Marengo" (Teste agora.)
filter: "(all type:battles tookplace_at:marengo)" |
use_permitted_by |
"Formatos de arquivo compatíveis com um iPhone" (Teste agora.)
filter: "(all type:"file format" use_permitted_by:iphone)" |
Pontuação e classificação
As entidades do Freebase têm uma pontuação de relevância (classificação) inerente calculada durante a indexação, que é uma função das contagens de links de entrada e saída no Freebase e na Wikipédia. Algumas entidades conhecidas do Freebase também têm uma pontuação de popularidade calculada pelo Google. Por padrão, as duas pontuações são combinadas durante as consultas.
Quando há uma restrição textual, uma pontuação de correspondência textual é calculada com base no número de hits retornados pelo índice de pesquisa e combinada com a pontuação de relevância.
Os resultados do FreebaseSearch são sempre classificados pela pontuação final, da maior para a menor.
O parâmetro de pontuação permite controlar quais componentes de pontuação de relevância são usados para calcular a pontuação final:
freebase: use apenas a pontuação de relevância da Freebase.
query: "beyoncé" scoring: freebase
entity: use as duas pontuações de relevância, que substituem as pontuações ausentes do Google por 1,0. Esse é o padrão.
query: "beyoncé" scoring: entity
schema: use ao procurar entidades de esquema, como tipos, propriedades ou domínios. A contagem de links das entidades de esquema é calculada de maneira diferente.
query: "performance" scoring: schema
Outras restrições
As entidades podem ser filtradas por tag de índice usando os parâmetros "com" ou "sem". As entidades são marcadas durante a indexação. Cada tag corresponde a uma ou várias consultas do Freebase que seriam muito caras para serem executadas durante a pesquisa:
commons é uma tag que pode ser usada para restringir uma pesquisa de esquema a retornar apenas o esquema do Freebase Commons.
Por exemplo, tipos do Freebase Commons que correspondem à palavra "cor"
query: "color" type: "/type/type" with: "commons"
gg é uma tag que pode ser usada para restringir uma pesquisa a entidades que têm ou não uma pontuação de popularidade do Google.
query: "1923" type: "/people/person" with: "gg" query: "1923" type: "/people/person" without: "gg"
O parâmetro without é equivalente a um "a negated with" em uma expressão de filtro.
query: "color" limit: 5 type: "/type/type" without: "commons" query: "color" limit: 5 type: "/type/type" filter: "(not with:commons)"