Descripción general
Además de obtener los MIDs de las entidades, las puntuaciones de relevancia y los datos de visualización que ayudan a las personas a comprender las coincidencias de una búsqueda, también es posible solicitar que se muestren datos estructurados de entidades específicas con los resultados a través del parámetro de salida. Al igual que el parámetro de filtro, este parámetro es una expresión S que contiene una lista posiblemente anidada de predicados de metaesquema o rutas para extraer datos. El formato del resultado es una lista anidada de dos niveles de resultados en la que el primer nivel se basa en los predicados o las rutas originales solicitados, y el segundo nivel se basa en las rutas reales que se devolvieron.
Por ejemplo:
Encuentra entidades llamadas "Blade Runner" y muestra sus colaboradores:
filter=(all name{phrase}:"Blade Runner") &output=(contributor)
Salida del esquema
El parámetro de salida puede estar anidado para solicitar datos sobre las entidades para las que se muestran datos en el nivel superior. En una lista de salida anidada, el primer elemento es el que la conecta con el nivel anterior (o con la entidad coincidente original), y los demás elementos se refieren a las entidades que se muestran en ese nivel.
Por ejemplo:
Encuentra a los presidentes de EE.UU. y muestra su fecha de nacimiento, así como la de sus cónyuges:
filter=(all type:/government/us_president) &output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))
Cuando se solicitan más de un idioma de visualización a través del parámetro lang, se devuelven las cadenas en todos los idiomas para los que hay datos, respetando el orden de los idiomas en la solicitud. Para solicitar que se devuelvan los datos en todos los idiomas indexados, se puede usar el código de idioma especial d/all.
Por ejemplo:
Encuentra a los presidentes de EE.UU. y muestra las categorías y profesiones de sus cónyuges en italiano, ruso, japonés e inglés:
filter=(all type:/government/us_president) &output=((/people/marriage/spouse category /people/person/profession)) &lang=it,ru,ja,en
Salida avanzada
El parámetro de salida admite todos los predicados de metasquema o las asignaciones de rutas indexadas, y una cantidad de palabras clave adicionales que se indican a continuación.
description, description:provenance
Devuelve el texto que se encuentra en las triples /common/topic/description, posiblemente filtrado por una palabra clave de procedencia que se encuentra en su campo provenance.process.
Por ejemplo:
Encuentra a los presidentes de EE.UU. y muestra sus descripciones en el gráfico de conocimiento, por fuente
filter=(all type:/government/us_president) &output=(description)
Encuentra a los presidentes de EE.UU. y muestra sus descripciones de Wikipedia en el gráfico de conocimiento en inglés y japonés
filter=(all type:/government/us_president) &output=(description:wikipedia) &lang=d/en,d/ja
disambiguator, disambiguator:type, disambiguator:domain
Devuelve los valores o las entidades en rutas con propiedades de desambiguación (anotadas con /freebase/property_hints/disambiguator), posiblemente filtrados por un tipo o un dominio que contenga estas propiedades.
Por ejemplo:
Encuentra "Blade Runner" y muestra datos de desambiguación de las coincidencias
filter=(all name:"Blade Runner") &output=(disambiguator)
Encuentra "Blade Runner" y devuelve datos de desambiguación de las coincidencias en /film/film
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
Geocodificación
Devuelve los datos de geocodificación de las entidades de ubicación.
Por ejemplo:
Encuentra restaurantes a menos de 300 m del Ferry Building de San Francisco y devuelve su código geográfico y su tipo de cocina
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
key, key:namespace
Devuelve las claves o los IDs de las entidades, posiblemente filtrados por un espacio de nombres.
Por ejemplo:
Encuentra restaurantes a menos de 300 m del Ferry Building de San Francisco y muestra sus IDs de Google+
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(key:/authority/google/google_plus)
tipo
Devuelve el tipo de una entidad, clasificado por notoriedad cuando esos datos están disponibles.
Por ejemplo:
Encuentra "Blade Runner" y devuelve datos de tipo de las coincidencias
filter=(all name:"Blade Runner") &output=(type)
incompatible, incompatible:type
Cuando se usa por sí solo, devuelve los tipos de una entidad que se sabe que son incompatibles entre sí.
Cuando se usa con un tipo, devuelve si se sabe que este tipo es incompatible con cualquiera de los tipos de esta entidad.
Cuando se usa con un tipo en un parámetro de filtro, devuelve entidades que tienen tipos incompatibles con el que se usa.
Por ejemplo:
Encuentra instancias de /people/person que tengan tipos incompatibles con ella y devuélvelas
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
all, all:type, all:domain
Devuelve todos los datos indexados para una entidad que se puede devolver a través del parámetro de salida, posiblemente filtrados por un tipo o un dominio.
Por ejemplo:
Busca "San Francisco" y devuelve todos los datos sobre esa ciudad a los que se puede acceder a través del parámetro de salida
filter=(all name{full}:"San Francisco" type:/location/citytown) &output=(all) &limit=1
Por ejemplo:
Encuentra "San Francisco" y devuelve todos los datos en el dominio de ubicación sobre él a los que se puede acceder a través del parámetro de salida
filter=(all name{full}:"San Francisco" type:/location/citytown) &output=(all:/location) &limit=1