1 <sect1 id="zend.service.yahoo">
2 <title>Zend_Service_Yahoo</title>
3 <sect2 id="zend.service.yahoo.introduction">
4 <title>Введение<!--Introduction--></title>
6 <code>Zend_Service_Yahoo</code> является простым программным интерфейсом
7 (API) для использования многих программных интерфейсов
8 портала Yahoo! (Yahoo! REST API). <code>Zend_Service_Yahoo</code>
9 позволяет искать через Yahoo! Web search, Yahoo! News, Yahoo! Local
10 и Yahoo! Images. Для того, чтобы использовать Yahoo! REST API, вы
11 должны иметь ID приложения Yahoo!.
12 Чтобы получить ID приложения, заполните и отправьте
13 <ulink url="http://api.search.yahoo.com/webservices/register_application">форму заявки на получение ID приложения</ulink>.
15 <code>Zend_Service_Yahoo</code> is a simple API for using many
16 of the Yahoo! REST APIs.
17 <code>Zend_Service_Yahoo</code> allows you to search Yahoo!
18 Web search, Yahoo! News, Yahoo! Local, Yahoo!
19 Images. In order to use the Yahoo! REST API, you must have a
20 Yahoo! Application ID. To obtain an Application ID, please complete
22 <ulink url="http://api.search.yahoo.com/webservices/register_application">Application ID Request Form</ulink>.
26 <sect2 id="zend.service.yahoo.websearch">
27 <title>Поиск веб-страниц с помощью Yahoo!<!--Searching the Web with Yahoo!--></title>
29 <code>Zend_Service_Yahoo</code> дает возможность поиска веб-страниц
30 через Yahoo! с помощью метода <code>webSearch()</code>. Этот метод
31 принимает строку запроса в качестве первого параметра и
32 массив опций в качестве необязательного второго параметра.
33 За полной информацией и списком поддерживаемых опций см.
34 <ulink url="http://developer.yahoo.net/search/web/V1/webSearch.html">документации
35 Yahoo! Web Search</ulink>. Метод <code>webSearch()</code> возвращает
36 объект <code>Zend_Service_Yahoo_WebResultSet</code>.
38 <code>Zend_Service_Yahoo</code> enables you to search the Web with Yahoo!
39 using the <code>webSearch()</code> method, which accepts
40 a string query parameter and an optional second parameter
41 as an array of search options. For full details and an option list, please visit the
42 <ulink url="http://developer.yahoo.net/search/web/V1/webSearch.html">Yahoo! Web Search
43 Documentation</ulink>. The <code>webSearch()</code> method returns a
44 <code>Zend_Service_Yahoo_WebResultSet</code> object.
48 <title>Поиск веб-страниц через Yahoo!<!--Searching the Web with Yahoo!--></title>
49 <programlisting><![CDATA[<?php
50 require_once 'Zend/Service/Yahoo.php';
51 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
52 $results = $yahoo->webSearch('PHP');
53 foreach ($results as $result) {
54 echo $result->Title .'<br />';
56 ?>]]> </programlisting>
59 <sect2 id="zend.service.yahoo.imagesearch">
60 <title>Поиск изображений через Yahoo!<!--Finding Images with Yahoo!--></title>
62 Вы можете искать изображения через Yahoo!, используя метод <code>imageSearch()</code>
63 класса <code>Zend_Service_Yahoo</code>. Этот метод принимает строку запроса
64 в качестве первого параметра и
65 массив опций в качестве необязательного второго параметра.
66 За полной информацией и списком поддерживаемых опций см.
67 <ulink url="http://developer.yahoo.net/search/web/V1/webSearch.html">документацию
68 Yahoo! Image Search</ulink>.
70 You can search for Images with Yahoo using <code>Zend_Service_Yahoo</code>'s <code>imageSearch()</code>
71 method. This method accepts a string query parameter and an optional array of search options, as for the
72 <link linkend="zend.service.yahoo.websearch"><code>webSearch()</code> method</link>. For full details
73 and an option list, please visit the
74 <ulink url="http://developer.yahoo.net/search/image/V1/imageSearch.html">Yahoo! Image Search
75 Documentation</ulink>.
79 <title>Поиск изображений через Yahoo!<!--Finding Images with Yahoo!--></title>
80 <programlisting><![CDATA[<?php
81 require_once 'Zend/Service/Yahoo.php';
82 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
83 $results = $yahoo->imageSearch('PHP');
84 foreach ($results as $result) {
85 echo $result->Title .'<br />';
87 ?>]]> </programlisting>
90 <sect2 id="zend.service.yahoo.localsearch">
91 <title>Поиск торговых и сервисных предприятий по местонахождению через Yahoo!<!--Finding Local Businesses and Services with Yahoo!--></title>
93 Вы можете искать торговые и сервисные службы по местонахождению через Yahoo!,
94 используя метод <code>localSearch()</code>. За полной информацией
95 см. <ulink url="http://developer.yahoo.net/search/local/V1/localSearch.html">документацию Yahoo! Local Search</ulink>.
97 You can search for local businesses and services with Yahoo! by using the <code>localSearch()</code> method.
98 For full details, please see the
99 <ulink url="http://developer.yahoo.net/search/local/V1/localSearch.html">Yahoo! Local Search
100 Documentation</ulink>.
104 <title>Поиск торговых и сервисных предприятий по местонахождению через Yahoo!<!--Finding Local Businesses and Services with Yahoo!--></title>
105 <programlisting><![CDATA[<?php
106 require_once 'Zend/Service/Yahoo.php';
107 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
108 $results = $yahoo->localSearch('Apple Computers', array('zip' => '95014'));
109 foreach ($results as $result) {
110 echo $result->Title .'<br />';
112 ?>]]> </programlisting>
115 <sect2 id="zend.service.yahoo.newssearch">
116 <title>Поиск через Yahoo! News<!--Searching Yahoo! News--></title>
118 Поиск новостей через Yahoo! News довольно простой —
119 используйте метод <code>newsSearch()</code>, как показано в
120 следующем примере. За подробностями см. <ulink url="http://developer.yahoo.net/search/news/V1/newsSearch.html">документацию Yahoo! News Search</ulink>.
122 Searching Yahoo! News is simple; just use the <code>newsSearch()</code> method, as in the following
123 example. For full details, please see the
124 <ulink url="http://developer.yahoo.net/search/news/V1/newsSearch.html">Yahoo! News Search
125 Documentation</ulink>.
129 <title>Поиск через Yahoo! News<!--Searching Yahoo! News--></title>
130 <programlisting><![CDATA[<?php
131 require_once 'Zend/Service/Yahoo.php';
132 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
133 $results = $yahoo->newsSearch('PHP');
134 foreach ($results as $result) {
135 echo $result->Title .'<br />';
137 ?>]]> </programlisting>
140 <sect2 id="zend.service.yahoo.classes">
141 <title>Классы Zend_Service_Yahoo</title>
143 Все следующие классы возвращаются различными средствами поиска Yahoo!.
144 Каждое средство поиска возвращает набор результатов определенного типа,
145 с которым легко производить итерацию. Каждый отдельный результат поиска
146 заключен в объекте. Все классы наборов результатов реализуют интерфейс
147 <code>SeekableIterator</code>, что позволяет легко производить итерацию и
148 извлечение определенного результата.
150 The following classes are all returned by the various Yahoo! searches.
151 Each search type returns a
152 type-specific result set which can be easily iterated, with each result
153 being contained in a type result
154 object. All result set classes implement the <code>SeekableIterator</code>
155 interface, allowing for easy
156 iteration and seeking to a specific result.
159 <listitem><para><link linkend="zend.service.yahoo.classes.resultset"><code>Zend_Service_Yahoo_ResultSet</code></link></para></listitem>
160 <listitem><para><link linkend="zend.service.yahoo.classes.webresultset"><code>Zend_Service_Yahoo_WebResultSet</code></link></para></listitem>
161 <listitem><para><link linkend="zend.service.yahoo.classes.imageresultset"><code>Zend_Service_Yahoo_ImageResultSet</code></link></para></listitem>
162 <listitem><para><link linkend="zend.service.yahoo.classes.localresultset"><code>Zend_Service_Yahoo_LocalResultSet</code></link></para></listitem>
163 <listitem><para><link linkend="zend.service.yahoo.classes.newsresultset"><code>Zend_Service_Yahoo_NewsResultSet</code></link></para></listitem>
164 <listitem><para><link linkend="zend.service.yahoo.classes.result"><code>Zend_Service_Yahoo_Result</code></link></para></listitem>
165 <listitem><para><link linkend="zend.service.yahoo.classes.webresult"><code>Zend_Service_Yahoo_WebResult</code></link></para></listitem>
166 <listitem><para><link linkend="zend.service.yahoo.classes.imageresult"><code>Zend_Service_Yahoo_ImageResult</code></link></para></listitem>
167 <listitem><para><link linkend="zend.service.yahoo.classes.localresult"><code>Zend_Service_Yahoo_LocalResult</code></link></para></listitem>
168 <listitem><para><link linkend="zend.service.yahoo.classes.newsresult"><code>Zend_Service_Yahoo_NewsResult</code></link></para></listitem>
169 <listitem><para><link linkend="zend.service.yahoo.classes.image"><code>Zend_Service_Yahoo_Image</code></link></para></listitem>
172 <sect3 id="zend.service.yahoo.classes.resultset">
173 <title>Zend_Service_Yahoo_ResultSet</title>
175 Каждый из классов, реализующих набор результатов поиска, является
176 наследником базового класса <code>Zend_Service_Yahoo_ResultSet</code>.
178 Each of the search specific result sets is extended from this base class.
182 Все наборы результатов поиска возвращают объекты наследников
183 класса <link linkend="zend.service.yahoo.classes.result">Zend_Service_Yahoo_Result</link>.
185 Each of the specific result sets returns a search specific
186 <link linkend="zend.service.yahoo.classes.result">Zend_Service_Yahoo_Result</link> objects.
189 <sect4 id="zend.service.yahoo.classes.resultset.totalResults">
190 <title>Zend_Service_Yahoo_ResultSet::totalResults()</title>
194 <methodname>totalResults</methodname>
199 Возвращает общее количество результатов поиска.
201 Returns the number of results returned for the search.
205 <sect4 id="zend.service.yahoo.classes.resultset.properties">
206 <title>Свойства класса</title>
208 <title>Свойства класса Zend_Service_Yahoo_ResultSet</title>
214 <entry>Описание</entry>
219 <entry>totalResultsAvailable</entry>
222 Общее количество результатов поиска
223 <!--Total number of results found.-->
227 <entry>totalResultsReturned</entry>
230 Количество результатов в данном наборе
231 <!--Number of results in the current result set-->
235 <entry>firstResultPosition</entry>
238 Позиция первого результата в данном наборе по
239 отношению к общему количеству результатов поиска
241 <!--Position of the first result in this
242 set relative to the total number of results.-->
249 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
253 <sect3 id="zend.service.yahoo.classes.webresultset">
254 <title>Zend_Service_Yahoo_WebResultSet</title>
256 <code>Zend_Service_Yahoo_WebResultSet</code> представляет
257 набор результатов поиска веб-страниц через Yahoo! Web Search.
259 <code>Zend_Service_Yahoo_WebResultSet</code> represents a Yahoo! Web Search result set
265 <code>Zend_Service_Yahoo_WebResultSet</code> является наследником класса
266 <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>.
268 <code>Zend_Service_Yahoo_WebResultSet</code> extends <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
273 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
276 <sect3 id="zend.service.yahoo.classes.imageresultset">
277 <title>Zend_Service_Yahoo_ImageResultSet</title>
279 <code>Zend_Service_Yahoo_ImageResultSet</code> представляет
280 набор результатов поиска изображений через Yahoo! Image Search.
282 <code>Zend_Service_Yahoo_ImageResultSet</code> represents a Yahoo! Image Search result set
288 <code>Zend_Service_Yahoo_ImageResultSet</code> является наследником класса
289 <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>.
291 <code>Zend_Service_Yahoo_ImageResultSet</code> extends <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
296 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
299 <sect3 id="zend.service.yahoo.classes.localresultset">
300 <title>Zend_Service_Yahoo_LocalResultSet</title>
302 <code>Zend_Service_Yahoo_ImageResultSet</code> представляет
303 набор результатов поиска торговых и сервисных предприятий
304 через Yahoo! Local Search.
306 <code>Zend_Service_Yahoo_LocalResultSet</code> represents a Yahoo! Local Search result set
311 <title>Свойства класса Zend_Service_Yahoo_LocalResultSet</title>
317 <entry>Описание</entry>
322 <entry>resultSetMapURL</entry>
323 <entry>string</entry>
325 URL страницы, содержащей карту, на которой отмечены
326 все найденные предприятия.
327 <!--The URL of a webpage containing a map
328 graphic with all returned results plotted on it.-->
336 <code>Zend_Service_Yahoo_LocalResultSet</code> является наследником
337 класса <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>.
339 <code>Zend_Service_Yahoo_LocalResultSet</code> extends <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
344 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
347 <sect3 id="zend.service.yahoo.classes.newsresultset">
348 <title>Zend_Service_Yahoo_NewsResultSet</title>
350 <code>Zend_Service_Yahoo_ImageResultSet</code> представляет
351 набор результатов поиска новостей
352 через Yahoo! News Search.
354 <code>Zend_Service_Yahoo_NewsResultSet</code> represents a Yahoo! News Search result set
360 <code>Zend_Service_Yahoo_NewsResultSet</code> является наследником
361 класса <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>.
363 <code>Zend_Service_Yahoo_NewsResultSet</code> extends <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
368 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
371 <sect3 id="zend.service.yahoo.classes.result">
372 <title>Zend_Service_Yahoo_Result</title>
374 Каждый из отдельных результатов поиска является объектом класса-наследника от
375 базового класса <code>Zend_Service_Yahoo_Result</code>.
377 Each of the search specific results is extended from this base class.
380 <sect4 id="zend.service.yahoo.classes.result.properties">
381 <title>Свойства класса</title>
383 <title>Свойства класса Zend_Service_Yahoo_Result</title>
389 <entry>Описание</entry>
395 <entry>string</entry>
396 <entry>Заголовок результата поиска<!--Title of the Result item--></entry>
400 <entry>string</entry>
401 <entry>URL результата поиска<!--The URL of the result item--></entry>
404 <entry>ClickUrl</entry>
405 <entry>string</entry>
406 <entry>URL для ссылки на результат поиска<!--The URL for linking to the result item--></entry>
412 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
416 <sect3 id="zend.service.yahoo.classes.webresult">
417 <title>Zend_Service_Yahoo_WebResult</title>
419 Каждый из результатов поиска веб-страниц является объектом
420 <code>Zend_Service_Yahoo_WebResult</code>.
422 Each Web Search result is returned as a <code>Zend_Service_Yahoo_WebResult</code> object.
425 <sect4 id="zend.service.yahoo.classes.webresult.properties">
426 <title>Свойства класса</title>
428 <title>Свойства класса Zend_Service_Yahoo_WebResult</title>
434 <entry>Описание</entry>
439 <entry>Summary</entry>
440 <entry>string</entry>
441 <entry>Краткий текст<!--Result summary--></entry>
444 <entry>MimeType</entry>
445 <entry>string</entry>
446 <entry>Тип MIME результата<!--Result mimetype--></entry>
449 <entry>ModificationDate</entry>
450 <entry>string</entry>
451 <entry>Дата последнего изменения результата в формате UNIX<!--The last modification date of the result as a UNIX timestamp.--></entry>
454 <entry>CacheUrl</entry>
455 <entry>string</entry>
456 <entry>Кэш веб-страницы, если есть<!--Yahoo! web cache URL for the result, if it exists.--></entry>
459 <entry>CacheSize</entry>
461 <entry>Размер кэша<!--The size of the Cache entry--></entry>
467 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
471 <sect3 id="zend.service.yahoo.classes.imageresult">
472 <title>Zend_Service_Yahoo_ImageResult</title>
474 Каждый из результатов поиска изображений является объектом
475 <code>Zend_Service_Yahoo_ImageResult</code>.
477 Each Image Search result is returned as a <code>Zend_Service_Yahoo_ImageResult</code> object.
480 <sect4 id="zend.service.yahoo.classes.imageresult.properties">
481 <title>Свойства класса</title>
483 <title>Свойства класса Zend_Service_Yahoo_ImageResult</title>
489 <entry>Описание</entry>
494 <entry>Summary</entry>
495 <entry>string</entry>
496 <entry>Краткий текст<!--Result summary--></entry>
499 <entry>RefererUrl</entry>
500 <entry>string</entry>
501 <entry>URL страницы, содержащей найденное изображение<!--The URL of the page which contains the image--></entry>
504 <entry>FileSize</entry>
506 <entry>Размер файла изображения в байтах<!--The size of the image file in bytes--></entry>
509 <entry>FileFormat</entry>
510 <entry>string</entry>
511 <entry>Формат изображения (bmp, gif, jpeg, png, и т.д.)<!--The format of the image (bmp, gif, jpeg, png, etc.)--></entry>
514 <entry>Height</entry>
516 <entry>Высота изображения<!--The height of the image--></entry>
521 <entry>Ширина изображения<!--The width of the image--></entry>
524 <entry>Thumbnail</entry>
525 <entry><link linkend="zend.service.yahoo.classes.image">Zend_Service_Yahoo_Image</link></entry>
526 <entry>Уменьшенная копия изображения<!--Image thumbnail--></entry>
532 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
536 <sect3 id="zend.service.yahoo.classes.localresult">
537 <title>Zend_Service_Yahoo_LocalResult</title>
539 Каждый из результатов поиска торговых и сервисных предприятий
540 является объектом <code>Zend_Service_Yahoo_LocalResult</code>.
542 Each Local Search result is returned as a <code>Zend_Service_Yahoo_LocalResult</code> object.
545 <sect4 id="zend.service.yahoo.classes.localresult.properties">
546 <title>Свойства класса</title>
548 <title>Свойства класса Zend_Service_Yahoo_LocalResult</title>
554 <entry>Описание</entry>
559 <entry>Address</entry>
560 <entry>string</entry>
561 <entry>Адрес организации<!--Street Address of the result--></entry>
565 <entry>string</entry>
566 <entry>Город<!--City in which the result resides in--></entry>
570 <entry>string</entry>
571 <entry>Штат<!--State in which the result resides in--></entry>
575 <entry>string</entry>
576 <entry>Телефон<!--Phone number for the result--></entry>
579 <entry>Rating</entry>
581 <entry>Рейтинг<!--User submitted rating for the result--></entry>
584 <entry>Distance</entry>
586 <entry>Расстояние от заданного местонахождения<!--The distance to the result from your specified location--></entry>
589 <entry>MapUrl</entry>
590 <entry>string</entry>
591 <entry>URL карты<!--A URL of a map for the result--></entry>
594 <entry>BusinessUrl</entry>
595 <entry>string</entry>
596 <entry>URL веб-сайта организации, если есть<!--The URL for the business website, if known--></entry>
599 <entry>BusinessClickUrl</entry>
600 <entry>string</entry>
601 <entry>URL для ссылки на веб-сайт организации, если есть<!--The URL for linking to the business website, if known--></entry>
607 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
611 <sect3 id="zend.service.yahoo.classes.newsresult">
612 <title>Zend_Service_Yahoo_NewsResult</title>
614 Каждый отдельный результат News Search возвращается в виде объекта
615 <code>Zend_Service_Yahoo_NewsResult</code>.
617 Each News Search result is returned as a <code>Zend_Service_Yahoo_NewsResult</code> object.
620 <sect4 id="zend.service.yahoo.classes.newsresult.properties">
621 <title>Свойства класса</title>
623 <title>Свойства класса Zend_Service_Yahoo_NewsResult</title>
629 <entry>Описание</entry>
634 <entry>Summary</entry>
635 <entry>string</entry>
636 <entry>Краткий текст<!--Result summary--></entry>
639 <entry>NewsSource</entry>
640 <entry>string</entry>
641 <entry>Компания, разместившая статью<!--The company who distributed the article--></entry>
644 <entry>NewsSourceUrl</entry>
645 <entry>string</entry>
646 <entry>URL компании, разместившей статью<!--The URL for the company who distributed the article--></entry>
649 <entry>Language</entry>
650 <entry>string</entry>
651 <entry>Язык, на котором написана статья<!--The language the article is in--></entry>
654 <entry>PublishDate</entry>
655 <entry>string</entry>
656 <entry>Дата размещения новости в формате UNIX<!--The date the article was published as a UNIX timestamp--></entry>
659 <entry>ModificationDate</entry>
660 <entry>string</entry>
661 <entry>Дата последнего изменения статьи в формате UNIX<!--The date the article was last modified as a UNIX timestamp--></entry>
664 <entry>Thumbnail</entry>
665 <entry><link linkend="zend.service.yahoo.classes.image">Zend_Service_Yahoo_Image</link></entry>
666 <entry>Уменьшенная копия изображения к статье, если есть<!--Image Thumbnail for the article, if it exists--></entry>
672 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>
676 <sect3 id="zend.service.yahoo.classes.image">
677 <title>Zend_Service_Yahoo_Image</title>
679 Все изображения, возвращаемые Yahoo! Image Search и Yahoo! News Search,
680 представляются как объекты <code>Zend_Service_Yahoo_Image</code>.
682 All images returned either by the Yahoo! Image Search of the Yahoo! News Search
683 are represented by <code>Zend_Service_Yahoo_Image</code> objects
686 <sect4 id="zend.service.yahoo.classes.image.properties">
687 <title>Свойства класса</title>
689 <title>Свойства класса Zend_Service_Yahoo_Image</title>
695 <entry>Описание</entry>
701 <entry>string</entry>
702 <entry>URL изображения<!--Image URL--></entry>
707 <entry>Ширина изображения<!--Image Width--></entry>
710 <entry>Height</entry>
712 <entry>Высота изображения<!--Image Height--></entry>
718 <link linkend="zend.service.yahoo.classes">Назад к списку классов<!--Back to Class List--></link>