Anpassa och föreslå bildsökningsfrågor

Artikel
01/05/2022

Varning

Den 30 oktober 2020 flyttades Bing-sökning-API:erna från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.

Använd den här artikeln om du vill lära dig hur du anpassar frågor och föreslår sökord som ska skickas till API:et för bildsökning i Bing.

Föreslå söktermer

Om din app har en sökruta där söktermer anges kan du använda API:et automatiska förslag i Bing för att förbättra upplevelsen. API:et kan visa föreslagna söktermer i realtid. API:et returnerar föreslagna frågesträngar baserat på partiella söktermer och Azure AI-tjänster.

Pivot-frågan

Om Bing kan segmentera den ursprungliga sökfrågan innehåller pivotSuggestionsdet returnerade images-objektet . Pivotförslag kan visas som valfria söktermer för användaren. Om den ursprungliga frågan till exempel var Microsoft Surface kan Bing segmentera frågan i Microsoft och Surface och ange föreslagna pivoter för var och en. Dessa förslag kan visas som valfria frågetermer för användaren.

I följande exempel visas pivotförslagen för Microsoft Surface:

{
    "_type": "Images",
    "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=microsoft%20surface&FORM=OIIARP",
    "totalEstimatedMatches": 1000,
    "value": [...],
    "queryExpansions": [...],
    "pivotSuggestions": [{
        "pivot": "microsoft",
        "suggestions": [{
            "text": "Contoso Surface",
            "displayText": "Contoso",
            "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=OtterBox+Surface&FORM=IRQBPS",
            "searchLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=Contoso...",
                    "searchLink": "https:\/\/api.cognitive.microsoft.com\/api...",
            "thumbnail": {
                "thumbnailUrl": "https:\/\/tse3.mm.bing.net\/th?q=Contoso+Surface..."
            }
        },
        {
            "text": "Adatum Surface",
            "displayText": "Adatum",
            "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=Adatum+Surface&FORM=IRQBPS",
            "searchLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=...",
            "thumbnail": {
                "thumbnailUrl": "https:\/\/tse3.mm.bing.net\/th?q=Adatum+Surface&pid=Ap..."
            }
        },
        ...
        ]
    },
    {
        "pivot": "surface",
        "suggestions": [{
            "text": "Microsoft Surface4",
            "displayText": "Surface4",
            "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=Microsoft+Surface...",
            "searchLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?...",
            "thumbnail": {
                "thumbnailUrl": "https:\/\/tse4.mm.bing.net\/th?q=Microsoft..."
            }
        },
        {
            "text": "Microsoft Tablet",
            "displayText": "Tablet",
            "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=Microsoft+Tablet&FORM=IRQBPS",
            "searchLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?...",
            "thumbnail": {
                "thumbnailUrl": "https:\/\/tse3.mm.bing.net\/th?q=Microsoft+Tablet..."
            }
        },
        ...
    ],
    "nextOffsetAddCount": 0
}

Fältet pivotSuggestions innehåller listan över segment (pivoter) som den ursprungliga frågan delades in i. För varje pivot innehåller svaret en lista över Query-objekt som innehåller föreslagna frågor. Fältet text innehåller den föreslagna frågan. Fältet displayText innehåller termen som ersätter pivoten i den ursprungliga frågan. Ett exempel är Utgivningsdatum för Surface.

Om pivotfrågesträngen är det användaren letar efter använder du fälten text och thumbnail för att visa pivotfrågesträngarna. Gör miniatyrbilden och texten klickbara med hjälp webSearchUrl av URL:en eller searchLink URL:en. Använd webSearchUrl för att skicka användaren till Bing-sökresultatet. Om du anger en egen resultatsida använder du searchLink.

Expandera frågan

Om Bing kan expandera frågan för att begränsa den ursprungliga sökningen innehåller objektet Images (Bilder) fältet queryExpansions. Om frågan till exempel var Microsoft Surface kan de utökade frågorna vara:

Microsoft Surface Pro 3.
Microsoft Surface RT.
Microsoft Surface Phone.
Microsoft Surface Hub.

Följande exempel visar de expanderade frågorna för Microsoft Surface.

{
    "_type": "Images",
    "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=microsoft%20surface...",
    "totalEstimatedMatches": 1000,
    "value": [...],
    "queryExpansions":  [{
        "text": "Microsoft Surface Pro 3",
        "displayText": "Pro 3",
        "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=Microsoft+Surface+Pro+3...",
        "searchLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=Microsoft...",
        "thumbnail": {
            "thumbnailUrl": "https:\/\/tse4.mm.bing.net\/th?q=Microsoft+Surface+Pro+3..."
        }
    },
    {
        "text": "Microsoft Surface RT",
        "displayText": "RT",
        "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=Microsoft+Surface+RT...",
        "searchLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=...",
        "thumbnail": {
            "thumbnailUrl": "https:\/\/tse4.mm.bing.net\/th?q=Microsoft+Surface+RT..."
        }
    },
    {
        "text": "Microsoft Surface Phone",
        "displayText": "Phone",
        "webSearchUrl": "https:\/\/www.bing.com\/images\/search?q=Microsoft+Surface+Phone",
        "searchLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=...",
        "thumbnail": {
            "thumbnailUrl": "https:\/\/tse4.mm.bing.net\/th?q=Microsoft+Surface+Phone..."
        }
    }],
    "pivotSuggestions": [...],
    "nextOffsetAddCount": 0
}

Fältet queryExpansions innehåller en lista över Query-objekt. Fältet text innehåller den expanderade frågan. Fältet displayText innehåller expansionstermen. Om den expanderade frågesträngen är det användaren letar efter använder du fälten text och thumbnail för att visa de expanderade frågesträngarna. Gör miniatyrbilden och texten klickbara med hjälp webSearchUrl av URL:en eller searchLink URL:en. Använd webSearchUrl för att skicka användaren till Bing-sökresultatet. Om du anger en egen resultatsida använder du searchLink.

Begränsningsbegäranden

Antalet frågor du kan ställa per sekund (QPS) beror på tjänsten och typen av prenumeration. Se till att programmet har den logik som behövs för att hålla dig inom kvoten. Om QPS-gränsen uppnås eller överskrids leder det till att begäran misslyckas och då returneras HTTP-statuskoden 429. Svaret innehåller Retry-After-huvudet, som anger hur länge du bör vänta innan du skickar en ny begäran.

Överbelastning eller begränsning?

Tjänsten skiljer på en överbelastningsattack (DoS) och en QPS-överträdelse. Om tjänsten misstänker en DoS-attack slutförs begäran (HTTP-statuskoden är 200 OK). Brödtexten i svaret är dock tom.

Nästa steg

Om du inte har provat API:et för bildsökning i Bing tidigare kan du prova en snabbstart. Om du letar efter något mer komplext kan du prova självstudien för att skapa en enkelsidig webbapp.

Dela via