Querytermen voorstellen
Waarschuwing
Op 30 oktober 2020 zijn de Bing Search-API's verplaatst van Azure AI-services naar Bing Search Services. Deze documentatie wordt alleen ter referentie verstrekt. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Voor instructies voor het maken van nieuwe Azure-resources voor Bing, zie Een Bing Search-resource maken via de Azure Marketplace.
Normaal gesproken roept u de Bing Automatische suggestie-API aan telkens wanneer een gebruiker een nieuw teken in het zoekvak van uw toepassing typt. De volledigheid van de queryreeks heeft invloed op de relevantie van de voorgestelde querytermen die door de API worden geretourneerd. Hoe vollediger de querytekenreeks, hoe relevanter de lijst met voorgestelde querytermen is. Zo zijn de suggesties die de API kan retourneren voor s waarschijnlijk minder relevant zijn dan de query's die worden geretourneerd voor sailing dinghies.
Voorbeeldaanvraag
In het volgende voorbeeld ziet u een aanvraag waarmee de voorgestelde querytekenreeksen voor zeilworden geretourneerd. Vergeet niet om de gedeeltelijke queryterm van de gebruiker te URL-coderen wanneer u de queryparameter q instelt. Als de gebruiker bijvoorbeeld zeil lesheeft ingevoerd, stelt u q in op sailing+les of 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
Het volgende antwoord bevat een lijst met SearchAction-objecten die de voorgestelde querytermen bevatten.
{
"url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "WebSearch"
}, ...
Voorgestelde querytermen gebruiken
Elke suggestie bevat een displayText, query en url veld. Het displayText veld bevat de voorgestelde query die u gebruikt om de vervolgkeuzelijst van het zoekvak te vullen. U moet alle suggesties weergeven die het antwoord bevat en in de opgegeven volgorde.
In het volgende voorbeeld ziet u een vervolgkeuzelijst met voorgestelde querytermen uit de Automatische suggestie-API van Bing.
Als de gebruiker een voorgestelde query selecteert in de vervolgkeuzelijst, gebruikt u de queryterm in het query veld om de Bing Webzoekopdrachten-API aan te roepen en de resultaten zelf weer te geven. U kunt ook de URL in het veld url gebruiken om de gebruiker naar de pagina met zoekresultaten van Bing te verzenden.