Sdílet prostřednictvím

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

  • Článek

Varování

30. října 2020 se rozhraní API Bingu pro vyhledávání přesunula ze služeb Azure AI do služby Bing Search 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ímAzure Marketplace .

Když použijete rozhraní REST API Bingu pro vyhledávání obrázků, můžete získat obrázky z webu, které souvisejí s hledaný termínem, 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 plachetní čluny, nastavte q na sailing+dinghies nebo sailing%20dinghies.

Důležité

  • Všechny požadavky musí být provedeny ze serveru, a ne z klienta.
  • Pokud voláte rozhraní API Bingu pro vyhledávání poprvé, nezahrnujte hlavičku ID klienta. Id klienta uveďte pouze 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 používající operátor site: mohou zahrnovat obsah pro dospělé bez ohledu na nastavení bezpečného hledání . Používejte site: jenom v případě, že znáte obsah 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:

  • poměr– filtrovat obrázky podle poměru stran (například standardních nebo širokoúhlých).
  • barva– filtrujte obrázky podle dominantní barvy nebo černobílé.
  • aktuálnost– filtrujte obrázky podle věku (například obrázky zjištěné Bingem v minulém týdnu).
  • výšku, šířku– filtrujte obrázky podle šířky a výšky.
  • imageContent– filtrujte obrázky podle obsahu (například obrázky, které zobrazují jenom tvář osoby).
  • imageType– filtrujte obrázky podle typu (například kliparty, animované GIFy nebo průhledná pozadí).
  • licence– filtrujte obrázky podle typu licence přidružené k webu.
  • velikost– filtrujte obrázky podle velikosti, například malé obrázky o velikosti až 200 × 200 pixelů.

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

Následující příklad ukazuje, jak získat malé obrázky z ContosoSailing.com, které Bing objevil 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 Bingu pro vyhledávání obrázků

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

Poznámka:

  • Obrázky musí být zobrazeny v pořadí uvedeném v odpovědi.
  • Vzhledem k tomu, že formáty adres URL a parametry se můžou bez předchozího upozornění změnit, použijte všechny adresy URL as-is. Neměli byste brát závislosti na formátu adresy URL ani parametrech s výjimkou případů, kdy je uvedeno.
{
    "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ů. Seznam je podmnožinou celkového počtu výsledků, které jsou relevantní pro dotaz. Pole totalEstimatedMatches odpovědi obsahuje odhad počtu obrázků, které jsou k dispozici k zobrazení. Podrobnosti o tom, jak procházet zbývající obrázky, najdete v tématu stránkování obrázků.

Další kroky

Pokud jste ještě nevyzkoušeli rozhraní API Bing pro vyhledávání obrázků, zkuste rychlý průvodce. Pokud hledáte něco složitějšího, zkuste kurz vytvořit jednostráňovou webovou aplikaci.