Afbeeldingen ophalen van internet met de Bing Afbeeldingen zoeken-API

Waarschuwing

Op 30 oktober 2020 zijn de Bing Search-API's verplaatst van Azure AI-services naar Bing Search Services. Deze documentatie wordt alleen ter referentie verstrekt. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Voor instructies voor het maken van nieuwe Azure-resources voor Bing, zie Een Bing Search-resource maken via de Azure Marketplace.

Wanneer u de REST API van Bing Image Search gebruikt, kunt u afbeeldingen ophalen van internet 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 queryparameter q voor de zoekterm met URL-codering. Als u bijvoorbeeld zeil dinghiesinvoert, stelt u q in op sailing+dinghies of sailing%20dinghies.

Belangrijk

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

Afbeeldingen ophalen uit een specifiek webdomein

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

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 operator site: kunnen inhoud voor volwassenen bevatten, ongeacht de instelling safeSearch. Gebruik alleen site: als u op de hoogte bent van de inhoud in het domein.

Afbeeldingen filteren

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

• aspect: afbeeldingen filteren op hoogte-breedteverhouding (bijvoorbeeld standaardafbeeldingen of breedbeeldafbeeldingen).
• kleur: afbeeldingen filteren op dominante kleur of zwart-wit.
• nieuwheid: afbeeldingen filteren op leeftijd (bijvoorbeeld afbeeldingen die in de afgelopen week door Bing zijn gedetecteerd).
• hoogte, breedte— Afbeeldingen filteren op breedte en hoogte.
• imageContent: afbeeldingen filteren op inhoud (bijvoorbeeld afbeeldingen die alleen het gezicht van een persoon weergeven).
• imageType: afbeeldingen filteren 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 tot 200 x 200 pixels.

Als u afbeeldingen van een specifiek domein wilt ophalen, gebruikt u de site: query-operator.

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  

Reactie-indeling Bing Afbeeldingen Zoeken

Het antwoordbericht van Bing bevat een Afbeeldingen antwoord met een lijst met afbeeldingen die door Azure AI-services zijn bepaald relevant voor de query. Elke Afbeelding object 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 is opgegeven in het antwoord.
• Omdat URL-indelingen en -parameters zonder kennisgeving kunnen worden gewijzigd, gebruikt u alle URL's as-is. U moet niet vertrouwen op de URL-indeling of parameters, behalve waar vermeld.

{
    "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 dat relevant is voor de query. Het totalEstimatedMatches veld van het antwoord bevat een schatting van het aantal afbeeldingen dat beschikbaar is om weer te geven. Zie Paging Imagesvoor 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, probeer dan een quickstart. Als u iets complexer zoekt, kunt u de zelfstudie gebruiken om een web-app met één pagina te maken.