ค้นหา

Search API ให้สิทธิ์เข้าถึงข้อมูล Freebase เมื่อมีการค้นหาข้อความอิสระ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีสร้างคำค้นหาแบบละเอียดได้ที่ภาพรวมของ Search และสูตรการค้นหา

ส่งคำขอ

คำขอ HTTP

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

พารามิเตอร์

พารามิเตอร์ทั้งหมดด้านล่างนี้ไม่บังคับ แต่คุณต้องมีพารามิเตอร์อย่างใดอย่างหนึ่งระหว่าง query หรือ filter

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์ที่ไม่บังคับ
as_of_time string as_of_time ค่า MQL ที่จะใช้กับคำค้นหา mql_output
callback string ชื่อเมธอด JS สำหรับการเรียกกลับ JSONP
cursor integer พารามิเตอร์ cursor พร้อมกับพารามิเตอร์ limit ช่วยให้คุณเลื่อนดูผลลัพธ์ตามจำนวนที่กำหนดได้ครั้งละ 1 หน้า เช่น หากต้องการแสดง 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 โปรดดูสูตรการค้นหา
format string รูปแบบโครงสร้างของการตอบกลับ JSON

ค่าที่ยอมรับมีดังนี้
  • "entity": ข้อมูลพื้นฐานเกี่ยวกับเอนทิตี (ค่าเริ่มต้น)
  • "ids": รายการที่เรียงลำดับของ ids ใน Freebase
  • "mids": รายการที่เรียงลำดับของ mids ใน Freebase
indent boolean จะเยื้องผลลัพธ์ JSON หรือไม่
lang string รหัสของภาษาที่จะใช้เรียกใช้การค้นหา ค่าเริ่มต้นคือ "en"
limit integer จำนวนผลลัพธ์สูงสุดที่จะแสดง โดยค่าเริ่มต้น ระบบจะแสดงผลการค้นหา 20 รายการตามลำดับความเกี่ยวข้องจากมากไปน้อย หากมี คุณขอการจับคู่จำนวนน้อยลงหรือมากขึ้นได้โดยใช้พารามิเตอร์ limit ที่มีค่าต่างกัน (ตัวอย่าง)
mql_output string คำค้นหา MQL ที่จะเรียกใช้กับผลลัพธ์เพื่อดึงข้อมูลเพิ่มเติม หลังจากเรียกใช้การค้นหาแล้ว ระบบจะส่งรหัสของเอกสารที่ตรงกันไปยังmql_outputการค้นหา MQL เพื่อดึงข้อมูลจริงเกี่ยวกับการจับคู่ ผลลัพธ์ของ MQL จะจัดเรียงตามคะแนนความเกี่ยวข้องที่ลดลง 
prefixed boolean การจับคู่คำนำหน้ากับชื่อและชื่อแทน
query string คำค้นหาที่จะค้นหา
scoring string อัลกอริทึมการให้คะแนนความเกี่ยวข้องที่จะใช้

ค่าที่ยอมรับมีดังนี้
  • "entity": ใช้ Freebase และการจัดอันดับเอนทิตีตามความนิยม (ค่าเริ่มต้น)
  • "freebase": ใช้การจัดอันดับเอนทิตี Freebase
  • "schema": ใช้การจัดอันดับสคีมาสำหรับพร็อพเพอร์ตี้และประเภท
spell string ขอคำแนะนำ "คุณหมายถึง"

ค่าที่ยอมรับมีดังนี้
  • "always": ขอคำแนะนำการสะกดคำสำหรับคำค้นหาที่มีอักขระอย่างน้อย 3 ตัว
  • "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
}