Bing Image Search API で Web から画像を取得する

  • [アーティクル]

警告

2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、Azure Marketplace からの Bing Search リソースの作成に関するページを参照してください。

Bing Image Search REST API を使用するとき、次の GET 要求を送信することで、検索語句に関連した画像を Web から取得できます。

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies&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

URL エンコードされた検索語句には、q クエリ パラメーターを使用します。 たとえば、「sailing dinghies」と入力した場合、q を sailing+dinghies または sailing%20dinghies に設定します。

重要

  • すべての要求は、クライアントからではなく、サーバーから実行する必要があります。
  • いずれかの Bing Search API を初めて呼び出す場合は、クライアント ID ヘッダーを含めないでください。 クライアント ID を含めるのは、既に Bing API を呼び出してユーザーとデバイスの組み合わせに対応するクライアント ID が取得済みである場合だけです。

特定の Web ドメインから画像を取得する

特定のドメインから画像を取得するには、site: というクエリ演算子を使用します。

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Note

site: 演算子を使用したクエリへの応答には、safeSearch の設定に関係なく成人向けのコンテンツが含まれることがあります。 site: の使用は、対象となるドメイン上のコンテンツを把握している場合に限定してください。

イメージのフィルター

Images Search API の既定の動作では、クエリとの関連性が高い画像がすべて返されます。 背景が透明な画像や特定のサイズの画像のみを検索対象とするなど、Bing から返された画像をフィルタリングする必要がある場合は、次のクエリ パラメーターを使用してください。

  • aspect - 画像を縦横比でフィルタリング (例: 標準またはワイド スクリーン画像など)。
  • color - ドミナント カラーや白黒で画像をフィルタリング。
  • freshness - 新しさで画像をフィルタリング (例: この 1 週間に Bing によって検出された画像など)。
  • height、width - 幅と高さで画像をフィルタリング。
  • imageContent - 画像をコンテンツでフィルタリング (例: 人の顔が映った画像など)。
  • imageType - 画像を種類でフィルタリング (例: クリップ アート、アニメーション GIF、透明な背景)。
  • license - サイトに関連付けられているライセンスの種類で画像をフィルタリング。
  • size - 画像をサイズでフィルタリング (最大 200 x 200 ピクセルの小さな画像など)。

特定のドメインから画像を取得するには、site: というクエリ演算子を使用します。

次の例は、Bing が過去 1 週間以内に検出した小さな画像を ContosoSailing.com から取得する方法を示しています。

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search?q=sailing+dinghies+site:contososailing.com&size=small&freshness=week&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

Bing Image Search の応答の形式

Bing からの応答メッセージには、クエリとの関連性が高いと Azure AI サービスが判断した画像のリストを格納する Images 応答が含まれています。 このリスト内の各 Image オブジェクトには、画像の URL、サイズ、大きさ、エンコード形式、画像のサムネイルの URL、サムネイルの大きさなどなど、画像に関するさまざまな情報が含まれています。

Note

  • 画像は、応答に含まれている順序で表示する必要があります。
  • URL の書式とパラメーターは、予告なしで変更されることがあるため、すべての URL をそのまま使用してください。 明記されている場合を除いて、URL の書式またはパラメーターに依存しないでください。
{
    "name": "Rich Passage Sailing Dinghy",
    "webSearchUrl": "https:\/\/www.bing.com\/cr?IG=73118C8B4E3...",
    "thumbnailUrl": "https:\/\/tse1.mm.bing.net\/th?id=OIP.GNarK7m...",
    "datePublished": "2011-10-29T11:26:00",
    "contentUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3...",
    "hostPageUrl": "http:\/\/www.bing.com\/cr?IG=73118C8B4E3D4C3687...",
    "contentSize": "79239 B",
    "encodingFormat": "jpeg",
    "hostPageDisplayUrl": "en.contoso.org\/wiki\/File:Rich_Passage...",
    "width": 526,
    "height": 688,
    "thumbnail": {
        "width": 229,
        "height": 300
    },
    "imageInsightsToken": "ccid_GNarK7ma*mid_CCF85447ADA6...",
    "insightsSourcesSummary": {
        "shoppingSourcesCount": 0,
        "recipeSourcesCount": 0
    },
    "imageId": "CCF85447ADA6FFF9E96E7DF0B796F7A86E34593",
    "accentColor": "376094"
},

Bing Image Search API を呼び出すと、結果のリストが Bing から返されます。 このリストは、クエリとの関連性が高い結果の総数のサブセットです。 表示できる画像の数の見積もりは、応答の totalEstimatedMatches フィールドに格納されます。 ページをめくるように残りの画像を表示する方法について詳しくは、画像のページ移動に関するページを参照してください。

次のステップ

まだ Bing Image Search API を試していない方は、クイック スタートをご覧ください。 さらに高度な内容をお求めの方は、単一ページの Web アプリの作成に関するチュートリアルをご覧ください。