Delen via

Eindpunten voor 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 zoek-API-documentatie voor bijgewerkte documentatie. Zie Een Zoeken in Bing resource maken via de Azure Marketplace voor instructies voor het maken van nieuwe Azure-resources voor Bing Search.

De Afbeeldingen zoeken-API bevat drie eindpunten. Eindpunt 1 retourneert afbeeldingen van het web op basis van een query. Eindpunt 2 retourneert ImageInsights. Eindpunt 3 retourneert trending afbeeldingen.

Eindpunten

Als u afbeeldingsresultaten wilt ophalen met de Bing-API, verzendt u een aanvraag naar een van de volgende eindpunten. Gebruik de headers en URL-parameters om verdere specificaties te definiëren.

Eindpunt 1: Retourneert afbeeldingen die relevant zijn voor de zoekquery van de gebruiker die is gedefinieerd door ?q="".

GET https://api.cognitive.microsoft.com/bing/v7.0/images/search

Eindpunt 2: Retourneert inzichten over een afbeelding met behulp van GET of POST.

 GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details

Een GET-aanvraag retourneert inzichten over een afbeelding, zoals webpagina's die de afbeelding bevatten. Neem de parameter insightsToken op met een GET aanvraag.

U kunt ook een binaire installatiekopieën opnemen in de hoofdtekst van een POST aanvraag en de parameter modules instellen op RecognizedEntities. Hiermee wordt een insightsToken geretourneerd dat moet worden gebruikt als een parameter in een volgende GET aanvraag, die informatie retourneert over personen in de afbeelding. Stel in modules op om alle inzichten op te halen, behalve RecognizedEntities in de resultaten van de POST zonder nog een aanroep te doen met behulp van de insightsTokenAll .

Eindpunt 3: Retourneert afbeeldingen die trending zijn op basis van zoekaanvragen van anderen. De afbeeldingen zijn onderverdeeld in verschillende categorieën, bijvoorbeeld op basis van opmerkelijke personen of gebeurtenissen.

GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending

Zie Trending Images voor een lijst met markten die trending afbeeldingen ondersteunen.

Zie de naslaginformatie over bing afbeeldingen zoeken-API v7 voor meer informatie over headers, parameters, marktcodes, antwoordobjecten, fouten, enzovoort.

Antwoord-JSON

Het antwoord op een zoekaanvraag voor afbeeldingen bevat resultaten als JSON-objecten. Zie de zelfstudie en broncode voor voorbeelden van het parseren van de resultaten.

Volgende stappen

De Bing-API's ondersteunen zoekacties die resultaten retourneren op basis van hun type. Alle zoekeindpunten retourneren resultaten als JSON-antwoordobjecten.  Alle eindpunten ondersteunen query's die een specifieke taal en/of locatie retourneren op basis van lengtegraad, breedtegraad en zoekradius.

Zie de referentiepagina's voor elk type voor volledige informatie over de parameters die door elk eindpunt worden ondersteund. Zie Snel starten met Afbeeldingen zoeken voor voorbeelden van basisaanvragen met behulp van de Afbeeldingen zoeken-API.