Arama

Arama API'si, serbest metin sorgusu verildiğinde Freebase verilerine erişim sağlar. Ayrıntılı arama sorgularının nasıl oluşturulacağı hakkında daha fazla bilgi için lütfen Arama'ya Genel Bakış ve Arama Yemek Kitabı'nı inceleyin.

İstek

HTTP isteği

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

Parametreler

Aşağıdaki tüm parametreler isteğe bağlıdır ancak query veya filter parametrelerinden birini kullanmanız gerekir.

Parametre adı Değer Açıklama
İsteğe bağlı parametreler
as_of_time string mql_output sorgularıyla kullanılacak bir pazarlamaya uygun potansiyel müşteri as_of_time değeri.
callback string JSONP geri çağırmaları için JS yöntemi adı.
cursor integer cursor parametresi, limit parametresiyle birlikte tanımlı sayıda sonuç arasında aynı anda gezinmenize olanak tanır. Örneğin, 10 sonuç içeren 3 ardışık sayfayı göstermek için limit=10 ve cursor=0, ardından cursor=10 ve cursor=20 öğelerini kullanın.
domain string Bu Freebase alan kimliğine sahip konularla sınırlayın.
encode string Yanıtın kodlaması. HTML kodlamayı etkinleştirmek için bu parametreyi kullanabilirsiniz.

Kabul edilen değerler şunlardır:
  • "html": Yanıttaki belirli karakterleri (ör. etiketler ve "ve" işaretleri) HTML kodlaması kullanarak kodlayın.
  • "off": Yanıt kodlanmaz. Sonuçları, içeriği önce HTML'den kaçırmadan doğrudan bir web sayfasına yazdırmamalısınız. (varsayılan)
exact boolean Yalnızca tam ad ve anahtarlar üzerinde sorgu yapın.
filter string

filter parametresi, sorgunuza uygulanacak daha karmaşık kurallar ve kısıtlamalar oluşturmanıza olanak tanır.

filter değeri, aşağıdaki simgeleri destekleyen basit bir dildir:

  • all, any, should ve not operatörleri
  • type, domain, name, alias, with ve without işlenenleri
  • Gruplandırma ve öncelik için ( ve ) parantezleri

filter özelliğini nasıl kullanacağınızı öğrenmek için Arama Yemek Kitabı'na bakın.
format string JSON yanıtının yapısal biçimi.

Kabul edilen değerler şunlardır:
  • "entity": Öğelerle ilgili temel bilgiler. (varsayılan)
  • "ids": Freebase ids öğelerinin sıralı listesi.
  • "mids": Freebase mids öğelerinin sıralı listesi.
indent boolean JSON sonuçlarının girintili olup olmayacağı.
lang string Sorgunun çalıştırılacağı dilin kodu. Varsayılan değer "en"dir.
limit integer Döndürülecek maksimum sonuç sayısı. Varsayılan olarak, varsa alaka düzeyine göre azalan düzende 20 eşleşme döndürülür. Farklı bir değere sahip limit parametresi kullanılarak daha az veya daha fazla eşleşme istenebilir. (Örnek.)
mql_output string Daha fazla veri ayıklamak için sonuçlara karşı tekrar çalıştırılacak MQL sorgusu. Sorgu çalıştırıldıktan sonra, eşleşen dokümanların kimlikleri, eşleşmelerle ilgili gerçek verileri almak için mql_output MQL sorgusuna iletilir. MQL sonuçları, alaka düzeyi puanına göre azalan sırada sıralanır. 
prefixed boolean Adlar ve diğer adlarla önek eşleşmesi.
query string Aranacak sorgu terimi.
scoring string Kullanılacak alaka düzeyi puanlama algoritması.

Kabul edilen değerler şunlardır:
  • "entity": Freebase ve popülerlik öğesi sıralamasını kullanın. (varsayılan)
  • "freebase": Freebase öğe sıralamasını kullanın.
  • "schema": Özellikler ve türler için şema sıralamasını kullanın.
spell string "Şunu mu demek istediniz?" önerileri isteyin

Kabul edilebilir değerler şunlardır:
  • "always": En az üç karakter uzunluğundaki sorgular için yazım önerileri isteyin.
  • "no_results": Sonuç bulunamadıysa yazım önerileri isteyin.
  • "no_spelling": Yazım önerisi istemeyin. (varsayılan)
stemmed boolean Kökü alınmış adlar ve takma adlar üzerinde sorgu oluşturma. prefixed ile kullanılamayabilir.
type string Bu Freebase türü kimliğine sahip konularla sınırlandırın.
with string Eşleştirilecek bir filtre kuralı.
without string Eşleştirilmeyecek bir filtre kuralı.

İstek içeriği

Bu yöntemle istek gövdesi sağlamayın.

Yanıt

Başarılı olursa yanıt bir JSON yapısıdır. 

{
  "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
}