使用 Yahoo!奇摩生活+ API 查詢商家資訊與照片
1. 簡介
Yahoo!奇摩生活+ 提供吃喝玩樂商家資訊搜尋功能，而Yahoo!奇摩生活+ API 提供簡單介面，讓自行開發的程式存取生活+ 內的商家資訊。
目前 Yahoo!奇摩生活+ API 最新版本為 Beta V0.3，可利用關鍵字查詢相關的商店資料，其中包含每一個商家完整的評價分數，照片以及評價。
2. 方法
2.1 取得應用程式帳號
填寫相關資訊
取得 AppID，以供後續調用 API 使用
2.2 生活+ API 使用方式
在生活+API 方法列表中，可以了解運作方式為給網址，於網址下方法與參數，則回傳查詢結果，格式為 XML。
在此，我挑了三個方法做介紹
(1) 驗證 AppID
在 2.1 中所取得的 AppID，需透過此方法做驗證，透過
http://tw.lifestyle.yahooapis.com/v0.3/Auth.bootUp?appid=您申請的AppID
以下為驗證成功時，回傳的 XML 檔如下所示
(2) Biz.search 搜尋商家
搜尋商家資訊可以說是生活+最主要的功能，透過
http://tw.lifestyle.yahooapis.com/v0.3/Biz.search?appid=您申請的AppID&BizName=店家名稱&photo=1&address&page=1
在這裡我們試著搜尋Burgerking，回傳的 XML 檔如下所示，而XML檔有使用 CDATA 類型，因此之後程式處理時，可以以此作為判斷
*註 : 在這邊取得的 PhotoUrl 照片網址不能使用
(3) Biz.GetPhotos 取得商家的照片
在上個步驟中，取得了 BizID，可透過它來取得商家的照片，透過
http://tw.lifestyle.yahooapis.com/v0.3/Biz.getPhotos?appid=您申請的AppID&ID=商家ID&begin=1&limit=100
以下為剛剛取得的商家ID FS5597S38519 ，回傳的 XML 檔如下所示
2.3 程式碼
以下程式碼使用了 Yahoo! 生活+ API 兩個功能，Biz.search：搜尋商家 與 Biz.getPhotos：取得商家的照片，取得 XML 檔後做資料處理與顯示。
using System;
using System.Linq;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using System.Net;
using System.IO;
using System.Xml;
namespace SmartDeviceYahooAPI
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}
string AppID = "PLtuj_nV34GetDQ2lZkv_n1.ShfGDzbpPlz8IxcYUm_fZqQzkWGO0bI2o22GahR.4Q--"; // 修改成您的 Yahoo! App ID
// Search Button
private void btnSearch_Click(object sender, EventArgs e)
{
string url = @"http://tw.lifestyle.yahooapis.com/v0.3/Biz.search?appid=" + this.AppID + @"&BizName=" + this.txtQuery.Text + @"&address=&page=1";
string strBizId = string.Empty;
try
{
// 建立 XML 讀取器
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true; // 不處理註解
settings.IgnoreWhitespace = true; // 跳過空白
settings.ValidationType = ValidationType.None; // 不驗證任何資料
XmlReader reader = XmlTextReader.Create(url, settings);
string sName = "";
while (reader.Read())
{
switch (reader.NodeType)// 取得目前節點型別
{
case XmlNodeType.Element:
sName = reader.Name;
if (sName == "Biz") // 取得 BizID
{
string Name = reader["id"];
strBizId = Name;
}
break;
case XmlNodeType.CDATA: // 當節點型別為 CDATA
switch (sName)
{
case "Name":
txtName.Text = reader.Value.Replace("<em>", "").Replace("</em>", "");
break;
case "Address":
txtAddress.Text = reader.Value.Replace("<em>", "").Replace("</em>", "");
break;
case "Tel":
txtTel.Text = reader.Value.Replace("<em>", "").Replace("</em>", "");
break;
case "Comment":
txtComment.Text = reader.Value.Replace("<em>", "").Replace("</em>", "");
break;
case "LatLong":
txtLatLong.Text = reader.Value;
GetPhoto(strBizId); // 取得商家照片，傳入BizID
return;
break;
}
break;
}
}
}
catch (System.Xml.XmlException xe)
{
MessageBox.Show(xe.Message);
}
}
/// <summary>
/// 取得商家圖片
/// </summary>
/// <param name="strBizId">BizID商家ID</param>
private void GetPhoto(string strBizId)
{
this.lstPhoto.Items.Clear();
if (strBizId == string.Empty)
{
return;
}
string url = @"http://tw.lifestyle.yahooapis.com/v0.3/Biz.getPhotos?appid=" + this.AppID + @"&ID=" + strBizId + @"&begin=1&limit=100";
try
{
// 建立 XML 讀取器
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true; // 不處理註解
settings.IgnoreWhitespace = true; // 跳過空白
settings.ValidationType = ValidationType.None; // 不驗證任何資料
XmlReader reader = XmlTextReader.Create(url, settings);
string sName = "";
while (reader.Read())
{
switch (reader.NodeType) // 取得目前節點型別
{
case XmlNodeType.Element:
sName = reader.Name;
break;
case XmlNodeType.CDATA: // 當節點型別為 CDATA
switch (sName)
{
case "Url":
this.lstPhoto.Items.Add(reader.Value);
break;
//在此先不抓大中小圖
//case "SUrl":
// this.listBox1.Items.Add(reader.Value);
// break;
//case "MUrl":
// this.listBox1.Items.Add(reader.Value);
// break;
//case "LUrl":
// this.listBox1.Items.Add(reader.Value);
// break;
}
break;
}
}
// 假如有ListBox中有照片網址的話，則選擇第一筆資料(index = 0)作為預設值
if (this.lstPhoto.Items.Count > 0)
{
this.lstPhoto.SelectedIndex = 0;
}
}
catch (System.Xml.XmlException xe)
{
MessageBox.Show(xe.Message);
}
}
private void lstPhoto_SelectedIndexChanged(object sender, EventArgs e)
{
if (this.lstPhoto.SelectedIndex > -1) // 當使用者選擇ListBox中的照片網址時
{
// 讀取網路圖片到 PictureBox
HttpWebRequest req = (HttpWebRequest)WebRequest.Create(lstPhoto.SelectedItem.ToString());
HttpWebResponse rsp = (HttpWebResponse)req.GetResponse();
if (rsp.StatusCode == System.Net.HttpStatusCode.OK)
{
this.PicBoxPhoto.Image = new Bitmap(rsp.GetResponseStream());
}
rsp.Close();
}
}
}
}
3. 結果
以下為搜尋 Starbucks 與 Burgerking 的結果，於 Windows Mobile 6.5 模擬(英文)
以下為搜尋 花園夜市 的結果，於 Windows Mobile 6 模擬 (中文)
4. 檔案下載