Panoramica
Oltre a ottenere i mid delle entità, i punteggi di pertinenza e i dati di visualizzazione che aiutano le persone a dare un senso alle corrispondenze di una query, è anche possibile richiedere che i dati strutturati di entità specifiche vengano restituiti con i risultati tramite il parametro di output. Come il parametro filtro, questo parametro è un'espressione S contenente un elenco possibilmente nidificato di predicati o percorsi metaschema per estrarre i dati. Il formato del risultato è un elenco nidificato a due livelli di risultati in cui il primo livello è basato sui predicati o sui percorsi originali richiesti e il secondo livello è basato sui percorsi effettivi restituiti.
Ad esempio:
Trova le entità denominate "Blade Runner" e restituisci i relativi collaboratori:
filter=(all name{phrase}:"Blade Runner")
&output=(contributor)Output dello schema
Il parametro di output può essere nidificato per richiedere dati sulle entità per le quali i dati vengono restituiti al livello superiore. In un elenco di output nidificato, il primo elemento è quello che lo collega al livello precedente (o all'entità corrispondente originale), mentre gli altri elementi riguardano le entità restituite a quel livello.
Ad esempio:
Trova i presidenti degli Stati Uniti e restituisci la loro data di nascita e quella dei loro coniugi:
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 lang, vengono restituite le stringhe in tutte le lingue per le quali sono presenti dati, rispettando l'ordine delle lingue nella richiesta. Per richiedere che i dati vengano restituiti in tutte le lingue indicizzate, è possibile utilizzare il codice di lingua speciale d/all.
Ad esempio:
Trova i presidenti degli Stati Uniti e restituisci le categorie e la professione dei loro coniugi 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 o le mappature dei percorsi del metaschema indicizzati e una serie di parole chiave aggiuntive elencate di seguito.
description, description:provenance
Restituisce il testo trovato nelle triple /common/topic/description, eventualmente filtrato in base a una parola chiave di provenienza trovata nel campo provenance.process.
Ad esempio:
Trova i 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 loro 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:domain
Restituisce i valori o le entità nei percorsi con proprietà disambiguanti (annotate con /freebase/property_hints/disambiguator), eventualmente filtrate in base a un tipo o a un dominio che contiene queste proprietà.
Ad esempio:
Trova "blade runner" e restituisci i dati di disambiguazione dalle corrispondenze
filter=(all name:"Blade Runner") &output=(disambiguator)
Trova "blade runner" e restituisci i dati di disambiguazione dalle corrispondenze in /film/film
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
geocode
Restituisce i dati di geocodifica dalle entità di località.
Ad esempio:
Trova ristoranti entro 300 metri dal SF Ferry Building e restituisci il loro geocodice 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 per le entità, possibilmente filtrati in base a uno spazio dei nomi.
Ad esempio:
Trova ristoranti entro 300 metri dal Ferry Building di San Francisco e restituisci il loro 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 notorietà quando i dati sono disponibili.
Ad esempio:
Trova "blade runner" e restituisci i dati del tipo dalle corrispondenze
filter=(all name:"Blade Runner") &output=(type)
incompatibile, incompatibile:type
Se utilizzato da solo, restituisce i tipi di un'entità nota per essere incompatibili tra loro.
Se utilizzato con un tipo, indica se questo tipo è noto per essere incompatibile con uno qualsiasi dei tipi di questa entità.
Se utilizzato con un tipo in un parametro di filtro, restituisce le entità con tipi incompatibili con quello utilizzato.
Ad esempio:
Trova le istanze di /people/person che hanno tipi incompatibili e restituiscile
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
all, all:type, all:domain
Restituisce tutti i dati indicizzati per un'entità che possono essere restituiti tramite il parametro di output, possibilmente filtrati per tipo o dominio.
Ad esempio:
Trova "san francisco" e restituisci tutti i dati relativi accessibili tramite il parametro di output
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all)
&limit=1Ad esempio:
Trova "san francisco" e restituisci tutti i dati nel dominio della località che lo riguardano e sono accessibili tramite il parametro di output
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all:/location)
&limit=1