Arama yapın

Search API, ücretsiz bir metin sorgusu yapıldığında 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 Aramaya 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 seçeneklerinden biri olmalıdır.

Parametre adı Değer Açıklama
İsteğe bağlı parametreler
as_of_time string mql_output sorgularıyla kullanılacak bir MQL as_of_time değeri.
callback string JSONP geri çağırmaları için JS yöntemi adı.
cursor integer limit parametresiyle birlikte cursor parametresi, tek seferde tanımlanmış bir sayıda sonuç arasında gezinebilmenizi sağlar. Örneğin, art arda 10 sonucun 3 sayfasını sunmak için limit=10 ve cursor=0, ardından cursor=10 ve cursor=20 kullanın.
domain string Bu Freebase alanı kimliğine sahip konularla kısıtla.
encode string Yanıtın kodlaması. HTML kodlamasını etkinleştirmek için bu parametreyi kullanabilirsiniz.

Kabul edilebilir değerler şunlardır:
  • "html": HTML kodlamasını kullanarak yanıttaki belirli karakterleri (etiketler ve ve işareti gibi) kodlayın.
  • "off": Yanıtın kodlaması yok. Sonuçları doğrudan içerikten kaçmadan, doğrudan web sayfasına yazdırmamanız gerekir. (varsayılan)
exact boolean Yalnızca tam ad ve anahtarlar için sorgu oluşturun.
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şleneni
  • gruplandırma ve öncelik için ( ve ) parantezi

filter özelliğinin nasıl kullanılacağını öğrenmek için Tarif Defterini Ara bölümüne bakın.
format string JSON yanıtının yapısal biçimi.

Kabul edilebilir değerler şunlardır:
  • "entity": Tüzel kişiler hakkında temel bilgiler. (varsayılan)
  • "ids": ids Freebase'in sıralı listesi.
  • "mids": mids Freebase'in sıralı listesi.
indent boolean JSON sonuçlarının girintili olup olmadığı.
lang string Sorgunun çalıştırılacağı dilin kodu. Varsayılan &&339;en' şeklindedir.
limit integer Döndürülecek maksimum sonuç sayısı. Varsayılan olarak, alaka düzeyi azalan düzende 20 eşleşme (varsa) döndürülür. Farklı bir değerle limit parametresi kullanılarak daha az veya daha fazla eşleşme istenebilir. (Örnek.)
mql_output string Daha fazla veri almak için sonuçlarda tekrar çalıştırılacak MQL sorgusu. Sorgu çalıştırıldıktan sonra, eşleşmelerle ilgili gerçek verileri almak için eşleşen dokümanlar' kimlikleri mql_output MQL sorgusuna geçirilir. MQL sonuçları, alaka düzeyi puanı azaltılarak sıralanır. 
prefixed boolean Ad ve takma adlarla önek eşleşmesi.
query string Aranacak sorgu terimi.
scoring string Kullanılacak alaka düzeyi puanlama algoritması.

Kabul edilebilir değerler şunlardır:
  • "entity&‘;;: Serbest taban ve popülerlik varlığı sıralamasını kullanın. (varsayılan)
  • "freebase": Freebase varlık sıralamasını kullanın.
  • &"schema": Tesisler ve türler için şema sıralamasını kullanın.
spell string İste &' şunu önerin' öneriler

Kabul edilebilir değerler şunlardır:
  • "always": En az üç karakter uzunluğunda bir sorgu için yazım önerisi ister.
  • "no_results": Sonuç bulunamadıysa yazım önerileri iste.
  • &&t;no_spelling; Yazım önerileri istemeyin. (varsayılan)
stemmed boolean Kopyalanan adlar ve takma adlar hakkında sorgu. prefixed ile kullanılamaz.
type string Bu Freebase türü kimliğine sahip konularla kısıtla.
with string Eşleştirme için bir filtre kuralı.
without string Eşleşmeyen bir filtre kuralı.

İstek metni

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

Yanıt

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

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