Panoramica
Oltre a ottenere medie entità, punteggi di pertinenza e dati sulla visualizzazione che aiutano gli utenti a capire le corrispondenze di una query, è anche possibile richiedere che vengano restituiti dati specifici delle entità tramite i parametri di output. Come il parametro del filtro, questo parametro è un'espressione s contenente un elenco possibilmente nidificato di predicati di metaschema o percorsi per l'estrazione dei dati. Il formato del risultato è un elenco nidificato di risultati a due livelli, in cui il primo livello è associato ai predicati o ai percorsi originali richiesti e il secondo livello ai percorsi effettivi restituiti.
Ad esempio:
Trova entità denominate "Blade Runner" e restituisci i relativi collaboratori:
filter=(all name{phrase}:"Blade Runner")
&output=(contributor)
Output schema
Il parametro di output può essere nidificato per richiedere i dati sulle entità per cui vengono restituiti i dati al livello precedente. In un elenco di output nidificato, il primo elemento è ciò che lo collega al livello precedente (o all'entità con corrispondenza originale) e gli altri elementi riguardano le entità restituite a quel livello.
Ad esempio:
Trova i presidenti degli Stati Uniti e restituiscono la loro data di nascita e i loro coniugi' data_of_birth:
filter=(all type:/government/us_president) &output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))
Quando vengono richieste più lingue di visualizzazione tramite il parametro long, in tutte le lingue per cui vengono restituiti i dati vengono rispettate l'ordine delle lingue della richiesta. Per richiedere la restituzione dei dati in tutte le lingue indicizzate, è possibile utilizzare il codice speciale d/all language.
Ad esempio:
Trova i presidenti degli Stati Uniti e i loro coniugi; categorie e professioni in italiano, russo, giapponese e inglese:
filter=(all type:/government/us_president) &output=((/people/marriage/spouse category /people/person/profession)) &lang=it,ru,ja,en
Output avanzato
Il parametro di output supporta tutti i predicati di metaschema o le mappature dei percorsi indicizzati e una serie di parole chiave aggiuntive elencate di seguito.
descrizione, descrizione:provenienza
Restituisce il testo trovato in triple /common/topic/description, possibilmente filtrato da una parola chiave provenienza. È stato trovato il campo originali.process.
Ad esempio:
Trova presidenti degli Stati Uniti e restituisci le loro descrizioni nel Knowledge Graph per fonte
filter=(all type:/government/us_president) &output=(description)
Trova i presidenti degli Stati Uniti e restituisci le descrizioni di wikipedia nel Knowledge Graph in inglese e giapponese
filter=(all type:/government/us_president) &output=(description:wikipedia) &lang=d/en,d/ja
disambiguator, disambiguator:type, disambiguator:dominio
Restituisce i valori o le entità in percorsi con proprietà di disambiguazione (con annotazioni /freebase/property_hints/disambiguator), eventualmente filtrate in base a un tipo o a un dominio contenente queste proprietà.
Ad esempio:
Trova "blade runner" e restituisce i dati di disambiguazione delle corrispondenze
filter=(all name:"Blade Runner") &output=(disambiguator)
Trova "blade runner" e restituisce i dati di disambiguazione delle corrispondenze in /film/film
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
geocodificata
Restituisce i dati geografici dalle entità della località.
Ad esempio:
Trova ristoranti nel raggio di 300 metri dall'edificio dei traghetti di San Francisco e restituisce il codice geografico e il tipo di cucina
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
key, key:namespace
Restituisce le chiavi/ o gli ID delle entità, possibilmente filtrati da uno spazio dei nomi.
Ad esempio:
Trova ristoranti nel raggio di 300 metri dall'edificio del traghetto e restituisci il suo ID Google+
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(key:/authority/google/google_plus)
tipo
Restituisce il tipo di un'entità, classificato in base alla rilevanza quando i dati sono disponibili.
Ad esempio:
Trova "blade runner" e dati sui tipi di resi dalle corrispondenze
filter=(all name:"Blade Runner") &output=(type)
non compatibile, non compatibile:type
Se utilizzato da solo, restituisce i tipi che appartengono a un'entità nota come incompatibile tra loro.
Se utilizzato con un tipo, restituisce se è noto che questo tipo è incompatibile con qualsiasi tipo di entità di questo tipo.
Quando viene utilizzato con un tipo in un parametro filtro, restituisce le entità con tipi incompatibili con quello utilizzato.
Ad esempio:
Trova istanze di /persone/persona che hanno tipi che non sono compatibili con il servizio e restituiscile
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
tutti, tutti:tipi, tutti:dominio
Restituisce tutti i dati indicizzati per un'entità che può essere restituita tramite il parametro di output, eventualmente filtrata in base a un tipo o a un dominio.
Ad esempio:
Find "san francisco" e restituisci tutti i dati pertinenti accessibili tramite il parametro output
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all)
&limit=1
Ad esempio:
Find "san francisco" e restituisci tutti i dati del dominio della località che sono accessibili tramite il parametro output
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all:/location)
&limit=1