Wyszukiwarka

Interfejs Search API zapewnia dostęp do danych Freebase dla dowolnego zapytania tekstowego. Więcej informacji na temat tworzenia szczegółowych zapytań znajdziesz w wyszukiwarce ogólnych i Search Cookbook.

Wyślij

Żądanie HTTP

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

Parametry

Wszystkie parametry poniżej są opcjonalne, ale musisz wybrać jedną z opcji zapytania lub filtra.

Nazwa parametru Wartość Opis
Parametry opcjonalne
as_of_time string Wartość MQL as_of_time do użycia z zapytaniami mql_output.
callback string Nazwa metody JS dla wywołań zwrotnych JSONP.
cursor integer Parametr cursor wraz z parametrem limit umożliwia stosowanie stron zawierających określoną liczbę wyników jednocześnie. Aby zaprezentować na przykład 3 strony z 10 wynikami, użyj właściwości limit=10 i cursor=0, a następnie cursor=10 i cursor=20.
domain string Ogranicz do tematów za pomocą tego identyfikatora domeny Freebase.
encode string Kodowanie odpowiedzi. Za pomocą tego parametru możesz włączać kodowanie HTML.

Akceptowane wartości:
  • "html": zakoduj w odpowiedzi niektóre znaki (np. tagi i ampersandy) za pomocą kodowania HTML.
  • "off": brak kodowania w odpowiedzi. Nie należy drukować wyników bezpośrednio na stronie internetowej bez wcześniejszego wprowadzenia kodu HTML. (domyślnie)
exact boolean Zapytania tylko o dokładną nazwę i klucze.
filter string

Parametr filter pozwala tworzyć bardziej złożone reguły i ograniczenia, które możesz zastosować do zapytania.

Wartość filter to prosty język, który obsługuje te symbole:

  • operatory all, any, should i not.
  • operaty type, domain, name, alias, with i without.
  • nawiasy ( i ) na potrzeby grupowania i pierwszeństwa

Aby dowiedzieć się, jak korzystać z właściwości filter, zajrzyj do Książki kucharskiej.
format string Formatu odpowiedzi odpowiedzi JSON.

Akceptowane wartości:
  • "entity": podstawowe informacje o elementach. (domyślnie)
  • "ids": uporządkowana lista bezpłatnych baz danych ids.
  • "mids": uporządkowana lista bezpłatnych baz danych mids.
indent boolean Określ, czy chcesz dodać wcięcie kodu JSON, czy nie.
lang string Kod języka, w którym zapytanie ma zostać uruchomione. Wartość domyślna to 'pl'.
limit integer Maksymalna liczba wyników do zwrócenia. Domyślnie jest 20 dopasowań w malejącej kolejności, jeśli jest ich wiele. Parametr limit może mieć inną wartość, co oznacza, że można wysłać mniej żądań. (Przykład).
mql_output string Zapytanie MQL do ponownego uruchomienia wyników w celu wyodrębnienia dodatkowych danych. Po uruchomieniu zapytania pasujące dokumenty są przekazywane do zapytania MQL mql_output, aby pobrać rzeczywiste dane dotyczące dopasowań. Wyniki MQL są sortowane według spadku trafności. 
prefixed boolean Dopasowanie prefiksu do nazw i aliasów.
query string Wyszukiwane hasło, które chcesz wyszukać.
scoring string Algorytm punktacji trafności.

Akceptowane wartości:
  • "entity": korzystanie z rankingu elementów Freebase i popularność. (domyślnie)
  • "freebase": używaj rankingu jednostek Freebase.
  • "schema": Używaj rankingu schematów dla właściwości i typów.
spell string Prośba &zapytanie, czy chodziło Ci o:

Akceptowane wartości:
  • "always": poproś o podpowiedzi pisowni dla dowolnego zapytania o długości co najmniej 3 znaków.
  • "no_results": jeśli nie znaleziono wyników, poproś o sugestię poprawy pisowni.
  • "no_spelling": nie proponuj pisowni. (domyślnie)
stemmed boolean Zapytania dotyczące nazw rdzeni i aliasów. Nie można używać jej z: prefixed.
type string Ogranicz do tematów o tym identyfikatorze typu Freebase.
with string Reguła filtrowania, z którą chcesz się połączyć.
without string Reguła filtrowania, z którą nie można dopasować.

Treść żądania

Nie używaj w tej metodzie treści żądania.

Odpowiedź

Jeśli odpowiedź się powiedzie, odpowiedź będzie w formacie 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
}