Zend_Service_Yahoo(日本語)

Zend_Service

導入

Zend_Service_Yahoo は、さまざまな Yahoo! REST API 群を使用するための単純な API です。 Zend_Service_Yahoo を使用すると、 Yahoo! Web search、Yahoo! News、Yahoo! Local、Yahoo! Images を検索できるようになります。 Yahoo! REST API を使用するには、 Yahoo! Application ID が必要です。Application ID を取得するには、 Application ID リクエストフォームを使用してください。

Yahoo! を使用したウェブの検索

Zend_Service_Yahoo の webSearch() メソッドを使用すると、Yahoo! でウェブを検索できます。最初の引数に検索パラメータ、オプションで二番目の引数に検索オプションの配列を指定します。指定できるオプションの詳細については Yahoo! Web Search ドキュメントを参照ください。webSearch() メソッドは Zend_Service_Yahoo_WebResultSet オブジェクトを返します。

例878 Yahoo! を使用したウェブの検索

$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->webSearch('PHP');
foreach ($results as $result) {
    echo $result->Title .'<br />';
}

Yahoo! を使用した画像の検索

Zend_Service_Yahoo の imageSearch() メソッドを使用すると、画像の検索ができます。 webSearch() メソッドと同様、最初の引数に検索パラメータ、オプションで二番目の引数に検索オプションの配列を指定します。指定できるオプションの詳細については Yahoo! Image Search ドキュメントを参照ください。

例879 Yahoo! を使用した画像の検索

$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->imageSearch('PHP');
foreach ($results as $result) {
    echo $result->Title .'<br />';
}

Yahoo! を使用した動画の検索

Zend_Service_Yahoo の videoSearch() メソッドを使用すると、Yahoo で動画を検索できます。詳細は Yahoo! Video Search ドキュメントを参照ください。

例880 Yahoo! を使用した動画の検索

$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->videoSearch('PHP');
foreach ($results as $result) {
    echo $result->Title .'<br />';
}

Yahoo! を使用した Local Businesses and Services の検索

localSearch() メソッドを使用すると、 Yahoo! で local businesses and services を検索できます。詳細は Yahoo! Local Search ドキュメントを参照ください。

例881 Yahoo! を使用した Local Businesses and Services の検索

$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->localSearch('Apple Computers', array('zip' => '95014'));
foreach ($results as $result) {
    echo $result->Title .'<br />';
}

Yahoo! News の検索

Yahoo! News を検索するのは簡単です。単に newsSearch() メソッドを下の例のように使用すればよいのです。詳細は Yahoo! News Search ドキュメントを参照ください。

例882 Yahoo! News の検索

$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->newsSearch('PHP');
foreach ($results as $result) {
    echo $result->Title .'<br />';
}

Yahoo! Site Explorer Inbound Links の検索

Yahoo! Site Explorer Inbound Links を検索するのは簡単です。単に inlinkDataSearch() メソッドを下の例のように使用すればいいのです。詳細は Yahoo! Site Explorer Inbound Links ドキュメントを参照ください。

例883 Yahoo! Site Explorer Inbound Links の検索

$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->inlinkDataSearch('http://framework.zend.com/');
foreach ($results as $result) {
    echo $result->Title .'<br />';
}

Yahoo! Site Explorer の PageData の検索

Yahoo! Site Explorer Inbound の PageDate を検索するのは簡単です。単に pageDataSearch() メソッドを下の例のように使用すればいいのです。詳細は Yahoo! Site Explorer PageData ドキュメントを参照ください。

例884 Yahoo! Site Explorer の PageData の検索

$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->pageDataSearch('http://framework.zend.com/');
foreach ($results as $result) {
    echo $result->Title .'<br />';
}

Zend_Service_Yahoo クラス群

Yahoo! 検索から返される結果は、以下のクラスのいずれかとなります。検索の種類によってそれに対応した結果セットが返され、そのセットを順に処理していくと、中には検索の種類に応じた結果オブジェクトが含まれます。すべての結果セットクラスは SeekableIterator インターフェイスを実装しています。そのため、順次処理だけでなく特定の結果の処理も簡単にできます。

Zend_Service_Yahoo_ResultSet

検索の種類に応じた結果セットは、この基底クラスを継承したものです。

各結果セットは、検索の種類に応じた Zend_Service_Yahoo_Result オブジェクトを返します。

Zend_Service_Yahoo_ResultSet::totalResults()

int totalResults();

検索結果として返された結果の総数を返します。

プロパティ

表155 Zend_Service_Yahoo_ResultSet

名前	型	説明
totalResultsAvailable	int	見つかった結果の総数。
totalResultsReturned	int	現在の結果セットに含まれる結果の総数。
firstResultPosition	int	このセットの最初の結果の、結果全体の中での位置。

名前	型	説明
Title	string	結果項目のタイトル
Url	string	結果項目の URL
ClickUrl	string	結果項目へリンクする URL

名前	型	説明
Summary	string	結果の概要
MimeType	string	結果の MIME 型
ModificationDate	string	UNIX タイムスタンプで表した、結果の最終更新時刻
CacheUrl	string	結果に対応する Yahoo! ウェブキャッシュの URL (もし存在すれば)
CacheSize	int	キャッシュエントリの大きさ

名前	型	説明
Address	string	結果の番地
City	string	結果が存在する市
State	string	結果が存在する州
Phone	string	結果の電話番号
Rating	int	結果に対するユーザの評価
Distance	float	指定した位置から結果の位置までの距離
MapUrl	string	結果の地図の URL
BusinessUrl	string	ビジネスウェブサイトの URL (もしわかれば)
BusinessClickUrl	string	ビジネスウェブサイトへのリンク用の URL (もしわかれば)

名前	型	説明
Url	string	画像の URL
Width	int	画像の幅
Height	int	画像の高さ

名前	型	説明
Summary	string	結果の概要
RefererUrl	string	動画を含むページの URL
FileSize	int	動画のサイズを表すバイト数
FileFormat	string	動画のフォーマット (avi, flash, mpeg, msmedia, quicktime, realmedia, など)
Height	int	動画の高さを表すピクセル数
Width	int	動画の幅を表すピクセル数
Duration	int	動画の長さを表す秒数
Channels	int	動画の音声チャネル数
Streaming	boolean	ストリーミング形式かどうか
Thumbnail	Zend_Service_Yahoo_Image	画像のサムネイル