1 <sect1 id="zend.service.yahoo">
2 <title>Zend_Service_Yahoo</title>
3 <sect2 id="zend.service.yahoo.introduction">
4 <title>Wprowadzenie</title>
6 <code>Zend_Service_Yahoo</code> jest prostym API do użycia z wieloma
7 Yahoo! REST API. <code>Zend_Service_Yahoo</code> pozwala ci na
8 wyszukiwanie w sieci za pomocą Yahoo! Web search, Yahoo! News,
9 Yahoo! Local, Yahoo! Images. Aby użyć Yahoo! REST API, musisz
10 posiadać Yahoo! Application ID. Aby otrzymać Application ID, proszę
11 wypełnij i wyślij <ulink
12 url="http://developer.yahoo.com/wsregapp/">formularz
13 rejestracji aplikacji</ulink>.
16 <sect2 id="zend.service.yahoo.websearch">
17 <title>Wyszukiwanie w sieci Web z Yahoo!</title>
19 <code>Zend_Service_Yahoo</code> pozwala przeszukiwać sieć poprzez Yahoo! używając
20 metody <code>webSearch()</code>, która akceptuje treść zapytania w pierwszym
21 parametrze oraz jako opcjonalny drugi parametr tablicę opcji wyszukiwania.
22 Pełne informacje i listę opcji możesz znaleźć w
23 <ulink url="http://developer.yahoo.com/search/web/V1/webSearch.html">dokumentacji
24 Yahoo! Web Search</ulink>. Metoda <code>webSearch()</code> zwraca obiekt
25 <code>Zend_Service_Yahoo_WebResultSet</code>.
27 <example id="zend.service.yahoo.websearch.example-1">
28 <title>Wyszukiwanie w sieci Web z Yahoo!</title>
29 <programlisting><![CDATA[
30 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
31 $results = $yahoo->webSearch('PHP');
32 foreach ($results as $result) {
33 echo $result->Title .'<br />';
39 <sect2 id="zend.service.yahoo.imagesearch">
40 <title>Wyszukiwanie obrazków z Yahoo!</title>
42 Możesz szukać obrazków poprzez Yahoo używając metody <code>imageSearch()</code>
43 klasy <code>Zend_Service_Yahoo</code>. Ta metoda akceptuje treść zapytania w
44 pierwszym parametrze oraz jako opcjonalny drugi parametr tablicę opcji
45 wyszukiwania, tak jak metoda
46 <link linkend="zend.service.yahoo.websearch"><code>webSearch()</code></link>.
47 Pełne informacje i listę opcji możesz znaleźć w
48 <ulink url="http://developer.yahoo.com/search/image/V1/imageSearch.html">dokumentacji
49 Yahoo! Image Search</ulink>.
51 <example id="zend.service.yahoo.imagesearch.example-1">
52 <title>Wyszukiwanie obrazków z Yahoo!</title>
53 <programlisting><![CDATA[
54 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
55 $results = $yahoo->imageSearch('PHP');
56 foreach ($results as $result) {
57 echo $result->Title .'<br />';
63 <sect2 id="zend.service.yahoo.videosearch">
64 <title>Wyszukiwanie filmów video za pomocą Yahoo!</title>
66 Możesz wyszukiwać filmów video w Yahoo używając metody <code>videoSearch()</code>
67 klasy <code>Zend_Service_Yahoo</code>. Aby uzyskać pełne informacje i listę
69 <ulink url="http://developer.yahoo.com/search/video/V1/videoSearch.html">dokumentację Yahoo! Video Search</ulink>.
71 <example id="zend.service.yahoo.videosearch.example-1">
72 <title>Wyszukiwanie filmów video za pomocą Yahoo!</title>
73 <programlisting><![CDATA[
74 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
75 $results = $yahoo->videoSearch('PHP');
76 foreach ($results as $result) {
77 echo $result->Title .'<br />';
83 <sect2 id="zend.service.yahoo.localsearch">
84 <title>Wyszukiwanie lokalnych firm i usług za pomocą Yahoo!</title>
86 Możesz szukać lokalnych firm i usług za pomocą Yahoo! używając metody <code>localSearch()</code>.
87 Aby dowiedzięc sę więcej, sprawdź
88 <ulink url="http://developer.yahoo.com/search/local/V1/localSearch.html">dokumentację Yahoo! Local Search</ulink>.
90 <example id="zend.service.yahoo.localsearch.example-1">
91 <title>Wyszukiwanie lokalnych firm i usług za pomocą Yahoo!</title>
92 <programlisting><![CDATA[
93 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
94 $results = $yahoo->localSearch('Apple Computers', array('zip' => '95014'));
95 foreach ($results as $result) {
96 echo $result->Title .'<br />';
102 <sect2 id="zend.service.yahoo.newssearch">
103 <title>Wyszukiwanie Yahoo! News</title>
105 Wyszukiwanie Yahoo! News jest proste; po prostu użyj metody <code>newsSearch()</code> method,
106 tak jak w poniższym przykładzie. Aby dowiedzięc sę więcej, sprawdź
107 <ulink url="http://developer.yahoo.com/search/news/V1/newsSearch.html">dokumentację Yahoo! News Search</ulink>.
109 <example id="zend.service.yahoo.newssearch.example-1">
110 <title>Wyszukiwanie Yahoo! News</title>
111 <programlisting><![CDATA[
112 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
113 $results = $yahoo->newsSearch('PHP');
114 foreach ($results as $result) {
115 echo $result->Title .'<br />';
121 <sect2 id="zend.service.yahoo.inlinkdatasearch">
122 <title>Wyszukiwanie Yahoo! Site Explorer Inbound Links</title>
124 Wyszukiwanie w Yahoo! Site Explorer Inbound Links jest proste;
125 użyj po prostu metody <code>inlinkDataSearch()</code>
126 tak jak w poniższym przykładzie. Aby dowiedzięc sę więcej, sprawdź
127 <ulink url="http://developer.yahoo.com/search/siteexplorer/V1/inlinkData.html">dokumentację
128 Yahoo! Site Explorer Inbound Links</ulink>.
130 <example id="zend.service.yahoo.inlinkdatasearch.example-1">
131 <title>Wyszukiwanie Yahoo! Site Explorer Inbound Links</title>
132 <programlisting><![CDATA[
133 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
134 $results = $yahoo->inlinkDataSearch('http://framework.zend.com/');
135 foreach ($results as $result) {
136 echo $result->Title .'<br />';
142 <sect2 id="zend.service.yahoo.pagedatasearch">
143 <title>Wyszukiwanie Yahoo! Site Explorer PageData</title>
145 Wyszukiwanie w Yahoo! Site Explorer's PageData jest proste;
146 użyj po prostu metody <code>pageDataSearch()</code>
147 tak jak w poniższym przykładzie. Aby dowiedzięc sę więcej, sprawdź
148 <ulink url="http://developer.yahoo.com/search/siteexplorer/V1/pageData.html">dokumentację
149 Yahoo! Site Explorer PageData</ulink>.
151 <example id="zend.service.yahoo.pagedatasearch.example-1">
152 <title>Wyszukiwanie Yahoo! Site Explorer PageData</title>
153 <programlisting><![CDATA[
154 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
155 $results = $yahoo->pageDataSearch('http://framework.zend.com/');
156 foreach ($results as $result) {
157 echo $result->Title .'<br />';
163 <sect2 id="zend.service.yahoo.classes">
164 <title>Klasy Zend_Service_Yahoo</title>
166 Poniższe klasy są zwracane przez różne wyszukiwania Yahoo!. Każdy typ
167 wyszukiwania zwraca zestaw wyników o specyficznym typie, który można łatwo
168 iterować poprzez poszczególne obiekty wyników. Wszystkie klasy zestawów
169 wyników implementują interfejs <code>SeekableIterator</code>, pozwalając
170 na łatwą iterację i szukanie specyficznego wyniku.
172 <listitem><para><link linkend="zend.service.yahoo.classes.resultset"><code>Zend_Service_Yahoo_ResultSet</code></link></para></listitem>
173 <listitem><para><link linkend="zend.service.yahoo.classes.webresultset"><code>Zend_Service_Yahoo_WebResultSet</code></link></para></listitem>
174 <listitem><para><link linkend="zend.service.yahoo.classes.imageresultset"><code>Zend_Service_Yahoo_ImageResultSet</code></link></para></listitem>
175 <listitem><para><link linkend="zend.service.yahoo.classes.localresultset"><code>Zend_Service_Yahoo_LocalResultSet</code></link></para></listitem>
176 <listitem><para><link linkend="zend.service.yahoo.classes.newsresultset"><code>Zend_Service_Yahoo_NewsResultSet</code></link></para></listitem>
177 <listitem><para><link linkend="zend.service.yahoo.classes.newsresultset"><code>Zend_Service_Yahoo_NewsResultSet</code></link></para></listitem>
178 <listitem><para><link linkend="zend.service.yahoo.classes.inlinkdataresultset"><code>Zend_Service_Yahoo_InlinkDataResultSet</code></link></para></listitem>
179 <listitem><para><link linkend="zend.service.yahoo.classes.result"><code>Zend_Service_Yahoo_Result</code></link></para></listitem>
180 <listitem><para><link linkend="zend.service.yahoo.classes.webresult"><code>Zend_Service_Yahoo_WebResult</code></link></para></listitem>
181 <listitem><para><link linkend="zend.service.yahoo.classes.imageresult"><code>Zend_Service_Yahoo_ImageResult</code></link></para></listitem>
182 <listitem><para><link linkend="zend.service.yahoo.classes.localresult"><code>Zend_Service_Yahoo_LocalResult</code></link></para></listitem>
183 <listitem><para><link linkend="zend.service.yahoo.classes.newsresult"><code>Zend_Service_Yahoo_NewsResult</code></link></para></listitem>
184 <listitem><para><link linkend="zend.service.yahoo.classes.inlinkdataresult"><code>Zend_Service_Yahoo_InlinkDataResult</code></link></para></listitem>
185 <listitem><para><link linkend="zend.service.yahoo.classes.pagedataresult"><code>Zend_Service_Yahoo_PageDataResult</code></link></para></listitem>
186 <listitem><para><link linkend="zend.service.yahoo.classes.image"><code>Zend_Service_Yahoo_Image</code></link></para></listitem>
189 <sect3 id="zend.service.yahoo.classes.resultset">
190 <title>Zend_Service_Yahoo_ResultSet</title>
192 Każdy ze specyficznych zestawów wyników wyszukiwania rozszerza tę
196 Każdy ze specyficznych zestawów wyników wyszukiwania zwraca
198 <link linkend="zend.service.yahoo.classes.result">Zend_Service_Yahoo_Result</link>.
200 <sect4 id="zend.service.yahoo.classes.resultset.totalResults">
201 <title>Zend_Service_Yahoo_ResultSet::totalResults()</title>
205 <methodname>totalResults</methodname>
210 Zwraca ilość zwróconych wyników wyszukiwania.
213 <sect4 id="zend.service.yahoo.classes.resultset.properties">
214 <title>Właściwości</title>
215 <table id="zend.service.yahoo.classes.resultset.properties.table-1">
216 <title>Zend_Service_Yahoo_ResultSet</title>
227 <entry>totalResultsAvailable</entry>
230 Całkowita ilość znalezionych wyników.
234 <entry>totalResultsReturned</entry>
236 <entry>Ilość wyników w obecnym zestawie wyników</entry>
239 <entry>firstResultPosition</entry>
241 <entry>Pozycja pierwszego wyniku w tym zestawie,
242 relatywna do całkowitej ilości wyników.</entry>
248 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
252 <sect3 id="zend.service.yahoo.classes.webresultset">
253 <title>Zend_Service_Yahoo_WebResultSet</title>
255 <code>Zend_Service_Yahoo_WebResultSet</code> reprezentuje zestaw wyników wyszukiwania w Yahoo! Web Search.
259 <code>Zend_Service_Yahoo_WebResultSet</code> rozszerza klasę <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
263 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
266 <sect3 id="zend.service.yahoo.classes.imageresultset">
267 <title>Zend_Service_Yahoo_ImageResultSet</title>
269 <code>Zend_Service_Yahoo_ImageResultSet</code> reprezentuje zestaw wyników wyszukiwania w Yahoo! Image Search.
273 <code>Zend_Service_Yahoo_ImageResultSet</code> rozszerza klasę <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
277 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
280 <sect3 id="zend.service.yahoo.classes.localresultset">
281 <title>Zend_Service_Yahoo_LocalResultSet</title>
283 <code>Zend_Service_Yahoo_LocalResultSet</code> reprezentuje zestaw wyników wyszukiwania w Yahoo! Local Search.
285 <table id="zend.service.yahoo.classes.localresultset.table-1">
286 <title>Właściwości Zend_Service_Yahoo_LocalResultSet</title>
297 <entry>resultSetMapURL</entry>
298 <entry>string</entry>
299 <entry>Adres URL strony zawierającej graficzną mapę
300 z wszystkimi zwróconymi wynikami naniesionymi na niej.</entry>
307 <code>Zend_Service_Yahoo_LocalResultSet</code> rozszerza klasę <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
311 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
314 <sect3 id="zend.service.yahoo.classes.newsresultset">
315 <title>Zend_Service_Yahoo_NewsResultSet</title>
317 <code>Zend_Service_Yahoo_NewsResultSet</code> reprezentuje zestaw wyników wyszukiwania z Yahoo! News Search.
321 <code>Zend_Service_Yahoo_NewsResultSet</code> rozszerza klasę <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
325 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
328 <sect3 id="zend.service.yahoo.classes.inlinkdataresultset">
329 <title>Zend_Service_Yahoo_InlinkDataResultSet</title>
331 <code>Zend_Service_Yahoo_InlinkDataResultSet</code> representuje zestaw wyników wyszukiwania z Yahoo! Inbound Link Search.
335 <code>Zend_Service_Yahoo_InlinkDataResultSet</code> rozszerza klasę <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
339 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
342 <sect3 id="zend.service.yahoo.classes.pagedataresultset">
343 <title>Zend_Service_Yahoo_PageDataResultSet</title>
345 <code>Zend_Service_Yahoo_PageDataResultSet</code> reprezentuje zestaw wyników wyszukiwania z Yahoo! PageData Search.
349 <code>Zend_Service_Yahoo_PageDataResultSet</code> rozszerza klasę <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link>
353 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
356 <sect3 id="zend.service.yahoo.classes.result">
357 <title>Zend_Service_Yahoo_Result</title>
359 Każdy ze specyficznych wyników jest rozszerzany z tej bazowej klasy.
361 <sect4 id="zend.service.yahoo.classes.result.properties">
362 <title>Właściwości</title>
363 <table id="zend.service.yahoo.classes.result.properties.table-1">
364 <title>Właściwości Zend_Service_Yahoo_Result</title>
376 <entry>string</entry>
377 <entry>Tytuł elementu wyniku</entry>
381 <entry>string</entry>
382 <entry>Adres URL elementu wyniku</entry>
385 <entry>ClickUrl</entry>
386 <entry>string</entry>
387 <entry>Adres URL do linkowania do elementu wyniku.</entry>
393 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
397 <sect3 id="zend.service.yahoo.classes.webresult">
398 <title>Zend_Service_Yahoo_WebResult</title>
400 Każdy wynik wyszukiwania w Web Search jest zwracany jako obiekt <code>Zend_Service_Yahoo_WebResult</code>.
402 <sect4 id="zend.service.yahoo.classes.webresult.properties">
403 <title>Właściwości</title>
404 <table id="zend.service.yahoo.classes.webresult.properties.table-1">
405 <title>Właściwości Zend_Service_Yahoo_WebResult</title>
416 <entry>Summary</entry>
417 <entry>string</entry>
418 <entry>Podsumowanie wyniku</entry>
421 <entry>MimeType</entry>
422 <entry>string</entry>
423 <entry>Typ zawartości wyniku</entry>
426 <entry>ModificationDate</entry>
427 <entry>string</entry>
428 <entry>Czas ostatniej modyfikacji wyniku w formacie UNIX timestamp.</entry>
431 <entry>CacheUrl</entry>
432 <entry>string</entry>
433 <entry>Adres bufora Yahoo! dla wyniku, jeśli istnieje.</entry>
436 <entry>CacheSize</entry>
438 <entry>Rozmiar buforu wyniku</entry>
444 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
448 <sect3 id="zend.service.yahoo.classes.imageresult">
449 <title>Zend_Service_Yahoo_ImageResult</title>
451 Każdy wynik wyszukiwania w Image Search jest zwracany jako obiekt <code>Zend_Service_Yahoo_ImageResult</code>.
453 <sect4 id="zend.service.yahoo.classes.imageresult.properties">
454 <title>Właściwości</title>
455 <table id="zend.service.yahoo.classes.imageresult.properties.table-1">
456 <title>Właściwości Zend_Service_Yahoo_ImageResult</title>
467 <entry>Summary</entry>
468 <entry>string</entry>
469 <entry>Podsumowanie wyniku</entry>
472 <entry>RefererUrl</entry>
473 <entry>string</entry>
474 <entry>Adres URL strony, która zawiera dany obrazek</entry>
477 <entry>FileSize</entry>
479 <entry>Rozmiar pliku obrazka w bajtach</entry>
482 <entry>FileFormat</entry>
483 <entry>string</entry>
484 <entry>Format obrazka (bmp, gif, jpeg, png, itd.)</entry>
487 <entry>Height</entry>
489 <entry>Wysokość obrazka</entry>
494 <entry>Szerokość obrazka</entry>
497 <entry>Thumbnail</entry>
498 <entry><link linkend="zend.service.yahoo.classes.image">Zend_Service_Yahoo_Image</link></entry>
499 <entry>Miniatura obrazka</entry>
505 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
509 <sect3 id="zend.service.yahoo.classes.localresult">
510 <title>Zend_Service_Yahoo_LocalResult</title>
512 Każdy wynik wyszukiwania w Local Search jest zwracany jako obiekt <code>Zend_Service_Yahoo_LocalResult</code>.
514 <sect4 id="zend.service.yahoo.classes.localresult.properties">
515 <title>Właściwości</title>
516 <table id="zend.service.yahoo.classes.localresult.properties.table-1">
517 <title>Właściwości Zend_Service_Yahoo_LocalResult</title>
528 <entry>Address</entry>
529 <entry>string</entry>
530 <entry>Adres wyniku wyszukiwania</entry>
534 <entry>string</entry>
535 <entry>Miasto w którym znajduje się wynik wyszukiwania</entry>
539 <entry>string</entry>
540 <entry>Stan w którym znajduje się wynik wyszukiwania</entry>
544 <entry>string</entry>
545 <entry>Numer telefonu dla wyniku wyszukiwania</entry>
548 <entry>Rating</entry>
550 <entry>Ocena przesłana przez użytkownika dla wyniku wyszukiwania</entry>
553 <entry>Distance</entry>
555 <entry>Dystans do wyniku wyszukiwania z twojej określonej lokacji</entry>
558 <entry>MapUrl</entry>
559 <entry>string</entry>
560 <entry>Adres URL mapy wyników wyszukiwania</entry>
563 <entry>BusinessUrl</entry>
564 <entry>string</entry>
565 <entry>Adres URL strony firmy, jeśli jest znana</entry>
568 <entry>BusinessClickUrl</entry>
569 <entry>string</entry>
570 <entry>Adres URL do linkowania do strony firmy, jeśli jest znana</entry>
576 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
580 <sect3 id="zend.service.yahoo.classes.newsresult">
581 <title>Zend_Service_Yahoo_NewsResult</title>
583 Każdy wynik wyszukiwania w News Search jest zwracany jako obiekt <code>Zend_Service_Yahoo_NewsResult</code>.
585 <sect4 id="zend.service.yahoo.classes.newsresult.properties">
586 <title>Właściwości</title>
587 <table id="zend.service.yahoo.classes.newsresult.properties.table-1">
588 <title>Właściwości Zend_Service_Yahoo_NewsResult</title>
599 <entry>Summary</entry>
600 <entry>string</entry>
601 <entry>Podsumowanie wyniku</entry>
604 <entry>NewsSource</entry>
605 <entry>string</entry>
606 <entry>Firma, z której pochodzi ten artykuł</entry>
609 <entry>NewsSourceUrl</entry>
610 <entry>string</entry>
611 <entry>Adres URL firmy z której pochodzi ten artykuł</entry>
614 <entry>Language</entry>
615 <entry>string</entry>
616 <entry>Język w jakim napisany jest artykuł</entry>
619 <entry>PublishDate</entry>
620 <entry>string</entry>
621 <entry>Data publikacji artykułu w formacie UNIX timestamp</entry>
624 <entry>ModificationDate</entry>
625 <entry>string</entry>
626 <entry>Data ostatniej modyfikacji artykułu w formacie UNIX timestamp</entry>
629 <entry>Thumbnail</entry>
630 <entry><link linkend="zend.service.yahoo.classes.image">Zend_Service_Yahoo_Image</link></entry>
631 <entry>Miniatura obrazka dla artykułu, jeśli istnieje</entry>
637 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>
641 <sect3 id="zend.service.yahoo.classes.image">
642 <title>Zend_Service_Yahoo_Image</title>
644 Wszystkie obrazki zwrocone przez Yahoo! Image Search lub Yahoo! News Search
645 są reprezentowane przez obiekty <code>Zend_Service_Yahoo_Image</code>
647 <sect4 id="zend.service.yahoo.classes.image.properties">
648 <title>Właściwości</title>
649 <table id="zend.service.yahoo.classes.image.properties.table-1">
650 <title>Właściwości Zend_Service_Yahoo_Image</title>
662 <entry>string</entry>
663 <entry>Adres URL obrazka</entry>
668 <entry>Szerokość obrazka</entry>
671 <entry>Height</entry>
673 <entry>Wysokość obrazka</entry>
679 <link linkend="zend.service.yahoo.classes">Powrót do listy klas</link>