Google Image Search的API中文文档

API and Document by Ilan Assayag

Translated by hidecloud

这是一位来自以色列的朋友编写的Google Image Search的API，现将快速使用文档翻译如下，希望对大家有所帮助。

如需转载请注明以上信息。

---

简介

作为我正在进行的研究的一部分，我需要向很多流行的图片搜索引擎发送搜索查询。Yahoo！的家伙们给我们提供了Yahoo! SDK API ，一个非常有用的玩意。但Google呢，嗯，由于某些未知的理由，只提供了传统的搜索引擎API，不能进行图片搜索。几周前，我看到了一个Peter Bromberg 做的Google Translation工具。我想为什么不为Google Image也做一个这样的API呢，所以我就做了。

源文件里有什么？

源文件里包含有两个项目。Ilan.Google.API 这个项目包含有一个DLL文件，你可以使用这个DLL文件去访问Google Image。Ilan.Test.Google.API 这个项目包含了一个利用此API开发的简单程序，你可以在这个程序里动态的搜索图片并现实在窗体内。当你双击一张图片的缩略图时，原始图片将会显现出来。这个程序的作用就在于展现此API使用起来是多么的方便。

立即上手——怎样使用此API？

如果你对此API是如何运作的不感兴趣，而只是想简单的使用它，那么这一段就是专为你准备的 🙂

l 在你的项目的“引用”中添加Ilan.Google.API库。

l 在代码里添加：

using Ilan.Google.API.ImageSearch;

l 当你需要进行搜索查询时，先确认你的URL是被Google所支持的。为了确保此点，我建议你去Google Image Search搜索一下，然后看一看他们是怎么构建URL的。当然，如果你只是想搜索一些简单的查询，比如只用空格间断的词组，你只需要将空格转换为+号即可。比如apple cake就必须转换为apple+cake。所以我并不推荐你简单的使用一个string.Replace ，你可以使用在我的DEMO里使用的方法：

string formattedQuery =

Regex.Replace(nonFormattedQuery, @“\s{1,}”, “+”);

l 要进行一个查询（只获取50个结果），可以使用SearchService.SearchImages ：

SearchResponse response =

SearchService.SearchImages(formattedQuery, 1, 50, true);

l 这样 response 这个对象就获得了你查询的词组的所有的50张图片。例如，你可以这样获得返回的第一张图片的URL：

string firstImageUrl = response.Results[0].ImageUrl;

l SearchService.SearchImages的参数有以下几个：

(string) query– 被发送的搜索查询字符串。

(int) startPosition– 返回的结果从哪个页面（指用GOOGLE IMAGE搜索时显示的页面）开始获取。

(int) resultsRequested– 返回多少张图片，但必须在(1000 – startPosition)之内。

(bool) filterSimilarResults– 如果你将此参数设置为‘true‘，那么搜索结果中重复的图片将会被剔除，如果设置为 ‘false‘，则不会对结果进行改动。

[optional: (SafeSearchFiltering) safeSearch – 这个参数有三个选项，可以过滤的你的搜索结果。