教學課程：使用影像深入解析權杖尋找先前搜尋中的類似影像

發行項
03/31/2020

警告

在 2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至 Bing 搜尋服務。本文件僅供參考之用。如需更新的文件，請參閱 Bing 搜尋 API 文件。如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。

圖像式搜尋用戶端程式庫可讓您從先前傳回 ImageInsightsToken 的搜尋中，線上尋找影像。此應用程式可取得 ImageInsightsToken，並在後續搜尋中使用權杖。然後會將 ImageInsightsToken 傳送到 Bing 並傳回結果，結果中包含 Bing 搜尋 URL 和線上所找到類似影像的 URL。

在 Github 上可找到此教學課程的完整原始程式碼，其中含有其他錯誤處理和註釋。

Prerequisites

任何版本的 Visual Studio 2019。
如果您使用 Linux/MacOS，則可以使用 Mono 來執行此應用程式。
NuGet 圖像式搜尋和 Bing 影像搜尋套件。
- 在 Visual Studio 的 [方案總管] 中，以滑鼠右鍵按一下專案，然後從功能表選取 [管理 NuGet 套件] 。安裝 Microsoft.Azure.CognitiveServices.Search.CustomSearch 套件和 Microsoft.Azure.CognitiveServices.Search.ImageSearch 套件。安裝 NuGet 套件也會安裝：
  - Microsoft.Rest.ClientRuntime
  - Microsoft.Rest.ClientRuntime.Azure
  - Newtonsoft.Json

建立 Azure 資源

藉由建立下列其中一項 Azure 資源，開始使用 Bing 圖像式搜尋 API：

Bing 搜尋 v7 資源

您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
選取 S9 定價層。

多服務資源

您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
針對您的應用程式，跨多個 Azure AI 服務使用相同的金鑰和端點。

從 Bing 影像搜尋用戶端程式庫取得 ImageInsightsToken

此應用程式會使用透過 Bing 影像搜尋用戶端程式庫所取得的 ImageInsightsToken。在新的 C# 主控台應用程式中，建立會使用 ImageSearchClient() 來呼叫 API 的用戶端。然後搭配使用 SearchAsync() 與您的查詢：

var client = new ImageSearchClient(new Microsoft.Azure.CognitiveServices.Search.ImageSearch.ApiKeyServiceClientCredentials(subKey));
var imageResults = client.Images.SearchAsync(query: "canadian rockies").Result;
Console.WriteLine("Search images for query \"canadian rockies\"");

使用 imageResults.Value.First() 儲存第一個搜尋結果，然後儲存影像深入解析的 ImageInsightsToken。

String insightTok = "None";
if (imageResults.Value.Count > 0)
{
    var firstImageResult = imageResults.Value.First();
    insightTok = firstImageResult.ImageInsightsToken;
}
else
{
    insightTok = "None found";
    Console.WriteLine("Couldn't find image results!");
}

這個 ImageInsightsToken 會在要求中傳送至 Bing 圖像式搜尋。

在圖像式搜尋要求中新增 ImageInsightsToken

藉由從 Bing 圖像式搜尋回應中所包含的 ImageInsightsToken 建立 ImageInfo 物件，來指定圖像式搜尋要求的 ImageInsightsToken。

ImageInfo ImageInfo = new ImageInfo(imageInsightsToken: insightsTok);

使用 Bing 圖像式搜尋來尋找 ImageInsightsToken 中的影像

VisualSearchRequest 物件包含所要搜尋 ImageInfo 中影像的相關資訊。 VisualSearchMethodAsync() 方法會取得結果。影像會以權杖來表示，所以您不需要提供影像二進位檔。

VisualSearchRequest VisualSearchRequest = new VisualSearchRequest(ImageInfo);

var visualSearchResults = client.Images.VisualSearchMethodAsync(knowledgeRequest: VisualSearchRequest).Result;

逐一查看圖像式搜尋結果

圖像式搜尋的結果為 ImageTag 物件。每個標記都包含 ImageAction 物件清單。每個 ImageAction 都包含 Data 欄位，這是會取決於動作類型的值清單。例如，您可以逐一查看 visualSearchResults.Tags 中的 ImageTag 物件，並從中取得 ImageAction 標記。下列範例會列印 PagesIncluding 動作的詳細資料：

if (visualSearchResults.Tags.Count > 0)
{
    // List of tags
    foreach (ImageTag t in visualSearchResults.Tags)
    {
        foreach (ImageAction i in t.Actions)
        {
            Console.WriteLine("\r\n" + "ActionType: " + i.ActionType + " WebSearchURL: " + i.WebSearchUrl);

            if (i.ActionType == "PagesIncluding")
            {
                foreach (ImageObject o in (i as ImageModuleAction).Data.Value)
                {
                    Console.WriteLine("ContentURL: " + o.ContentUrl);
                }
            }
        }
    }
}

PagesIncluding ActionType

從動作類型取得實際的影像 URL 需要進行轉換，以將 ActionType 讀取為 ImageModuleAction，其中包含具有值清單的 Data 元素。每個值都是某個影像的 URL。下列程式碼會將 PagesIncluding 動作類型轉換為 ImageModuleAction，並讀取那些值：

    if (i.ActionType == "PagesIncluding")
    {
        foreach(ImageObject o in (i as ImageModuleAction).Data.Value)
        {
            Console.WriteLine("ContentURL: " + o.ContentUrl);
        }
    }

如需這些資料類型的詳細資訊，請參閱影像 - 圖像式搜尋。

傳回的 URL

完整的應用程式會傳回下列 URL：

ActionType	URL
MoreSizes -> WebSearchUrl
VisualSearch -> WebSearchUrl
ImageById -> WebSearchUrl
RelatedSearches -> WebSearchUrl：
DocumentLevelSuggestions -> WebSearchUrl：
TopicResults -> WebSearchUrl	https://www.bing.com/cr?IG=3E32CC6CA5934FBBA14ABC3B2E4651F9&CID=1BA795A21EAF6A6317569B71FC36B7C&rd=1&h=BcQifmzdKFyyBusjLxxgO42kzq1Geh7RucVVqvH-900&v=1&r=https%3a%2fwww.bing.com%2fdiscover%2fcanaize%2brocky&p=DevEx，5823.1
ImageResults -> WebSearchUrl	https://www.bing.com/cr?IG=3E32CC6CA5934FBBA14ABC3B2E4651F9&CID=1BA795A21EAF6A6317569B71FC36B7C&rd=1&h=PV9GzMFOI0AHZp2gKeWJ8DcveSDRE3fP2jHDKMpJSU8&v=1&r=https%3a%2f%2fwww.bing.com%2fimages%2fsearch%3fq%3doutdoor&p=DevEx，5831.1

如上所示，TopicResults 和 ImageResults 類型包含針對相關影像的查詢。 URL 會連結至 Bing 搜尋結果。

後續步驟

建立圖像式搜尋單頁 Web 應用程式

共用方式為