ค้นหา

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

ส่งคำขอ

คำขอ HTTP

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

พารามิเตอร์

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

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์ที่ไม่บังคับ
as_of_time string ค่า as_of_time ของ MQL ที่จะใช้กับข้อความค้นหา mql_output
callback string ชื่อเมธอด JS สําหรับโค้ดเรียกกลับ JSONP
cursor integer พารามิเตอร์ cursor พร้อมด้วยพารามิเตอร์ limit ช่วยให้คุณดูจํานวนผลการค้นหาแต่ละครั้งได้พร้อมกัน เช่น หากต้องการแสดงผลการค้นหา 3 แบบ 10 หน้าแบบต่อเนื่อง ให้ใช้ limit=10 และ cursor=0 ตามด้วย cursor=10 และ cursor=20
domain string จํากัดเฉพาะหัวข้อที่มีรหัสโดเมน Freebase นี้
encode string การเข้ารหัสการตอบกลับ คุณใช้พารามิเตอร์นี้เพื่อเปิดใช้การเข้ารหัส HTML ได้

ค่าที่ยอมรับได้ ได้แก่
  • "html": เข้ารหัสอักขระบางตัวในการตอบสนอง (เช่น แท็กและเครื่องหมายแอมเพอร์แซนด์) โดยใช้การเข้ารหัส HTML
  • "off": ไม่มีการเข้ารหัสการตอบกลับ คุณไม่ควรพิมพ์ผลการค้นหาบนหน้าเว็บโดยตรงโดยไม่ต้อง Escape เนื้อหาก่อน (ค่าเริ่มต้น)
exact boolean การค้นหาในชื่อและคีย์ที่ตรงกันเท่านั้น
filter string

พารามิเตอร์ filter ช่วยให้คุณสร้างกฎและข้อจํากัดที่ซับซ้อนมากขึ้นเพื่อใช้กับการค้นหาได้

ค่า filter คือภาษาง่ายๆ ที่รองรับสัญลักษณ์ต่อไปนี้

  • โอเปอเรเตอร์ all, any, should และ not
  • ตัวถูกดําเนินการของ type, domain, name, alias, with และ without
  • วงเล็บ ( และ ) สําหรับการจัดกลุ่มและลําดับความสําคัญ

ดูวิธีใช้พร็อพเพอร์ตี้ filter ที่ตําราค้นหา
format string รูปแบบโครงสร้างของการตอบสนองด้วย JSON

ค่าที่ยอมรับได้ ได้แก่
  • "entity": ข้อมูลพื้นฐานเกี่ยวกับบุคคล (ค่าเริ่มต้น)
  • "ids": รายการตามลําดับของ Freebase ids
  • "mids": รายการตามลําดับของ Freebase mids
indent boolean เยื้องการเยื้องผลลัพธ์ JSON หรือไม่
lang string รหัสของภาษาที่จะเรียกใช้การสืบค้นข้อมูล ค่าเริ่มต้นคือ 'en'
limit integer จํานวนผลลัพธ์สูงสุดที่จะแสดง โดยค่าเริ่มต้น ค่าที่ตรงกันของความเกี่ยวข้องจะลดลง 20 รายการหากมีจํานวนมาก คุณอาจขอข้อมูลที่ตรงกันอย่างน้อย 1 รายการได้โดยใช้พารามิเตอร์ limit ที่มีค่าอื่น (ตัวอย่าง)
mql_output string การค้นหา MQL เพื่อเรียกใช้อีกครั้งจะแสดงผลผลลัพธ์เพื่อดึงข้อมูลเพิ่มเติม หลังจากเรียกใช้การค้นหาแล้ว เอกสารที่ตรงกันจะส่งไปที่ ID #39 และส่งไปยังคําค้นหา MQL ของ mql_output เพื่อดึงข้อมูลจริงเกี่ยวกับรายการที่ตรงกัน ผลการค้นหา 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
}