Pobieranie obrazów z Internetu za pomocą interfejsu API wyszukiwania obrazów Bing

Ostrzeżenie

30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest udostępniana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pośrednictwem Azure Marketplace.

Korzystając z interfejsu API REST wyszukiwania obrazów Bing, możesz pobrać obrazy z Internetu powiązane z terminem wyszukiwania, wysyłając następujące żądanie 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

Użyj parametru zapytania q dla terminu wyszukiwania zakodowanego w adresie URL. Jeśli na przykład wprowadzisz pontony żeglarskie, ustaw wartość q lub sailing+dinghiessailing%20dinghies.

Ważne

• Wszystkie żądania muszą być wysyłane z serwera, a nie z klienta.
• Jeśli po raz pierwszy wywołujesz dowolny z interfejsów API wyszukiwania Bing, nie dołączaj nagłówka identyfikatora klienta. Uwzględnij identyfikator klienta tylko wtedy, gdy wcześniej wywołano interfejs API usługi Bing, który zwrócił identyfikator klienta dla kombinacji użytkownika i urządzenia.

Pobieranie obrazów z określonej domeny internetowej

Aby uzyskać obrazy z określonej domeny, należy użyć operatora site: zapytania.

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

Uwaga

Odpowiedzi na zapytania korzystające z site: operatora mogą zawierać zawartość dla dorosłych niezależnie od ustawienia safeSearch . Należy używać site: tylko wtedy, gdy masz świadomość zawartości w domenie.

Filtrowanie obrazów

Domyślnie interfejs API wyszukiwania obrazów zwraca wszystkie obrazy, które są istotne dla zapytania. Jeśli chcesz filtrować obrazy zwracane przez usługę Bing (na przykład w celu zwrócenia tylko obrazów z przezroczystym tłem lub określonym rozmiarem), użyj następujących parametrów zapytania:

• aspekt — filtruj obrazy według współczynnika proporcji (na przykład obrazy standardowe lub szerokiego ekranu).
• kolor — filtruj obrazy według dominującego koloru lub czerni i bieli.
• świeżość — filtruj obrazy według wieku (na przykład obrazy odnalezione przez usługę Bing w ubiegłym tygodniu).
• height, width — filtruj obrazy według szerokości i wysokości.
• imageContent — filtruj obrazy według zawartości (na przykład obrazy pokazujące tylko twarz osoby).
• imageType — filtruj obrazy według typu (na przykład clipart, animowane pliki GIF lub przezroczyste tła).
• license — filtrowanie obrazów według typu licencji skojarzonej z witryną.
• rozmiar — filtruj obrazy według rozmiaru, na przykład małe obrazy o rozmiarze do 200 x 200 pikseli.

Aby uzyskać obrazy z określonej domeny, należy użyć operatora site: zapytania.

W poniższym przykładzie pokazano, jak pobrać małe obrazy z ContosoSailing.com, które usługa Bing odkryła w ubiegłym tygodniu.

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  

Format odpowiedzi wyszukiwania obrazów Bing

Komunikat odpowiedzi z usługi Bing zawiera odpowiedź Images zawierającą listę obrazów określonych przez usługi Azure AI, które mają być istotne dla zapytania. Każdy obiekt Image na liście zawiera następujące informacje o obrazie: adres URL, jego rozmiar, wymiary, format kodowania, adres URL miniatury i wymiary miniatury.

Uwaga

• Obrazy muszą być wyświetlane w kolejności podanej w odpowiedzi.
• Ponieważ formaty i parametry adresów URL mogą ulec zmianie bez powiadomienia, użyj wszystkich adresów URL zgodnie z oczekiwaniami. Nie należy przyjmować zależności od formatu lub parametrów adresu URL, z wyjątkiem przypadków, w których jest to zaznaczone.

{
    "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"
},

Po wywołaniu interfejsu API wyszukiwania obrazów Bing usługa Bing zwraca listę wyników. Lista jest podzestawem całkowitej liczby wyników odpowiednich dla zapytania. Pole totalEstimatedMatches odpowiedzi zawiera szacunkową liczbę obrazów, które są dostępne do wyświetlenia. Aby uzyskać szczegółowe informacje na temat sposobu przeglądania pozostałych obrazów, zobacz Stronicowanie obrazów.

Następne kroki

Jeśli wcześniej nie wypróbowano interfejsu API wyszukiwania obrazów Bing, wypróbuj przewodnik Szybki start. Jeśli szukasz czegoś bardziej złożonego, wypróbuj samouczek, aby utworzyć jednostronicową aplikację internetową.