38.11. Zend_Service_Yahoo
38.11.1. 简介
Zend_Service_Yahoo
是一个实现多个Yahoo! REST 接口的API.
Zend_Service_Yahoo
允许你使用Yahoo! 网页搜索, Yahoo! 新闻,
Yahoo! 本地(Local), Yahoo! 图片. 为了使用 Yahoo! REST API,
你必须拥有一个 Yahoo! Application ID. 要获得它, 请访问
Application ID Request Form.
38.11.2. 用Yahoo!来搜索网页
Zend_Service_Yahoo
允许你用
webSearch()
方法来进行Yahoo! 网页搜索, 它接受一个查询字符串作为参数 ,
用一个可选的数组传递搜索选项. 更多的细节和搜索选项的信息, 请访问
Yahoo! Web Search
Documentation. webSearch()
方法返回一个
Zend_Service_Yahoo_WebResultSet
对象.
例 38.35. 用Yahoo!来搜索网页
<?PHP require_once 'Zend/Service/Yahoo.php'; $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID"); $results = $yahoo->webSearch('PHP'); foreach ($results as $result) { echo $result->Title .'<br />'; } ?>
38.11.3. 用Yahoo!来查找图片
你可以使用Zend_Service_Yahoo
的 imageSearch()
方法来在Yahoo上搜索图片。 。 它接受一个查询字符串作为参数 ,用一个可选的数组传递搜索选项, 就像
webSearch()
method.
更多的细节和搜索选项的信息, 请访问
Yahoo! Image Search
Documentation.
例 38.36. 用Yahoo!来查找图片
<?php require_once 'Zend/Service/Yahoo.php'; $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID"); $results = $yahoo->imageSearch('PHP'); foreach ($results as $result) { echo $result->Title .'<br />'; } ?>
38.11.4. Finding Local Businesses and Services with Yahoo!
You can search for local businesses and services with Yahoo! by using the localSearch()
method.
For full details, please see the
Yahoo! Local Search
Documentation.
例 38.37. 用Yahoo!查找本地商务和服务信息
<?php require_once 'Zend/Service/Yahoo.php'; $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID"); $results = $yahoo->localSearch('Apple Computers', array('zip' => '95014')); foreach ($results as $result) { echo $result->Title .'<br />'; } ?>
38.11.5. 搜索Yahoo! 新闻
搜索Yahoo! 新闻非常简单; 使用 newsSearch()
方法,
如下面的例子. 更多的细节和搜索选项的信息, 请访问
Yahoo! News Search
Documentation.
例 38.38. 搜索Yahoo! 新闻
<?php require_once 'Zend/Service/Yahoo.php'; $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID"); $results = $yahoo->newsSearch('PHP'); foreach ($results as $result) { echo $result->Title .'<br />'; } ?>
38.11.6. Zend_Service_Yahoo 类
不同的Yahoo! 搜索类型会返回下面的这些类. 每个搜索类型返回指定类型的结果集, 我们可以很方便的对它们进行遍历,
每个结果被包含在一种类型的结果集对象中. 所有这些对象都实现了
SeekableIterator
接口, 可以很容易的进行遍历和寻找指定结果。
Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_WebResultSet
Zend_Service_Yahoo_ImageResultSet
Zend_Service_Yahoo_LocalResultSet
Zend_Service_Yahoo_NewsResultSet
Zend_Service_Yahoo_Result
Zend_Service_Yahoo_WebResult
Zend_Service_Yahoo_ImageResult
Zend_Service_Yahoo_LocalResult
Zend_Service_Yahoo_NewsResult
Zend_Service_Yahoo_Image
38.11.6.1. Zend_Service_Yahoo_ResultSet
每类搜索特定的结果集都由这个基类扩展而成
每类搜索特定的结果集都会返回这个搜索特定的 Zend_Service_Yahoo_Result 对象.
38.11.6.1.1. Zend_Service_Yahoo_ResultSet::totalResults()
int totalResults();
返回搜索结果的数量
38.11.6.1.2. Properties
表 38.15. Zend_Service_Yahoo_ResultSet
名称 | 类型 | 描述 |
---|---|---|
totalResultsAvailable | int | 所有找到的结果的数量 |
totalResultsReturned | int | 当前结果集中结果的数量 |
firstResultPosition | int | 当前结果集中的第一条在所有结果中的相对位置 |
Back to Class List
38.11.6.2. Zend_Service_Yahoo_WebResultSet
Zend_Service_Yahoo_WebResultSet
代表 Yahoo! 网页搜索的结果集.
注意 | |
---|---|
|
Back to Class List
38.11.6.3. Zend_Service_Yahoo_ImageResultSet
Zend_Service_Yahoo_ImageResultSet
代表一个 Yahoo! 图片搜索结果集
注意 | |
---|---|
|
Back to Class List
38.11.6.4. Zend_Service_Yahoo_LocalResultSet
Zend_Service_Yahoo_LocalResultSet
代表一个Yahoo!本地搜索的结果集
表 38.16. Zend_Service_Yahoo_LocalResultSet 属性
名称 | 类型 | 描述 |
---|---|---|
resultSetMapURL | string | 包含返回查询结果地图的URL |
注意 | |
---|---|
|
Back to Class List
38.11.6.5. Zend_Service_Yahoo_NewsResultSet
Zend_Service_Yahoo_NewsResultSet
代表一个Yahoo!新闻搜索结果的集合
注意 | |
---|---|
|
Back to Class List
38.11.6.6. Zend_Service_Yahoo_Result
每类搜索特定的结果都由这个基类扩展而成
38.11.6.6.1. Properties
表 38.17. Zend_Service_Yahoo_Result Properties
名称 | 类型 | 描述 |
---|---|---|
Title | string | 结果项的标题 |
Url | string | 结果项的url |
ClickUrl | string | 链接到结果项的url |
Back to Class List
38.11.6.7. Zend_Service_Yahoo_WebResult
每一个网页搜索结果作为一个 Zend_Service_Yahoo_WebResult
对相返回.
38.11.6.7.1. 属性
表 38.18. Zend_Service_Yahoo_WebResult 属性
名称 | 类型 | 描述 |
---|---|---|
Summary | string | 返回结果的摘要 |
mimeType | string | 返回结果的mimetype |
ModificationDate | string | 一个以 UNIX timestamp 表示的最后修改日期. |
CacheUrl | string | 返回结果Yahoo! 网页搜索缓存页面的URL |
CacheSize | int | Cache 项目的大小 |
Back to Class List
38.11.6.8. Zend_Service_Yahoo_ImageResult
每一个图片搜索结果作为一个 Zend_Service_Yahoo_ImageResult
对相返回.
38.11.6.8.1. 属性
表 38.19. Zend_Service_Yahoo_ImageResult 属性
名称 | 类型 | 描述 |
---|---|---|
Summary | string | 返回结果的摘要 |
refererUrl | string | 图片引用页的URL |
FileSize | int | 以bytes为单位的图片大小 |
FileFormat | string | 图片的格式 (bmp, gif, jpeg, png, etc.) |
Height | int | 图片的高 |
Width | int | 图片的宽 |
Thumbnail | Zend_Service_Yahoo_Image | 图片的缩略图 |
Back to Class List
38.11.6.9. Zend_Service_Yahoo_LocalResult
每一个本地搜索结果以 Zend_Service_Yahoo_LocalResult
对相返回.
38.11.6.9.1. 属性
表 38.20. Zend_Service_Yahoo_LocalResult 属性
名称 | 类型 | 描述 |
---|---|---|
Address | string | 搜索结果的街道地址 |
City | string | 搜索结果所在的城市 |
State | string | 搜索结果所在的州 |
Phone | string | 搜索结果相关的电话号码 |
Rating | int | 用户对该结果的评分 |
Distance | float | 从你指定的位置到搜索结果的距离 |
MapUrl | string | 搜索结果地图的URL |
BusinessUrl | string | 商务网站的URL (如果知道的话) |
BusinessClickUrl | string | 链接到商务网站的URL (如果知道的话) |
Back to Class List
38.11.6.10. Zend_Service_Yahoo_NewsResult
每一个新闻搜索结果作为一个 Zend_Service_Yahoo_NewsResult
对相返回.
38.11.6.10.1. 属性
表 38.21. Zend_Service_Yahoo_NewsResult 属性
名称 | 类型 | 描述 |
---|---|---|
Summary | string | 返回结果的摘要 |
NewsSource | string | 发布文章的公司 |
NewsSourceUrl | string | 发布文章的公司的URL |
Language | string | 文章所用的语言 |
PublishDate | string | 用 UNIX timestamp表示的文章发布日期 |
ModificationDate | string | 用 UNIX timestamp表示的文章最后更新日期 |
Thumbnail | Zend_Service_Yahoo_Image | 文章的缩略图,如果有的话 |
Back to Class List
38.11.6.11. Zend_Service_Yahoo_Image
所有的Yahoo!图片和新闻搜索返回的图片都作为
Zend_Service_Yahoo_Image
对相返回
38.11.6.11.1. Properties
表 38.22. Zend_Service_Yahoo_Image Properties
名称 | 类型 | 描述 |
---|---|---|
Url | string | 图片URL |
Width | int | 图片的宽 |
Height | int | 图片的高 |
Back to Class List