Обзор
В дополнение к получению средних значений сущностей, оценок релевантности и отображаемых данных, помогающих людям понять совпадения запроса, также можно запросить, чтобы определенные структурированные данные сущностей возвращались с результатами через выходной параметр. Как и параметр фильтра, этот параметр представляет собой s-выражение, содержащее, возможно, вложенный список предикатов метасхемы или путей, для которых необходимо извлечь данные. Формат результата представляет собой двухуровневый вложенный список результатов, где первый уровень задается исходным предикатом или запрошенным путем (путями), а второй уровень задается фактическим возвращаемым путем (путями).
Например:
Найдите объекты с именем «Бегущий по лезвию» и верните их участников:
filter=(all name{phrase}:"Blade Runner")
&output=(contributor)Вывод схемы
Выходной параметр может быть вложен для запроса данных о сущностях, для которых данные возвращаются на уровне выше. Во вложенном списке вывода первый элемент — это то, что соединяет его с предыдущим уровнем (или с исходной сопоставленной сущностью), а остальные элементы относятся к сущностям, возвращенным на этом уровне.
Например:
Найдите президентов США и верните дату их рождения, а также date_of_birth их супругов:
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, возможно, отфильтрованный по ключевому слову происхождения, найденному в их полеvenance.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)
геокод
Возвращает данные геокодирования из объектов местоположения.
Например:
Найдите рестораны в пределах 300 футов от здания SF Ferry Building и верните их геокод и тип кухни.
filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955)) &output=(geocode practitioner_of)
ключ, ключ:пространство имен
Возвращает ключи/идентификаторы для сущностей, возможно, отфильтрованных по пространству имен.
Например:
Найдите рестораны в радиусе 300 м от здания 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