פלט חיפוש

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

סקירה כללית

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

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

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

פלט סכימה

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

לדוגמה:
מוצאים את נשיאי ארה"ב ומחזירים את תאריך הלידה וגם את בן/בת הזוג שלהם #39; date_of_birth:

filter=(all type:/government/us_president)
&output=(/people/person/date_of_birth (/people/marriage/spouse /people/person/date_of_birth))

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

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

filter=(all type:/government/us_president)
&output=((/people/marriage/spouse category /people/person/profession))
&lang=it,ru,ja,en

פלט מתקדם

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

תיאור, תיאור:מקור

פונקציה זו מחזירה את הטקסט שנמצא ב-/common/topic/description Triples, ייתכן שסונן על ידי מילת מפתח פרוגרמטית מצא אותו כשדה מוכח.

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

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

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

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

הגדרת עמום, Disambaguator:type, Disambaguator:domain

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

לדוגמה:
מוצאים את הצעת המחיר &הרווח לריצה, ומחזירים נתונים מעורפלים מההתאמות

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

מוצאים את הציטוט 'ריצה'

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

קוד גיאוגרפי

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

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

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

מפתח, מפתח:שם מרחב משותף

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

לדוגמה:
יש למצוא מסעדות בטווח של 300 מ' מבניין המעבורת SF ולהחזיר את מזהה 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)

לא תואם, לא תואם:סוג

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

לדוגמה:
מציאת מופעים של /אנשים/אדם שהסוגים שלהם לא תואמים להם, והחזרתם

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

הכל, הכול:סוג, הכול:דומיין

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

לדוגמה:
איתור &מירכאות; franncisco" והחזרת כל הנתונים הנגישים באמצעות פרמטר הפלט

filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all)
&limit=1

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

filter=(all name{full}:"San Francisco" type:/location/citytown)
&output=(all:/location)
&limit=1