Введение
Zend_Service_Yahoo
является простым программным интерфейсом
(API) для использования многих программных интерфейсов
портала Yahoo! (Yahoo! REST API). Zend_Service_Yahoo
позволяет искать через Yahoo! Web search, Yahoo! News, Yahoo! Local
и Yahoo! Images. Для того, чтобы использовать Yahoo! REST API, вы
должны иметь ID приложения Yahoo!.
Чтобы получить ID приложения, заполните и отправьте
» форму заявки на получение ID приложения.
Поиск веб-страниц с помощью Yahoo!
Zend_Service_Yahoo
дает возможность поиска веб-страниц
через Yahoo! с помощью метода webSearch()
. Этот метод
принимает строку запроса в качестве первого параметра и
массив опций в качестве необязательного второго параметра.
За полной информацией и списком поддерживаемых опций см.
» документации
Yahoo! Web Search. Метод webSearch()
возвращает
объект Zend_Service_Yahoo_WebResultSet
.
Example #1 Поиск веб-страниц через 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 />';
}
?>
Поиск изображений через Yahoo!
Вы можете искать изображения через Yahoo!, используя метод imageSearch()
класса Zend_Service_Yahoo
. Этот метод принимает строку запроса
в качестве первого параметра и
массив опций в качестве необязательного второго параметра.
За полной информацией и списком поддерживаемых опций см.
» документацию
Yahoo! Image Search.
Example #2 Поиск изображений через 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 />';
}
?>
Поиск торговых и сервисных предприятий по местонахождению через Yahoo!
Вы можете искать торговые и сервисные службы по местонахождению через Yahoo!,
используя метод localSearch()
. За полной информацией
см. » документацию Yahoo! Local Search.
Example #3 Поиск торговых и сервисных предприятий по местонахождению через 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 />';
}
?>
Классы Zend_Service_Yahoo
Все следующие классы возвращаются различными средствами поиска Yahoo!.
Каждое средство поиска возвращает набор результатов определенного типа,
с которым легко производить итерацию. Каждый отдельный результат поиска
заключен в объекте. Все классы наборов результатов реализуют интерфейс
SeekableIterator
, что позволяет легко производить итерацию и
извлечение определенного результата.
Zend_Service_Yahoo_ResultSet
Каждый из классов, реализующих набор результатов поиска, является
наследником базового класса Zend_Service_Yahoo_ResultSet
.
Все наборы результатов поиска возвращают объекты наследников
класса Zend_Service_Yahoo_Result.
Zend_Service_Yahoo_ResultSet::totalResults()
int
totalResults
( void
Возвращает общее количество результатов поиска.
Свойства класса
Свойства класса Zend_Service_Yahoo_ResultSet
Имя |
Тип |
Описание |
totalResultsAvailable |
int |
Общее количество результатов поиска
|
totalResultsReturned |
int |
Количество результатов в данном наборе
|
firstResultPosition |
int |
Позиция первого результата в данном наборе по
отношению к общему количеству результатов поиска
(смещение)
|
Назад к списку классов
Zend_Service_Yahoo_WebResultSet
Zend_Service_Yahoo_WebResultSet
представляет
набор результатов поиска веб-страниц через Yahoo! Web Search.
Note:
Zend_Service_Yahoo_WebResultSet
является наследником класса
Zend_Service_Yahoo_ResultSet.
Назад к списку классов
Zend_Service_Yahoo_ImageResultSet
Zend_Service_Yahoo_ImageResultSet
представляет
набор результатов поиска изображений через Yahoo! Image Search.
Note:
Zend_Service_Yahoo_ImageResultSet
является наследником класса
Zend_Service_Yahoo_ResultSet.
Назад к списку классов
Zend_Service_Yahoo_LocalResultSet
Zend_Service_Yahoo_ImageResultSet
представляет
набор результатов поиска торговых и сервисных предприятий
через Yahoo! Local Search.
Свойства класса Zend_Service_Yahoo_LocalResultSet
Имя |
Тип |
Описание |
resultSetMapURL |
string |
URL страницы, содержащей карту, на которой отмечены
все найденные предприятия.
|
Note:
Zend_Service_Yahoo_LocalResultSet
является наследником
класса Zend_Service_Yahoo_ResultSet.
Назад к списку классов
Zend_Service_Yahoo_NewsResultSet
Zend_Service_Yahoo_ImageResultSet
представляет
набор результатов поиска новостей
через Yahoo! News Search.
Note:
Zend_Service_Yahoo_NewsResultSet
является наследником
класса Zend_Service_Yahoo_ResultSet.
Назад к списку классов
Zend_Service_Yahoo_Result
Каждый из отдельных результатов поиска является объектом класса-наследника от
базового класса Zend_Service_Yahoo_Result
.
Свойства класса
Свойства класса Zend_Service_Yahoo_Result
Имя |
Тип |
Описание |
Title |
string |
Заголовок результата поиска |
Url |
string |
URL результата поиска |
ClickUrl |
string |
URL для ссылки на результат поиска |
Назад к списку классов
Zend_Service_Yahoo_WebResult
Каждый из результатов поиска веб-страниц является объектом
Zend_Service_Yahoo_WebResult
.
Свойства класса
Свойства класса Zend_Service_Yahoo_WebResult
Имя |
Тип |
Описание |
Summary |
string |
Краткий текст |
MimeType |
string |
Тип MIME результата |
ModificationDate |
string |
Дата последнего изменения результата в формате UNIX |
CacheUrl |
string |
Кэш веб-страницы, если есть |
CacheSize |
int |
Размер кэша |
Назад к списку классов
Zend_Service_Yahoo_ImageResult
Каждый из результатов поиска изображений является объектом
Zend_Service_Yahoo_ImageResult
.
Свойства класса
Свойства класса Zend_Service_Yahoo_ImageResult
Имя |
Тип |
Описание |
Summary |
string |
Краткий текст |
RefererUrl |
string |
URL страницы, содержащей найденное изображение |
FileSize |
int |
Размер файла изображения в байтах |
FileFormat |
string |
Формат изображения (bmp, gif, jpeg, png, и т.д.) |
Height |
int |
Высота изображения |
Width |
int |
Ширина изображения |
Thumbnail |
Zend_Service_Yahoo_Image |
Уменьшенная копия изображения |
Назад к списку классов
Zend_Service_Yahoo_LocalResult
Каждый из результатов поиска торговых и сервисных предприятий
является объектом Zend_Service_Yahoo_LocalResult
.
Свойства класса
Свойства класса 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 для ссылки на веб-сайт организации, если есть |
Назад к списку классов
Zend_Service_Yahoo_NewsResult
Каждый отдельный результат News Search возвращается в виде объекта
Zend_Service_Yahoo_NewsResult
.
Свойства класса
Свойства класса Zend_Service_Yahoo_NewsResult
Имя |
Тип |
Описание |
Summary |
string |
Краткий текст |
NewsSource |
string |
Компания, разместившая статью |
NewsSourceUrl |
string |
URL компании, разместившей статью |
Language |
string |
Язык, на котором написана статья |
PublishDate |
string |
Дата размещения новости в формате UNIX |
ModificationDate |
string |
Дата последнего изменения статьи в формате UNIX |
Thumbnail |
Zend_Service_Yahoo_Image |
Уменьшенная копия изображения к статье, если есть |
Назад к списку классов
Zend_Service_Yahoo_Image
Все изображения, возвращаемые Yahoo! Image Search и Yahoo! News Search,
представляются как объекты Zend_Service_Yahoo_Image
.
Свойства класса
Свойства класса Zend_Service_Yahoo_Image
Имя |
Тип |
Описание |
Url |
string |
URL изображения |
Width |
int |
Ширина изображения |
Height |
int |
Высота изображения |
Назад к списку классов