Обзор
Помимо получения средних значений сущностей, оценок релевантности и отображения данных, помогающих пользователям анализировать совпадения в запросе, можно также запросить возврат определённых структурированных данных сущностей вместе с результатами через параметр output. Как и параметр filter, этот параметр представляет собой S-выражение, содержащее, возможно, вложенный список предикатов или путей метасхемы для извлечения данных. Результат формируется в виде двухуровневого вложенного списка, где первый уровень определяется исходными запрошенными предикатами или путями, а второй — фактическими возвращёнными путями.
Например:
Найти сущности с названием «Бегущий по лезвию» и вернуть их авторов:
filter=(all name{phrase}:"Blade Runner")
&output=(contributor)Схема вывода
Параметр вывода может быть вложенным для запроса данных о сущностях, данные о которых возвращаются на уровне выше. Во вложенном списке вывода первый элемент связывает его с предыдущим уровнем (или с исходной совпавшей сущностью), а остальные элементы содержат информацию о сущностях, возвращаемых на этом уровне.
Например:
Найдите президентов США и выведите их дату рождения, а также дату рождения их супругов:
filter=(all type:/government/us_president) &output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))
Если через параметр lang запрашивается более одного языка отображения, возвращаются строки на всех языках, для которых имеются данные, с учетом порядка языков в запросе. Чтобы запросить возврат данных на всех индексированных языках, можно использовать специальный код языка d/all.
Например:
Найдите президентов США и верните категории и профессии их супругов на итальянском, русском, японском и английском языках:
filter=(all type:/government/us_president) &output=((/people/marriage/spouse category /people/person/profession)) &lang=it,ru,ja,en
Расширенный вывод
Выходной параметр поддерживает все индексированные предикаты метасхемы или сопоставления путей, а также ряд дополнительных ключевых слов, перечисленных ниже.
описание, описание:происхождение
Возвращает текст, найденный в триплетах /common/topic/description, возможно, отфильтрованный по ключевому слову originance, найденному в их поле provenance.process.
Например:
Найдите президентов США и верните их описания в графе знаний по источникам.
filter=(all type:/government/us_president) &output=(description)
Найдите президентов США и верните их описания в Википедии в графе знаний на английском и японском языках.
filter=(all type:/government/us_president) &output=(description:wikipedia) &lang=d/en,d/ja
средство устранения неоднозначности, средство устранения неоднозначности:тип, средство устранения неоднозначности:домен
Возвращает значения или сущности в путях с разрешающими свойствами (аннотированными с помощью /freebase/property_hints/disambiguator), возможно, отфильтрованные по типу или домену, содержащему эти свойства.
Например:
Найдите «бегущий по лезвию» и верните данные, разрешающие неоднозначность совпадений.
filter=(all name:"Blade Runner") &output=(disambiguator)
Найдите «бегущий по лезвию» и верните данные, разрешающие неоднозначность, из совпадений в /film/film
filter=(all name:"Blade Runner") &output=(disambiguator:/film/film)
геокодировать
Возвращает данные геокодирования из сущностей местоположения.
Например:
Найдите рестораны в радиусе 1000 футов от здания паромного терминала SF Ferry Building и укажите их геокод и тип кухни.
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
ключ, ключ:пространство имен
Возвращает ключи или идентификаторы сущностей, возможно отфильтрованные по пространству имен.
Например:
Найдите рестораны в радиусе 1000 футов от здания паромного терминала SF Ferry Building и верните их идентификатор Google+.
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(key:/authority/google/google_plus)
тип
Возвращает тип сущности, ранжированный по значимости, если эти данные доступны.
Например:
Найти «бегущий по лезвию» и вернуть данные о типе совпадений
filter=(all name:"Blade Runner") &output=(type)
несовместимый, несовместимый:тип
При использовании отдельно возвращает типы сущности, заведомо несовместимые друг с другом.
При использовании с типом возвращает информацию о том, является ли этот тип несовместимым с каким-либо из типов этой сущности.
При использовании с типом в параметре фильтра возвращает сущности, типы которых несовместимы с используемым.
Например:
Найти экземпляры /people/person, имеющие типы, несовместимые с ним, и вернуть их.
filter=(all type:/people/person incompatible:/people/person) &output=(incompatible)
все, все:тип, все:домен
Возвращает все данные, индексированные для сущности, которые могут быть возвращены через выходной параметр, возможно, отфильтрованные по типу или домену.
Например:
Найти «Сан-Франциско» и вернуть все данные о нём, доступные через выходной параметр.
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all)
&limit=1 Например:
Найти «Сан-Франциско» и вернуть все данные о нём в области местоположений, доступные через выходной параметр.
filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all:/location)
&limit=1