חיפוש

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

שליחת בקשה

בקשת HTTP

GET https://www.googleapis.com/freebase/v1/search

פרמטרים

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

שם הפרמטר ערך תיאור
פרמטרים אופציונליים
as_of_time string ערך MQL מסוג as_of_time לשימוש עם mql_output שאילתות.
callback string שם שיטת JS לקריאות חוזרות (callbacks) מסוג JSONP.
cursor integer באמצעות הפרמטר cursor יחד עם הפרמטר limit, אפשר לדפדף בין מספר מוגדר של תוצאות בכל פעם. לדוגמה, כדי להציג 3 דפים של 10 תוצאות ברצף, צריך להשתמש ב-limit=10 וב-cursor=0, ואז ב-cursor=10 וב-cursor=20.
domain string מזהה הדומיין של Freebase מוגבל לנושאים.
encode string הקידוד של התגובה. ניתן להשתמש בפרמטר הזה כדי להפעיל קידוד HTML.

הערכים הקבילים הם:
  • "html": קידוד של תווים מסוימים בתגובה (למשל תגים ואמפרסנד) באמצעות קידוד HTML.
  • "off": אין קידוד של התגובה. אין להדפיס את התוצאות ישירות בדף אינטרנט, מבלי להוסיף קודם תוכן ב-HTML. (ברירת מחדל)
exact boolean ניתן לשלוח שאילתות לגבי השם והמפתחות המדויקים בלבד.
filter string

הפרמטר filter מאפשר ליצור כללים ומגבלות מורכבים יותר שיחולו על השאילתה שלכם.

הערך filter הוא שפה פשוטה שתומכת בסמלים הבאים:

  • האופרטורים all, any, should ו-not
  • אופרנדות type, domain, name, alias, with ו-without
  • סוגר ( ו-) לקיבוץ ולעדיפות

לקבלת מידע על השימוש במאפיין filter, ניתן לעיין באוסף הפתרונות של חיפוש Google.
format string הפורמט המבני של תגובת ה-JSON.

הערכים הקבילים הם:
  • "entity": מידע בסיסי על הישויות. (ברירת מחדל)
  • "ids": רשימה מסודרת של Freebase ids.
  • "mids": רשימה מסודרת של Freebase mids.
indent boolean מציין אם כניסה לפי התוצאות בפורמט JSON או לא.
lang string קוד השפה שעבורו ברצונך להריץ את השאילתה. ברירת המחדל היא 'en'.
limit integer המספר המקסימלי של תוצאות להחזרה. כברירת מחדל יוחזרו 20 התאמות בסדר יורד של רלוונטיות, אם קיימות התאמות כאלה. ניתן לבקש פחות התאמות או יותר באמצעות הפרמטר limit עם ערך אחר. (דוגמה.)
mql_output string שאילתת ה-MQL כדי להריץ שוב את התוצאות כדי לחלץ נתונים נוספים. לאחר הרצת השאילתה, המסמכים התואמים' המזהים יועברו לשאילתת ה-MQL של mql_output כדי לאחזר נתונים בפועל לגבי ההתאמות. תוצאות ה-MQL ממוינות לפי הקטנת ציון הרלוונטיות. 
prefixed boolean תחילו את ההתאמה בין שמות וכינויים.
query string מונח השאילתה לחיפוש.
scoring string אלגוריתם של ציון רלוונטיות לשימוש.

הערכים הקבילים הם:
  • "entity": משתמשים בדירוג Freebase ודירוג ישות פופולרית. (ברירת מחדל)
  • "freebase": משתמשים בדירוג ישות Freebase.
  • "schema": משתמשים בדירוג סכימה של נכסים וסוגים.
spell string בקשה 'האם התכוונת ל' הצעות

הערכים הקבילים הם:
  • "always": מבקשים הצעות איות לכל שאילתה באורך של שלושה תווים לפחות.
  • "no_results": אם לא נמצאו תוצאות, מבקשים הצעות איות.
  • "no_spelling": אין לבקש הצעות איות. (ברירת מחדל)
stemmed boolean שאילתה לגבי שמות וכינויים נגזרים. לא ניתן להשתמש בו עם prefixed.
type string הגבלה לנושאים באמצעות מזהה Freebase הזה.
with string כלל סינון שצריך להתאים.
without string כלל סינון שלא תואם.

גוף הבקשה

אין לספק גוף בקשה בשיטה זו.

תשובה

אם התגובה לבקשה מוצלחת, זה מבנה JSON. 

{
  "status":"200 OK",
  "result":[
    {
      "mid":"/m/0b1zz",
      "name":"Nirvana",
      "notable":{"name":"Record Producer","id":"/music/producer"},
      "score":55.227268
    },{
      "mid":"/m/05b3c",
      "name":"Nirvana",
      "notable":{"name":"Belief","id":"/religion/belief"},
      "score":44.248726
    },{
      "mid":"/m/01h89tx",
      "name":"Nirvana",
      "notable":{"name":"Musical Album","id":"/music/album"},
      "score":30.371510
    },{
      "mid":"/m/01rn9fm",
      "name":"Nirvana",
      "notable":{"name":"Musical Group","id":"/music/musical_group"},
      "score":30.092449
    },{
      "mid":"/m/02_6qh",
      "name":"Nirvana",
      "notable":{"name":"Film","id":"/film/film"},
      "score":29.003593
    },{
      "mid":"/m/01rkx5",
      "name":"Nirvana Sutra",
      "score":21.344824
    }
  ],
  "cost":10,
  "hits":0
}