Punkty końcowe 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.
Interfejs API wyszukiwania obrazów zawiera trzy punkty końcowe. Punkt końcowy 1 zwraca obrazy z sieci Web na podstawie zapytania. Punkt końcowy 2 zwraca element ImageInsights. Punkt końcowy 3 zwraca popularne obrazy.
Punkty końcowe
Aby uzyskać wyniki obrazu przy użyciu interfejsu API Bing, wyślij żądanie do jednego z następujących punktów końcowych. Użyj nagłówków i parametrów adresu URL, aby zdefiniować dalsze specyfikacje.
Punkt końcowy 1: Zwraca obrazy, które są istotne dla zapytania wyszukiwania użytkownika zdefiniowanego przez ?q=""element .
GET https://api.cognitive.microsoft.com/bing/v7.0/images/search
Punkt końcowy 2: Zwraca szczegółowe informacje o obrazie przy użyciu polecenia GET lub POST.
GET or POST https://api.cognitive.microsoft.com/bing/v7.0/images/details
Żądanie GET zwraca szczegółowe informacje o obrazie, takie jak strony sieci Web zawierające obraz. Dołącz parametr insightsToken do GET żądania.
Możesz również uwzględnić obraz binarny w treści POST żądania i ustawić parametr modules na RecognizedEntitieswartość . Spowoduje to zwrócenie tokenu insightsToken do użycia jako parametru w kolejnym GET żądaniu, które zwraca informacje o osobach na obrazie. Ustaw modules wartość , aby All uzyskać wszystkie szczegółowe informacje, z wyjątkiem RecognizedEntities wyników bez POST wykonywania innego wywołania przy użyciu .insightsToken
Punkt końcowy 3: Zwraca obrazy, które są popularne na podstawie żądań wyszukiwania wysyłanych przez inne osoby. Obrazy są rozdzielane na różne kategorie, na przykład na podstawie godnych uwagi osób lub wydarzeń.
GET https://api.cognitive.microsoft.com/bing/v7.0/images/trending
Aby uzyskać listę rynków, które obsługują popularne obrazy, zobacz Trending Images (Trending Images).
Aby uzyskać szczegółowe informacje o nagłówkach, parametrach, kodach rynku, obiektach odpowiedzi, błędach itp., zobacz dokumentację interfejsu API wyszukiwania obrazów Bing w wersji 7 .
Kod JSON odpowiedzi
Odpowiedź na żądanie wyszukiwania obrazów zawiera wyniki jako obiekty JSON. Przykłady analizowania wyników można znaleźć w samouczku i kodzie źródłowym.
Następne kroki
Interfejsy API Bing obsługują akcje wyszukiwania, które zwracają wyniki zgodnie z ich typem. Wszystkie punkty końcowe wyszukiwania zwracają wyniki jako obiekty odpowiedzi JSON. Wszystkie punkty końcowe obsługują zapytania zwracające określony język i/lub lokalizację według długości geograficznej, szerokości geograficznej i promienia wyszukiwania.
Aby uzyskać pełne informacje o parametrach obsługiwanych przez poszczególne punkty końcowe, zobacz strony referencyjne dla każdego typu. Aby zapoznać się z przykładami podstawowych żądań przy użyciu interfejsu API wyszukiwania obrazów, zobacz Szybki start wyszukiwania obrazów.