Návrhy termínů dotazu
Upozornění
30. října 2020 se rozhraní API Vyhledávání Bingu přesunula ze služeb Azure AI na Vyhledávání Bingu Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API Bingu pro vyhledávání. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bingu najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.
Rozhraní API pro automatické návrhy Bingu byste obvykle volali pokaždé, když uživatel zadá do vyhledávacího pole vaší aplikace nový znak. Úplnost řetězce dotazu má vliv na relevanci navrhovaných termínů dotazu, které rozhraní API vrátí. Čím je řetězec dotazu úplnější, tím relevantnější seznam navrhovaných termínů dotazů se zobrazí. Například návrhy, které může rozhraní API vrátit s
, budou pravděpodobně méně relevantní než dotazy, které vrací pro sailing dinghies
.
Příklad požadavku
Následující příklad ukazuje požadavek, který vrací navrhované řetězce dotazu pro sail. Při nastavování parametru dotazu q nezapomeňte zakódovat částečný termín dotazu uživatele s použitím kódování URL. Pokud například uživatel zadal sailing les, nastavte parametr q
na sailing+les
nebo sailing%20les
.
GET https://api.cognitive.microsoft.com/bing/v7.0/suggestions?q=sail&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
Následující odpověď obsahuje seznam objektů SearchAction, které obsahují navrhované termíny dotazu.
{
"url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "WebSearch"
}, ...
Použití navrhovaných termínů dotazu
Každý návrh obsahuje pole displayText
, query
a url
. Pole displayText
obsahuje navrhovaný dotaz, který můžete použít k vyplnění rozevíracího seznamu vašeho vyhledávacího pole. Musíte zobrazit všechny návrhy, které odpověď obsahuje, v uvedeném pořadí.
Následující příklad ukazuje rozevírací vyhledávací pole s navrhovanými termíny dotazů z rozhraní API pro automatické návrhy Bingu.
Pokud uživatel vybere z rozevíracího seznamu navrhovaný dotaz, použijete termín dotazu v poli query
k volání rozhraní API Bingu pro vyhledávání na webu a zobrazení výsledků. Nebo můžete použít adresu URL v poli url
a odeslat uživatele na stránku s výsledky hledání Bingu.