Rövid útmutató: Képek keresése a Bing Image Search REST API és a Python használatával
Figyelmeztetés
2020. október 30-án a Bing Search API-k átkerültek az Azure AI-szolgáltatásokból a Bing Search Servicesbe. Ez a dokumentáció csak referenciaként szolgál. A frissített dokumentációt a Bing search API dokumentációjában találja. Az új Azure-erőforrások Bing-kereséshez való létrehozásával kapcsolatos útmutatásért lásd: Bing Search-erőforrás létrehozása a Azure Marketplace keresztül.
Ebből a rövid útmutatóból megtudhatja, hogyan küldhet keresési kéréseket a Bing Image Search API-nak. Ez a Python-alkalmazás egy keresési lekérdezést küld az API-nak, és megjeleníti az első kép URL-címét az eredményekben. Bár ez az alkalmazás Python nyelven van megírva, az API egy RESTful webszolgáltatás, amely kompatibilis a legtöbb programozási nyelvvel.
Előfeltételek
Az alkalmazás létrehozása és inicializálása
Hozzon létre egy új Python-fájlt a kedvenc IDE-jében vagy szerkesztőjében, és importálja a következő modulokat. Hozzon létre egy változót az előfizetési kulcshoz, a keresési végponthoz és a keresési kifejezéshez. A esetében
search_url
használhatja a globális végpontot az alábbi kódban, vagy használhatja az erőforrás Azure Portal megjelenő egyéni altartományvégpontot.import requests import matplotlib.pyplot as plt from PIL import Image from io import BytesIO subscription_key = "your-subscription-key" search_url = "https://api.cognitive.microsoft.com/bing/v7.0/images/search" search_term = "puppies"
Adja hozzá az előfizetési kulcsot a
Ocp-Apim-Subscription-Key
fejléchez egy szótár létrehozásával, és adja hozzá a kulcsot értékként.headers = {"Ocp-Apim-Subscription-Key" : subscription_key}
Keresési kérelem létrehozása és küldése
Hozzon létre egy szótárat a keresési kérelem paramétereihez. Adja hozzá a keresési kifejezést a
q
paraméterhez. Állítsa be alicense
paramétert úgy, hogypublic
a rendszerképeket a nyilvános tartományban keresse meg. Állítsa aimageType
értéket úgyphoto
, hogy csak fényképeket keressen.params = {"q": search_term, "license": "public", "imageType": "photo"}
requests
A kódtár használatával hívja meg a Bing Image Search API-t. Adja hozzá a fejlécet és a paramétereket a kérelemhez, és JSON-objektumként adja vissza a választ. Kérje le az URL-címeket több miniatűr képre a választhumbnailUrl
mezőjéből.response = requests.get(search_url, headers=headers, params=params) response.raise_for_status() search_results = response.json() thumbnail_urls = [img["thumbnailUrl"] for img in search_results["value"][:16]]
A válasz megtekintése
Hozzon létre egy új ábrát négy oszlopból és négy sorból a matplotlib kódtár használatával.
Iterálja végig az ábra sorait és oszlopait, és a PIL-kódtár metódusával
Image.open()
adjon hozzá egy kép miniatűrjét az egyes szóközökhöz.Ezzel
plt.show()
rajzolhatja meg az ábrát, és megjelenítheti a képeket.f, axes = plt.subplots(4, 4) for i in range(4): for j in range(4): image_data = requests.get(thumbnail_urls[i+4*j]) image_data.raise_for_status() image = Image.open(BytesIO(image_data.content)) axes[i][j].imshow(image) axes[i][j].axis("off") plt.show()
Példa JSON-válaszra
A Bing Image Search API válaszai JSON formátumban érkeznek vissza. A mintaválasz egyetlen eredményre van csonkolva.
{
"_type":"Images",
"instrumentation":{
"_type":"ResponseInstrumentation"
},
"readLink":"images\/search?q=tropical ocean",
"webSearchUrl":"https:\/\/www.bing.com\/images\/search?q=tropical ocean&FORM=OIIARP",
"totalEstimatedMatches":842,
"nextOffset":47,
"value":[
{
"webSearchUrl":"https:\/\/www.bing.com\/images\/search?view=detailv2&FORM=OIIRPO&q=tropical+ocean&id=8607ACDACB243BDEA7E1EF78127DA931E680E3A5&simid=608027248313960152",
"name":"My Life in the Ocean | The greatest WordPress.com site in ...",
"thumbnailUrl":"https:\/\/tse3.mm.bing.net\/th?id=OIP.fmwSKKmKpmZtJiBDps1kLAHaEo&pid=Api",
"datePublished":"2017-11-03T08:51:00.0000000Z",
"contentUrl":"https:\/\/mylifeintheocean.files.wordpress.com\/2012\/11\/tropical-ocean-wallpaper-1920x12003.jpg",
"hostPageUrl":"https:\/\/mylifeintheocean.wordpress.com\/",
"contentSize":"897388 B",
"encodingFormat":"jpeg",
"hostPageDisplayUrl":"https:\/\/mylifeintheocean.wordpress.com",
"width":1920,
"height":1200,
"thumbnail":{
"width":474,
"height":296
},
"imageInsightsToken":"ccid_fmwSKKmK*mid_8607ACDACB243BDEA7E1EF78127DA931E680E3A5*simid_608027248313960152*thid_OIP.fmwSKKmKpmZtJiBDps1kLAHaEo",
"insightsMetadata":{
"recipeSourcesCount":0,
"bestRepresentativeQuery":{
"text":"Tropical Beaches Desktop Wallpaper",
"displayText":"Tropical Beaches Desktop Wallpaper",
"webSearchUrl":"https:\/\/www.bing.com\/images\/search?q=Tropical+Beaches+Desktop+Wallpaper&id=8607ACDACB243BDEA7E1EF78127DA931E680E3A5&FORM=IDBQDM"
},
"pagesIncludingCount":115,
"availableSizesCount":44
},
"imageId":"8607ACDACB243BDEA7E1EF78127DA931E680E3A5",
"accentColor":"0050B2"
}]
}