Przegląd
Oprócz uzyskiwania identyfikatorów MID encji, wyników trafności i danych wyświetlania, które pomagają ludziom zrozumieć dopasowania zapytania, można też za pomocą parametru wyjściowego poprosić o zwrócenie z wynikami konkretnych uporządkowanych danych encji. Podobnie jak parametr filtra, ten parametr jest wyrażeniem S zawierającym prawdopodobnie zagnieżdżoną listę predykatów metaschematu lub ścieżek do wyodrębniania danych. Wynik ma postać dwupoziomowej zagnieżdżonej listy wyników, gdzie pierwszy poziom jest kluczowany na podstawie oryginalnych predykatów lub ścieżek, a drugi poziom jest kluczowany na podstawie zwróconych ścieżek.
Przykład:
Znajdź encje o nazwie „Blade Runner” i zwróć ich współtwórców:
filter=(all name{phrase}:"Blade Runner") &output=(contributor)
Dane wyjściowe schematu
Parametr wyjściowy może być zagnieżdżony, aby zażądać danych o podmiotach, dla których dane są zwracane na wyższym poziomie. Na zagnieżdżonej liście wyników pierwszy element łączy ją z poprzednim poziomem (lub z pasującym elementem źródłowym), a pozostałe elementy dotyczą elementów zwróconych na tym poziomie.
Przykład:
Znajdź prezydentów Stanów Zjednoczonych i zwróć ich datę urodzenia oraz datę urodzenia ich małżonków:
filter=(all type:/government/us_president) &output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))
Jeśli za pomocą parametru lang zażądasz więcej niż 1 języka wyświetlania, zwracane są ciągi tekstowe we wszystkich językach, dla których są dostępne dane, z zachowaniem kolejności języków w żądaniu. Aby poprosić o zwrócenie danych we wszystkich zindeksowanych językach, możesz użyć specjalnego kodu języka d/all.
Przykład:
Znajdź prezydentów Stanów Zjednoczonych i zwróć kategorie i zawody ich małżonków w języku angielskim, japońskim, rosyjskim i włoskim:
filter=(all type:/government/us_president) &output=((/people/marriage/spouse category /people/person/profession)) &lang=it,ru,ja,en
Zaawansowane dane wyjściowe
Parametr wyjściowy obsługuje wszystkie predykaty metaschematu lub zindeksowane mapowania ścieżek oraz kilka dodatkowych słów kluczowych wymienionych poniżej.
description, description:provenance
Zwraca tekst znaleziony w trójkach /common/topic/description, ewentualnie przefiltrowany według słowa kluczowego pochodzenia znalezionego w polu provenance.process.
Przykład:
Znajdź prezydentów Stanów Zjednoczonych i zwróć ich opisy w grafie wiedzy według źródła
filter=(all type:/government/us_president) &output=(description)
Znajdź prezydentów Stanów Zjednoczonych i wyświetl ich opisy z Wikipedii w Grafie wiedzy w języku angielskim i japońskim
filter=(all type:/government/us_president) &output=(description:wikipedia) &lang=d/en,d/ja
disambiguator, disambiguator:type, disambiguator:domain
Zwraca wartości lub jednostki w ścieżkach z właściwościami rozróżniającymi (oznaczonymi adnotacją /freebase/property_hints/disambiguator), które mogą być filtrowane według typu lub domeny zawierającej te właściwości.
Przykład:
Znajdź „blade runner” i zwróć dane disambiguating z pasujących wyników
filter=(all name:"Blade Runner") &output=(disambiguator)
Znajdź „blade runner” i zwróć dane rozróżniające z pasujących wyników w /film/film
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
kod geograficzny
Zwraca dane geokodowania z encji lokalizacji.
Przykład:
Znajdź restauracje w odległości 300 m od budynku SF Ferry Building i zwróć ich geokod oraz rodzaj kuchni.
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
klucz, klucz:przestrzeń nazw
Zwraca klucze lub identyfikatory jednostek, które mogą być filtrowane według przestrzeni nazw.
Przykład:
Znajdź restauracje w odległości 300 m od Ferry Building w San Francisco i zwróć ich identyfikatory Google+
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(key:/authority/google/google_plus)
typ
Zwraca typ elementu, uszeregowany według popularności, jeśli te dane są dostępne.
Przykład:
Znajdź „blade runner” i zwróć dane o typie z dopasowań
filter=(all name:"Blade Runner") &output=(type)
niezgodne, niezgodne:typ
Gdy jest używana samodzielnie, zwraca typy elementu, które są ze sobą niezgodne.
Gdy jest używany z typem, zwraca informację, czy ten typ jest niezgodny z którymkolwiek z typów tej encji.
Jeśli jest używany z typem w parametrze filtra, zwraca encje, których typy są niezgodne z używanym typem.
Przykład:
Znajdź wystąpienia elementu /people/person, które mają typy niezgodne z tym elementem, i zwróć je.
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
all, all:type, all:domain
Zwraca wszystkie dane zindeksowane dla jednostki, które można zwrócić za pomocą parametru wyjściowego, ewentualnie przefiltrowane według typu lub domeny.
Przykład:
Znajdź „san francisco” i zwróć wszystkie dane o tym mieście, które są dostępne za pomocą parametru wyjściowego.
filter=(all name{full}:"San Francisco" type:/location/citytown) &output=(all) &limit=1
Przykład:
Znajdź „san francisco” i zwróć wszystkie dane w domenie lokalizacji, które są dostępne za pomocą parametru wyjściowego.
filter=(all name{full}:"San Francisco" type:/location/citytown) &output=(all:/location) &limit=1