Szukaj

Interfejs Search API umożliwia dostęp do danych Freebase na podstawie zapytania w formie dowolnego tekstu. Więcej informacji o tworzeniu szczegółowych zapytań znajdziesz w omówieniu wyszukiwania i przewodniku po wyszukiwaniu.

Żądanie

Żądanie HTTP

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

Parametry

Wszystkie parametry poniżej są opcjonalne, ale musisz podać jeden z parametrów query lub filter.

Nazwa parametru Wartość Opis
Parametry opcjonalne
as_of_time string Wartość MQL as_of_time do użycia w zapytaniach mql_output.
callback string Nazwa metody JS dla wywołań zwrotnych JSONP.
cursor integer Parametr cursor wraz z parametrem limit umożliwia wyświetlanie określonej liczby wyników naraz. Aby na przykład wyświetlić 3 strony z kolejnymi 10 wynikami, użyj limit=10 i cursor=0, a potem cursor=10 i cursor=20.
domain string Ogranicz do tematów z tym identyfikatorem domeny Freebase.
encode string Kodowanie odpowiedzi. Za pomocą tego parametru możesz włączyć kodowanie HTML.

Akceptowane wartości:
  • „html”: koduje niektóre znaki w odpowiedzi (np. tagi i ampersandy) za pomocą kodowania HTML.
  • „off”: brak kodowania odpowiedzi. Nie drukuj wyników bezpośrednio na stronie internetowej bez wcześniejszego zastosowania znaków ucieczki w HTML-u. (domyślnie)
exact boolean Zapytanie dotyczące tylko dokładnej nazwy i kluczy.
filter string

Parametr filter umożliwia tworzenie bardziej złożonych reguł i ograniczeń, które można zastosować do zapytania.

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

  • operatory all, any, should i not;
  • operandy type, domain, name, alias, with i without;
  • nawiasy ( i ) do grupowania i określania kolejności wykonywania działań,

Informacje o tym, jak używać właściwości filter, znajdziesz w książce kucharskiej wyszukiwarki.
format string Format strukturalny odpowiedzi JSON.

Akceptowane wartości:
  • „entity”: podstawowe informacje o podmiotach. (domyślnie)
  • „ids”: uporządkowana lista identyfikatorów ids w Freebase.
  • „mids”: uporządkowana lista identyfikatorów mids w Freebase.
indent boolean Określa, czy wyniki JSON mają być wcięte.
lang string Kod języka, w którym ma być wykonane zapytanie. Wartość domyślna to „en”.
limit integer Maksymalna liczba wyników do zwrócenia. Domyślnie zwracanych jest 20 dopasowań w kolejności malejącej pod względem trafności, jeśli tyle ich istnieje. Możesz poprosić o mniejszą lub większą liczbę wyników, używając parametru limit z inną wartością. (Przykład)
mql_output string Zapytanie MQL, które ma być ponownie uruchomione na wynikach w celu wyodrębnienia większej ilości danych. Po uruchomieniu zapytania identyfikatory pasujących dokumentów są przekazywane do mql_output zapytania MQL, aby pobrać rzeczywiste dane o pasujących elementach. Wyniki MQL są sortowane według malejącego wyniku trafności. 
prefixed boolean Dopasowanie prefiksu do nazw i aliasów.
query string Wyszukiwane hasło.
scoring string Algorytm oceny trafności do użycia.

Akceptowane wartości:
  • „entity”: korzystaj z rankingu popularności i encji Freebase. (domyślnie)
  • „freebase”: użyj rankingu elementów Freebase.
  • „schema”: używaj rankingu schematu dla właściwości i typów.
spell string Prośba o sugestie „czy chodziło Ci o to?”

Akceptowane wartości:
  • „always”: prośba o sugestie pisowni dla dowolnego zapytania o długości co najmniej 3 znaków.
  • „no_results”: prośba o sugestie pisowni, jeśli nie znaleziono wyników.
  • „no_spelling”: nie proś o sugestie pisowni. (domyślnie)
stemmed boolean Zapytanie dotyczące zredukowanych nazw i aliasów. Nie można używać z usługą prefixed.
type string Ogranicz do tematów z tym identyfikatorem typu Freebase.
with string Reguła filtra do dopasowania.
without string Reguła filtra, która nie ma być dopasowywana.

Treść żądania

Nie podawaj treści żądania w przypadku tej metody.

Odpowiedź

Jeśli operacja się uda, odpowiedź będzie miała strukturę 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
}