פלט חיפוש

  1. סקירה כללית
  2. פלט של סכימה
  3. פלט מתקדם

סקירה כללית

בנוסף לקבלת מזהי ישויות (MID), ציוני רלוונטיות ונתוני תצוגה שעוזרים לאנשים להבין את ההתאמות של שאילתה, אפשר גם לבקש שנתונים מובְנים של ישות ספציפית יוחזרו עם התוצאות באמצעות פרמטר הפלט. בדומה לפרמטר filter, הפרמטר הזה הוא ביטוי s-expression שמכיל רשימה של נתוני חיזוי של מטא-סכמה או נתיבים לחילוץ נתונים, שיכולה להיות רשימה מקוננת. פורמט התוצאה הוא רשימה מקוננת של תוצאות בשתי רמות, שבה הרמה הראשונה מבוססת על פרדיקטים או נתיבים מקוריים שהתבקשו, והרמה השנייה מבוססת על הנתיבים בפועל שהוחזרו.

לדוגמה:
חיפוש ישויות בשם Blade Runner והחזרת התורמים שלהן:

filter=(all name{phrase}:"Blade Runner")
&output=(contributor)

פלט הסכימה

יכול להיות שהפרמטר output יהיה מקונן כדי לבקש נתונים על ישויות שהנתונים שלהן מוחזרים ברמה שמעל. ברשימת פלט מוטמעת, הרכיב הראשון הוא מה שמקשר אותה לרמה הקודמת (או לישות התואמת המקורית), והרכיבים האחרים הם פרטים על הישויות שמוחזרות ברמה הזו.

לדוגמה:
חיפוש נשיאים בארה"ב והחזרת תאריך הלידה שלהם ושל בני/בנות הזוג שלהם:

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

פלט מתקדם

פרמטר הפלט תומך בכל הפרדיקטים של מטא-סכימה או מיפויי הנתיבים שנוספו לאינדקס, ובמספר מילות מפתח נוספות שמפורטות בהמשך.

description, description:provenance

הפונקציה מחזירה את הטקסט שנמצא בשלשות של /common/topic/description, שאולי סוננו לפי מילת מפתח של מקור שנמצאה בשדה provenance.process.

לדוגמה:
חיפוש נשיאים בארה"ב והצגת התיאורים שלהם בתרשים הידע, לפי מקור

filter=(all type:/government/us_president)
&output=(description)

Find US presidents and return their wikipedia descriptions in the knowledge graph in english and japanese

filter=(all type:/government/us_president)
&output=(description:wikipedia)
&lang=d/en,d/ja

disambiguator, disambiguator:type, disambiguator:domain

הפונקציה מחזירה את הערכים או הישויות בנתיבים עם מאפיינים שמבחינים בין ישויות (מסומנים ב-‎ /freebase/property_hints/disambiguator), יכול להיות שהיא מסננת לפי סוג או דומיין שמכילים את המאפיינים האלה.

לדוגמה:
Find "blade runner" and return disambiguating data from matches

filter=(all name:"Blade Runner")
&output=(disambiguator)

מחפש את 'blade runner' ומחזיר נתונים להסרת דו-משמעות מהתאמות ב-‎ /film/film

filter=(all name:"Blade Runner")
&output=(disambiguator:/film/film)

קואורדינטות

הפונקציה מחזירה את נתוני הקידוד הגיאוגרפי מישויות של מיקומים.

לדוגמה:
Find restaurants within 1000ft of the SF Ferry Building and return their geocode and their type of cuisine

filter=(all type:restaurant (within radius:1000ft lon:-122.39 lat:37.7955))
&output=(geocode practitioner_of)

key, key:namespace

הפונקציה מחזירה את המפתחות או המזהים של ישויות, ואפשר לסנן אותם לפי מרחב שמות.

לדוגמה:
Find restaurants within 1000ft of the SF Ferry Building and return their Google+ ID

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)

incompatible, incompatible:type

כשמשתמשים בו לבד, הוא מחזיר את הסוגים של ישות שידוע שהם לא תואמים זה לזה.
כשמשתמשים בו עם סוג, הוא מחזיר את הערך true אם ידוע שהסוג הזה לא תואם לאף אחד מהסוגים של הישות הזו.
כשמשתמשים בו עם סוג בפרמטר של מסנן, הפונקציה מחזירה ישויות עם סוגים שלא תואמים לסוג שבו נעשה שימוש.

לדוגמה:
למצוא מקרים של /people/person עם סוגים שלא תואמים לו ולהחזיר אותם

filter=(all type:/people/person incompatible:/people/person)
&output=(incompatible)

all, all:type, all:domain

הפונקציה מחזירה את כל הנתונים שנוספו לאינדקס של ישות שאפשר להחזיר באמצעות פרמטר הפלט, ואפשר לסנן אותם לפי סוג או דומיין.

לדוגמה:
תמצא את 'סן פרנסיסקו' ותחזיר את כל הנתונים שקשורים אליו שאפשר לגשת אליהם באמצעות פרמטר הפלט

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