- Restrições textuais
- Restrições de idioma
- Restrições do esquema
- Restrições do metaschema
- 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 da Freebase vêm do nome e dos aliases dela, das chaves e de outras propriedades textuais e, por fim, dos dados âncora da Wikipédia, se reconciliados com um tópico da Wikipédia específico do idioma.
As restrições textuais são específicas do idioma. Atualmente, 18 idiomas são compatíveis. O idioma inglês é o mais usado e é o idioma padrão.
Para ver uma lista de todos os códigos de idioma compatíveis no momento, acesse:
https://www.googleapis.com/freebase/v1/search?help=langs&indent=true
Uma restrição textual é especificada com o parâmetro query. O idioma dele é 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 uma forma específica ao idioma. Por exemplo, em inglês, o texto é convertido em letras 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 a correspondência de uma restrição textual. Definir o parâmetro prefixed como true aciona uma correspondência de prefixo apenas com 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 de origem apenas com nome e aliases (e uma correspondência regular em outros dados textuais). Esse tipo de correspondência pode ser usado para colar diferenças de sufixo de idiomas específicos introduzidos por plurais ou outras formas gramaticais. Exemplo:
query: "potatos" stemmed: true
Cercar o texto da consulta com aspas duplas ("") aciona uma correspondência de frase. Os tokens de texto da 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 fazer a correspondência com pessoas e entidades de pessoa cujo nome contém 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 ao name:
filter: "(all (not name:gore) alias:gore type:/people/person)"
Além de especificar quais campos de texto serão correspondidos, também é possível definir como a correspondência deverá ocorrer inserindo um dos seguintes modificadores entre o campo de operando e de texto:
-
{word}: exige que as palavras na string correspondam às palavras no campo de texto correspondente no documento. (padrão) {phrase}: exija que as palavras apareçam lado a lado na mesma ordem no campo de texto correspondente no documento.-
{full}: como{phrase}, mas também exige que a frase corresponda totalmente ao campo de texto, não apenas ao campo de texto. Em outras palavras, uma correspondência completa.
Por exemplo, para encontrar o single musical Casa 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 com 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 do resultado, já que a pesquisa sem custo financeiro pode receber um indicador de relevância específico do idioma da Wikipédia correspondente.
Atualmente, nove idiomas são compatíveis: 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 idioma inglês é o mais usado e é o idioma padrão.
Pesquisar com vários idiomas ao mesmo tempo
O parâmetro lang aceita uma lista separada por vírgulas de códigos de idioma que fazem a pesquisa ser feita em todos os idiomas especificados e os resultados são classificados no primeiro idioma listado e exibido no primeiro idioma da lista que tem um nome para a entidade.
Exemplo:
As seguintes pesquisas sobre a palavra alemã "quot;Sonnenblume" em alemão e francês". Além disso, ela classifica e exibe os resultados em francês:
query: "Sonnenblume" lang: "fr,de"
As pesquisas abaixo em inglês por filmes com coreano e que exibem o nome coreano desse 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 do esquema são especificadas com os parâmetros type e domain. type corresponde aos valores de propriedade /type/object/type de uma entidade.
Por exemplo, as seguintes ações restringem 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 código 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 de Freebase para filtrar uma consulta. Por exemplo, as restrições a seguir restringem uma pesquisa a pessoas do Canadá:
query "john" filter: "(all type:/people/person /people/person/nationality:"Canada")"
Restrições do metaschema
As restrições de Metaschema filtram entidades por predicados semânticos. Esses predicados são conceitos de nível superior criados com base em coleções de propriedades do Freebase que descrevem relações semânticas semelhantes.
As restrições do metaschema são especificadas usando os operandos de parâmetro filter combinados com um nome de entidade ou uma restrição de MID.
Operandos de filtro com suporte do Metaschema
Os seguintes operandos de filtro do Metaschema são compatíveis com a pesquisa do Freebase. Para testar cada exemplo, clique no link na tabela ou use o aplicativo de exemplo Freesearch Search.
| Nome do Operando | Exemplos |
|---|---|
abstraction |
"fettuccine pratos" (Experimente).
filter: "(all abstraction:fettuccine)" |
abstraction_of |
"class of the Western Bulwark locomotive" (Faça um teste.)
filter: "(all abstraction_of:"Western Bulwark")" |
adaptation |
"Works La Traviata é uma adaptação de" (experimente.)
filter: "(all adaptation_of:"La Traviata")" |
administered_by |
"Prêmios de Cannes" (Faça um teste).
filter: "(all type:awards administered_by:cannes)" |
administers |
"Quem administra o jornal sinapse?" Faça um teste.
filter: "(all administers:synapse)" |
appears_in |
"caracteres na Flauta Mágica" (Experimente.)
filter: "(all appears_in:"magic flute")""Figuran in der Zauberflöte" (Experimente.) filter: "(all appears_in:"Die Zauberflöte")" lang: "de" |
broader_than |
"linha de aeronave a que a Airbus 319 pertence" (faça um teste).
filter: "(all broader_than:"Airbus A319")" |
category |
"Francês atrizes" (Faça um teste).
filter: "(all category:female origin:france notable:actor)""Francês atrizes" (variante) (Faça um teste). filter: "(all category:female origin:france practitioner_of:actor)""califórnia ou vulcões franceses" (Faça um teste). filter: "(all category:volcano (any part_of:california part_of:france))" "receitas de massa" (Experimente.) filter: "(all category:pasta)" |
center |
companhias aéreas com um hub em São Francisco (faça um teste).
filter: "(all type:airline center:"San Francisco")""companhias aéreas com hubs em São Francisco e Atlanta" (experimente.) filter: "(all type:airline center:"San Francisco" center:atlanta)""jornais centralizados em São Francisco" (experimente). filter: "(all type:/book/newspaper center:/m/0d6lp)" |
center_for |
"Instalações esportivas para o São Francisco 49ers" (Experimente.)
filter: "(all center_for:"san francisco 49ers")" |
certification |
Filmes com classificação R de Wim Wenders" (Faça um teste).
filter: "(all type:/film/film contributor:wenders certification:r)" |
character |
"funciona que tenha Papageno como caractere" (experimente.)
filter: "(all character:papageno)" |
child |
"pais de Bill Clinton" (experimente.)
filter: "(all child:"bill clinton")" |
contributed_to |
"Quem contribuiu para o Blade Runner"><quot; Faça um teste.
filter: "(all contributed_to:"Blade Runner")" |
contributor |
"filmes de Steven Spielberg" (Faça um teste.)
filter: "(all type:/film/film contributor:"Steven Spielberg")""filmes de Steven Spielberg" usando o nome do usuário (MID, na sigla em inglês) em vez do nome do colaborador. Faça um teste. filter: "(all type:/film/film contributor:/m/06pj8)""filmes com Harrison Ford" (Faça um teste). filter: "(all type:/film/film contributor:"Harrison Ford")" |
created |
"quem criou 'para quem os pedágios'" (Experimente.)
filter: "(all created:"for whom the bell tolls")" |
created_by |
"software do Google" (Faça um teste).
filter: "(all notable:software created_by:google)" |
discovered |
"descobertores de radium" (Experimente.)
filter: "(all discovered:radium)" |
discovered_by |
"descobertas por Curie" (experimente.)
filter: "(all discovered_by:curie)" |
distributed_by |
"NPR shows" (Faça um teste.)
filter: "(all type:show distributed_by:npr)" |
exhibited |
"onde foi 'inferior a lei' apresentada smartlinquot; (tente.)
filter: "(all exhibited:"down by law")" |
exhibited_at |
Obras nomeadas exibidas no Festival de Cinema de Cannes de 2010 (Experimente).
filter: "(all type:"nominated work" exhibited_at:"2010 Cannes Film festival")" |
expressed_by |
"livros em esperanto" (Faça um teste).
filter: "(all type:book expressed_by:esperanto)" |
fictional_link |
"caracteres fictícios relacionados ao Mickey Mouse" (Faça um teste).
filter: "(all type:/fictional_universe/fictional_character fiction_link:"mickey mouse")" |
genre |
"catedrals góticas" (experimente.)
filter: "(all category:cathedral genre:gothic)"catedrals góticas de Viollet-le-duc" Faça um teste filter: "(all category:cathedral genre:gothic created_by:viollet)" |
identifies |
"O que identifica a Southwest Airlines{/7}quot; Faça um teste.
filter: "(all identifies:"Southwest Airlines")" |
leader |
"Mitch Kapor Company" (Faça um teste).
filter: "(all type:company leader:kapor)" |
leader_of |
"Paris prefeitos" (Teste agora)
filter: "(all title:mayor leader_of:paris)" |
made_of |
"pinturas de cera" (Experimente).
filter: "(all type:painting made_of:wax)" |
means_of_demise |
"executivos executados" (experimente.)
filter: "(all type:politician means_of_demise:"capital punishment")" |
member_of |
"monarcas africanos" (Experimente.)
filter: "(all type:monarch member_of:africa)""Política de democracia e atores importantes" (Faça um teste). filter: "(all type:politician member_of:democratic notable:actor)" |
narrower_than |
"exemplos de mecanismos v8" (Faça um teste).
filter: "(all type:engine narrower_than:"v8 engine")" |
occurs_in |
"idiomas falados na Romênia" (Experimente.)
filter: "(all type:language occurs_in:romania)" |
origin |
"Regovernadores republicanos da Áustria" (Experimente.)
filter: "(all title:governor member_of:republican origin:austria)" |
owner |
"fizer a propriedade da Ford" (Faça um teste).
filter: "(all type:make owner:ford)" |
owns |
"Quem é proprietário da Mavericks?" Faça um teste.
filter: "(all owns:mavericks)" |
parent |
"Al Gore's filhos" (Experimente.)
filter: "(all parent:"al gore")"" descendentes da linguagem de programação Lisp" (Faça um teste). filter: "(all type:/computer/programming_language parent:lisp)" |
part_of |
"lagos suecos" (experimente.)
filter: "(all type:lake part_of:sweden)""Competições nos Jogos Olímpicos de Verão de 2008" (Faça um teste). filter: "(all type:competition part_of:"2008 summer olympics")" |
participant |
"Bowie shows" (Faça um teste).
filter: "(all participant:bowie type:concert)" |
participated_in |
"Habilidades austríacas notáveis que participaram das Olimpíadas" (experimente.)
filter: "(all notable:skier member_of:austria participated_in:olympics)"' |
peer_of |
"políticas de apps semelhantes de Al Gore" (faça um teste).
filter: "(all notable:politician peer_of:gore)" |
permits_use_of |
"Mecanismos a diesel" (Experimente.)
filter: "(all permits_use_of:diesel)" |
portrayed |
"atores que retrataram John Lennon" (experimente.)
filter: "(all notable:actor portrayed:"john lennon")" |
portrayed_by |
"caracteres retratados por Harrison Ford" (Faça um teste.)
filter: "(all portrayed_by:"Harrison Ford")" |
practitioner_of |
"femininos afro-americanos africanos" (Experimente.)
filter: "(all category:female category:"african american" practitioner_of:lawyer)" |
preceeding |
"sequências para O Senhor dos Anéis, as duas Torres" (Faça um teste.)
filter: "(all type:/film/film preceeding:"The Lord of the Rings, the two Towers")" |
produced_by |
"Computadores da Apple" (tente fazer isso).
filter: "(all type:computers produced_by:apple)" |
publication |
"qual livro tem /m/0clw238 como primeira edição ?" (Faça um teste).
filter: "(all publication:/m/0clw238)" |
publication_of |
"lançamentos de La Traviata" (Faça um teste.)
filter: "(all publication_of:"La Traviata")" |
service_area |
"Califórnias emissoras" (Experimente.)
filter: "(all type:broadcaster service_area:california)" |
status |
"retreing swiss glaciers" (Experimente).
filter: "(all type:glacier status:retreating part_of:switzerland)" |
subclass_of |
"tipos de trajes de banho" (Experimente.)
filter: "(all subclass_of:swimwear)" |
subject |
"filmes sobre o Holocausto" (Experimente.)
filter: "(all type:film subject:holocaust)""livros sobre matemática" (experimente.) filter: "(all type:book subject:mathematics)" |
subsequent |
"prequetes do Senhor dos Anéis, as duas Torres" (Experimente.)
filter: "(all type:/film/film subsequent:"The Lord of the Rings, the two Towers")" |
succeeded_by |
"Qual plataforma automotiva foi bem-sucedida pela plataforma Ford B3 ? (Teste ela).
filter: "(all succeeded_by:"ford b3 platform")" |
succeeds |
"Quem conseguiu a House of Stuart ?" (Experimente).
filter: "(all succeeds:stuart)" |
superclass_of |
"As classes da doença cardíaca coronária pertencem ao" (experimente.)
filter: "(all superclass_of:"coronary heart disease")" |
title |
"Engenheiros do Google" (Faça um teste).
filter: "(all title:engineer member_of:google)" |
tookplace_at |
"batalhas que ocorreram no Marengo" (experimente.)
filter: "(all type:battles tookplace_at:marengo)" |
use_permitted_by |
"Formatos de arquivo aceitos em um iPhone" (Faça um teste.)
filter: "(all type:"file format" use_permitted_by:iphone)" |
Pontuação e classificação
As entidades da base livre têm uma pontuação de relevância inerente (classificação) calculada durante a indexação, que é função das contagens de links de entrada e saída na Freebase e na Wikipédia. Algumas entidades famosas 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 uma restrição textual está presente, 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 da FreebaseSearch sempre são classificados pela pontuação final, a mais alta primeiro.
Com o parâmetro "score", é possível controlar quais componentes de pontuação de relevância são usados para calcular a pontuação final:
freebase: use somente 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 para procurar entidades de esquema, como tipos, propriedades ou domínios. A contagem de links das entidades do esquema é calculada de modo 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 correspondente a uma ou várias consultas do Freebase que seriam muito caras para execução durante a pesquisa:
commons é uma tag que pode ser usada para restringir uma pesquisa de esquema para retornar apenas o esquema Freebase Commons.
Por exemplo, os tipos Freebase Commons, que correspondem à palavra "color"
query: "color" type: "/type/type" with: "commons"
gg é uma tag que pode ser usada para restringir uma pesquisa a entidades em que há 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 negado 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)"