Sdílet prostřednictvím

Získání obrázků z webu pomocí rozhraní API Bingu pro vyhledávání obrázků

  • Článek

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í Bingem najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.

Když používáte rozhraní REST API Bingu pro vyhledávání obrázků, můžete z webu získat obrázky, které souvisejí s vaším hledaný termín, odesláním následujícího požadavku GET:

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

Pro hledaný termín kódovaný adresou URL použijte parametr dotazu q . Pokud například zadáte plachtění dinghies, nastavte q na sailing+dinghies nebo sailing%20dinghies.

Důležité

  • Všechny požadavky musí být provedeny ze serveru, nikoli z klienta.
  • Pokud některé z rozhraní API pro vyhledávání Bingu voláte poprvé, nezahrnujte hlavičku ID klienta. ID klienta uveďte jenom v případě, že jste dříve volali rozhraní API Bingu, které vrátilo ID klienta pro kombinaci uživatele a zařízení.

Získání obrázků z konkrétní webové domény

Pokud chcete získat obrázky z konkrétní domény, použijte operátor dotazu site:.

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

Poznámka

Odpovědi na dotazy pomocí operátoru site: můžou obsahovat obsah pro dospělé bez ohledu na nastavení bezpečného hledání . Používejte site: pouze v případě, že víte o obsahu v doméně.

Filtrování obrázků

Ve výchozím nastavení vrátí rozhraní API pro vyhledávání obrázků všechny obrázky, které jsou pro dotaz relevantní. Pokud chcete filtrovat obrázky, které Bing vrací (například pokud chcete vrátit jenom obrázky s průhledným pozadím nebo konkrétní velikostí), použijte následující parametry dotazu:

  • aspect – filtruje obrázky podle poměru stran (například standardní nebo širokoúhlé obrázky).
  • color – filtruje obrázky podle dominantní barvy nebo černobílé barvy.
  • aktuálnost – filtruje obrázky podle věku (například obrázky zjištěné Bingem v minulém týdnu).
  • height, width – filtruje obrázky podle šířky a výšky.
  • imageContent – filtruje obrázky podle obsahu (například obrázky, které zobrazují jenom obličej osoby).
  • imageType – filtruje obrázky podle typu (například kliparty, animované obrázky GIF nebo průhledná pozadí).
  • license – Filtrujte obrázky podle typu licence přidružené k webu.
  • size – filtruje obrázky podle velikosti, například malých obrázků o velikosti až 200 × 200 pixelů.

Pokud chcete získat obrázky z konkrétní domény, použijte operátor dotazu site:.

Následující příklad ukazuje, jak získat malé obrázky z ContosoSailing.com, které Bing zjistil v minulém týdnu.

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

Formát odpovědi Vyhledávání obrázků Bingu

Zpráva odpovědi z Bingu obsahuje odpověď Images obsahující seznam obrázků, které služby Azure AI považují za relevantní pro dotaz. Každý objekt Image v seznamu obsahuje následující informace o obrázku: adresu URL, jeho velikost, rozměry, formát kódování, adresu URL miniatury obrázku a rozměry miniatury.

Poznámka

  • Obrázky musí být zobrazeny v pořadí uvedeném v odpovědi.
  • Vzhledem k tomu, že se formáty a parametry adres URL můžou změnit bez předchozího upozornění, používejte všechny adresy URL tak, jak jsou. Neměli byste přijímat závislosti na formátu nebo parametrech adresy URL s výjimkou těch, které jsou uvedené.
{
    "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"
},

Když zavoláte rozhraní API Bingu pro vyhledávání obrázků, Bing vrátí seznam výsledků. Tento seznam je podmnožinou celkového počtu výsledků, které jsou pro dotaz relevantní. Pole totalEstimatedMatches v odpovědi obsahuje odhadovaný počet obrázků, které je možné zobrazit. Podrobnosti o tom, jak procházet zbývající obrázky, najdete v tématu Stránkování obrázků.

Další kroky

Pokud jste rozhraní API Bingu pro vyhledávání obrázků ještě nevyzkoušeli, zkuste rychlý start. Pokud hledáte něco složitějšího, vyzkoušejte kurz vytvoření jednostránkové webové aplikace.