.. _api_search: =========== Vyhledávání =========== Vyhledávání entit je možné pomocí speciálních funkcí popsaných pomocí :ref:`REST API `. Jedná se o funkce dostupné v části :token:`/search`. Funkce pro vyhledání umožňuje zvolit způsob vyhledání "SearchType". Je možné zvolit způsob "EXACT", kdy je dohledáváno přesně dle zadaných podmínek pomocí databázového dohledání a výsledky jsou seřazeny abecedně. Nebo je možné zvolit způsob "FULLTEXT", který dohledává v indexových souborech včetně transliterované podoby a výsledky jsou řazeny dle priority dohledání. Výchozím způsobem pro vyhledání, pokud není zadán, je "FULLTEXT". Funkce pro vyhledávání umožňuje jako vyhledávací kritéria specifikovat: - vybrané třídy či podtřídy - určitý stav entity (nová, schválená, nahrazená) - hodnotu prvků popisu s možností omezení na typy prvků popisu Funkce podporuje stránkování výsledků a pomocí parametrů se nastavuje počet záznamů na stránku a číslo stránky (stránkováno od 1). Součástí vrácených výsledků je vždy celkový počet záznamů. Příklady vyhledávaných podmínek =============================== Vyhledání přes všechna označení ------------------------------- Cílem je vyhledat obec *Hluboká nad Vltavou* a to zadáním slova *Hluboká* a jeho vyhledáním ve všech označeních. Pro vyhledání bude použita serializovaná podoba označení. Způsob vytváření serializované podoby označení je popsán v :ref:`ont_labels`. .. literalinclude:: openapi/seach1.json :language: json Vyhledání preferovaných označení pro vybranou podtřídu ----------------------------------------------------------- Cílem je vyhledat obec *Hluboká nad Vltavou* a to zadáním slova *Hluboká* a jeho vyhledáním v preferovaných označeních. Hledání je dále omezeno na podtřídu Administrativně vymezená území a vyhledává se jen ve schválených záznamech. .. literalinclude:: openapi/seach2.json :language: json Vyhledání s omezením na rok narození ------------------------------------ Cílem vyhledání je *Alexandra Bacha* a to pomocí znalosti data narození později než 1800 a jména *Bach*. .. literalinclude:: openapi/seach3.json :language: json Vyhledání s omezením na rozmezí data vzniku a stavu ---------------------------------------------------- Cílem vyhledání jsou entity ve stavu nový a schválený s omezením, že datace vzniku obsahuje zadaný časový interval. .. literalinclude:: openapi/seach4.json :language: json