作者:马宁 Bing正式发布没几天,除了功能和搜索结果外,作为开发者来说,我们关心的还有Bing API啥时候能出。周末浏览MSDN网站时,发现Bing Service已经上线了,链接是:http://msdn.microsoft.com/en-us/library/dd900818.aspx
Bing提供的API很丰富,除了搜索外,还增加了广告Ad、图片、新闻、Phonebook、拼写和视频的搜索。而访问协议有三种:JSON, XML和SOAP。JSON协议用于AJAX应用,XML用于Silverlight应用,SOAP用于传统的.NET等强类型程序。可见,微软在推出API方面还是很有效率的。
使用Bing API的第一步,是去Bing Developer Center上申请一个AppId,每个应用应该使用一个单独的AppId。Bing Developer Center的网址是:http://bing.com/developers 。在页面里先用Live ID登录,然后选择Get a new App ID,填写一些基本信息,然后你就会得到一串很长的AppId。需要注意的是,Bing还有一个网址是http://www.bing.com/developer/ ,估计是为1.1版本准备的,现在还不能申请AppId。大家一定要分清楚。
接下来,我们在Visual Studio 2008里创建一个.NET应用。在Project菜单里选择Add Service Reference,在弹出对话框的Address文本框里填入:
http://api.search.live.net/search.wsdl?AppID=yourAppId
注意:AppID=后要填写你申请到的AppId.
在找到LiveSearchService的引用后,将其添加到我们的工程中。接下来,我根据PhoneBook和WebSearch两个例子写了DEMO,更多例子可以参考:
http://msdn.microsoft.com/en-us/library/dd251066.aspx
需要提醒的是,可能是文档没有更新,Bing API的类名称还会发生变化。我发现在2009年6月8日导出的引用中,LiveSearchService的名称变成了LiveSearchPortTypeClient。Web Search的代码如下:
private void button2_Click(object sender, EventArgs e)
{
// LiveSearchService implements IDisposable.
using (LiveSearchPortTypeClient service = new LiveSearchPortTypeClient())
{
try
{
SearchRequest request = BuildRequestWeb();
// Send the request; display the response.
SearchResponse response = service.Search(request);
DisplayResponseWeb(response);
}
catch (System.Net.WebException ex)
{
// An exception occurred while accessing the network.
Console.WriteLine(ex.Message);
}
}
}
private SearchRequest BuildRequestWeb()
{
SearchRequest request = new SearchRequest();
// Common request fields (required)
request.AppId = AppId;
request.Query = "马宁";
request.Sources = new SourceType[] { SourceType.Web };
// Common request fields (optional)
request.Version = "2.0";
request.Market = "en-us";
request.Adult = AdultOption.Moderate;
request.AdultSpecified = true;
request.Options = new SearchOption[]
{
SearchOption.EnableHighlighting
};
// Web-specific request fields (optional)
request.Web = new WebRequest();
request.Web.Count = 30;
request.Web.CountSpecified = true;
request.Web.Offset = 0;
request.Web.OffsetSpecified = true;
request.Web.Options = new WebSearchOption[]
{
WebSearchOption.DisableHostCollapsing,
WebSearchOption.DisableQueryAlterations
};
return request;
}
private void DisplayResponseWeb(SearchResponse response)
{
// Display the results header.
listBox1.Items.Add("Bing API Version " + response.Version);
listBox1.Items.Add("Web results for " + response.Query.SearchTerms);
listBox1.Items.Add(string.Format("Displaying {0} to {1} of {2} results",
response.Web.Offset + 1,
response.Web.Offset + response.Web.Results.Length,
response.Web.Total));
// Display the Web results.
System.Text.StringBuilder builder = new System.Text.StringBuilder();
foreach (WebResult result in response.Web.Results)
{
builder.Length = 0;
builder.AppendLine(result.Title);
builder.AppendLine(result.Description);
builder.AppendLine(result.Url);
builder.Append("Last Crawled: ");
builder.AppendLine(result.DateTime);
listBox1.Items.Add(builder.ToString());
Console.WriteLine();
}
}
从代码上来看,很简单,先创建一个LiveSearchPortTypeClient的对象,然后,创建SearchRequest对象,在Request里需要设置的是AppId,Query和Sources。AppId不用多说了,Query里填我们要查的关键字,Sources里指定SourceType,我们这里指定的是SourceType.Web。
将SearchRequest参数传递给LiveSearchPortTypeClient的Search方法,会返回一个SearchResponse的对象,里边包含我们的搜索结果。结果会包含在response.Web.Results对象里,最主要的参数是Title、Description和Url。
最后的运行结果就是这样的了:
Bing的好坏还需要时间检验,但是Bing API和Google API应该差不多,而且考虑了不同用户的需求,这也许就是软件公司和互联网公司不一样的地方。同时推出的还有Bing Map API,改天试一下。
更多关于Windows Embedded CE开发的文章,请参考“Windows Embedded CE 中国研发团队”的中文博客:http://blogs.msdn.com/wincechina/