Afbeeldingen van internet ophalen met de Bing Afbeeldingen zoeken-API

  • Artikel

Waarschuwing

Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing-documentatie voor zoeken-API voor bijgewerkte documentatie. Zie Een Zoeken in Bing-resource maken via de Azure Marketplace voor instructies over het maken van nieuwe Azure-resources voor Bing Search.

Wanneer u de Bing Image Search REST API gebruikt, kunt u afbeeldingen van internet ophalen die zijn gerelateerd aan uw zoekterm door de volgende GET-aanvraag te verzenden:

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

Gebruik de q-queryparameter voor uw met URL gecodeerde zoekterm. Als u bijvoorbeeld zeilboten invoert, stelt u in q op sailing+dinghies of sailing%20dinghies.

Belangrijk

  • Alle aanvragen moeten worden gedaan vanaf een server en niet van een client.
  • Als dit de eerste keer is dat u een van de Bing-zoek-API's aanroept, moet u de header van de client-id niet opnemen. Neem alleen de client-id op als u eerder een Bing-API hebt aangeroepen die een client-id voor de combinatie van gebruiker en apparaat heeft geretourneerd.

Afbeeldingen ophalen uit een specifiek webdomein

Als u afbeeldingen uit een bepaald domein wilt opvragen, gebruikt de query-operator site:.

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

Notitie

Antwoorden op query's met behulp van de site: operator kunnen inhoud voor volwassenen bevatten, ongeacht de instelling safeSearch . site: Gebruik alleen als u op de hoogte bent van de inhoud in het domein.

Afbeeldingen filteren

Standaard retourneert de Afbeeldingen zoeken-API alle afbeeldingen die relevant zijn voor de query. Als u de afbeeldingen wilt filteren die bing retourneert (bijvoorbeeld om alleen afbeeldingen met een transparante achtergrond of een specifieke grootte te retourneren), gebruikt u de volgende queryparameters:

  • aspect: filter afbeeldingen op hoogte-breedteverhouding (bijvoorbeeld standaard- of breedbeeldafbeeldingen).
  • color: afbeeldingen filteren op dominante kleur of zwart-wit.
  • nieuwheid: filter afbeeldingen op leeftijd (bijvoorbeeld afbeeldingen die in de afgelopen week door Bing zijn gedetecteerd).
  • hoogte, breedte: afbeeldingen filteren op breedte en hoogte.
  • imageContent: filter afbeeldingen op inhoud (bijvoorbeeld afbeeldingen die alleen het gezicht van een persoon weergeven).
  • imageType: filter afbeeldingen op type (bijvoorbeeld illustraties, GIF-animaties of transparante achtergronden).
  • licentie: filter afbeeldingen op het type licentie dat aan de site is gekoppeld.
  • grootte: filter afbeeldingen op grootte, zoals kleine afbeeldingen van maximaal 200 x 200 pixels.

Als u afbeeldingen uit een bepaald domein wilt opvragen, gebruikt de query-operator site:.

In het volgende voorbeeld ziet u hoe u kleine afbeeldingen kunt ophalen uit ContosoSailing.com die Bing in de afgelopen week heeft gedetecteerd.

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-antwoordindeling

Het antwoordbericht van Bing bevat een antwoord afbeeldingen met een lijst met afbeeldingen waarvan Azure AI-services hebben vastgesteld dat ze relevant zijn voor de query. Elk afbeeldingsobject in de lijst bevat de volgende informatie over de afbeelding: de URL, de grootte, de afmetingen, de coderingsindeling, een URL naar een miniatuur van de afbeelding en de afmetingen van de miniatuur.

Notitie

  • Afbeeldingen moeten worden weergegeven in de volgorde die in het antwoord is opgegeven.
  • Omdat URL-indelingen en -parameters zonder kennisgeving kunnen worden gewijzigd, moet u alle URL's in hun huidige vorm gebruiken. Tenzij anders wordt vermeld, is het beter geen afhankelijkheden van de URL-indeling of parameters te gebruiken.
{
    "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"
},

Wanneer u de Bing Afbeeldingen zoeken-API aanroept, retourneert Bing een lijst met resultaten. De lijst is een subset van het totale aantal resultaten die relevant zijn voor de query. Het veld totalEstimatedMatches in de respons bevat een schatting van het aantal afbeeldingen dat beschikbaar is om weer te geven. Zie Paggineringsafbeeldingen voor meer informatie over het bladeren door de rest van de afbeeldingen.

Volgende stappen

Als u de Bing Afbeeldingen zoeken-API nog niet eerder hebt geprobeerd, probeert u een quickstart. Als u op zoek bent naar iets complexers, kunt u de zelfstudie proberen om een web-app met één pagina te maken.