| blob | a3f7be336643748e9c8118a5e97dfdf2e01e47a8 |
1 <sect1 id="zend.service.yahoo">
2 <title>Zend_Service_Yahoo</title>
3 <sect2 id="zend.service.yahoo.introduction">
4 <title>Inleiding</title>
5 <para>
6 <code>Zend_Service_Yahoo</code> is een eenvoudige API om veel van de Yahoo! REST APIs te gebruiken.
7 <code>Zend_Service_Yahoo</code> laat je toe om Yahoo! Web search, Yahoo! News, Yahoo! Local en Yahoo!
8 Images te doorzoeken. Om de Yahoo! REST API te gebruiken, moet je een Yahoo! Application ID hebben. Om die te verkrijgen
9 kan je volgende formulier invullen en opsturen:
10 <ulink url="http://api.search.yahoo.com/webservices/register_application">Application ID Request Form</ulink>.
11 </para>
12 </sect2>
13 <sect2 id="zend.service.yahoo.websearch">
14 <title>Het web doorzoeken met Yahoo!</title>
15 <para>
16 <code>Zend_Service_Yahoo</code> laat je toe het web te doorzoeken met Yahoo! door de
17 <code>webSearch()</code> methode te gebruiken die een string query parameter aanvaardt, plus een
18 optionele tweede parameter als een array van zoekopties. Voor volledige details en een lijst van opties
19 verwijzen we je graag door naar de
20 <ulink url="http://developer.yahoo.net/search/web/V1/webSearch.html">Yahoo! Web Search
21 Documentatie</ulink>. De <code>webSearch()</code> methode geeft een
22 <code>Zend_Service_Yahoo_WebResultSet</code> object terug.
23 </para>
24 <example>
25 <title>Het web doorzoeken met Yahoo!</title>
26 <programlisting><![CDATA[<?php
27 require_once 'Zend/Service/Yahoo.php';
28 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
29 $results = $yahoo->webSearch('PHP');
30 foreach ($results as $result) {
31 echo $result->Title .'<br />';
32 }
33 ?>]]> </programlisting>
34 </example>
35 </sect2>
36 <sect2 id="zend.service.yahoo.imagesearch">
37 <title>Beelden vinden met Yahoo!</title>
38 <para>
39 Je kan beelden zoeken met Yahoo! door <code>Zend_Service_Yahoo</code>'s <code>imageSearch()</code>
40 methode te gebruiken. Deze methode aanvaardt een string query parameter en een optionele array van
41 zoekopties zoals voor de
42 <link linkend="zend.service.yahoo.websearch"><code>webSearch()</code> methode</link>. Voor alle details
43 en een lijst van opties kan je terecht op de
44 <ulink url="http://developer.yahoo.net/search/image/V1/imageSearch.html">Yahoo! Beeldzoeken
45 Documentatie</ulink>.
46 </para>
47 <example>
48 <title>Beelden vinden met 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->imageSearch('PHP');
53 foreach ($results as $result) {
54 echo $result->Title .'<br />';
55 }
56 ?>]]> </programlisting>
57 </example>
58 </sect2>
59 <sect2 id="zend.service.yahoo.localsearch">
60 <title>Plaatselijke bedrijven en diensten vinden met Yahoo!</title>
61 <para>
62 Je kan plaatselijke bedrijven en diensten opzoeken met Yahoo! door de <code>localSearch()</code> methode te
63 gebruiken. Voor alle details kan je terecht op de
64 <ulink url="http://developer.yahoo.net/search/local/V1/localSearch.html">Yahoo! Plaatselijk zoeken
65 Documentatie</ulink>.
66 </para>
67 <example>
68 <title>Plaatselijke bedrijven en diensten vinden met Yahoo!</title>
69 <programlisting><![CDATA[<?php
70 require_once 'Zend/Service/Yahoo.php';
71 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
72 $results = $yahoo->localSearch('Apple Computers', array('zip' => '95014'));
73 foreach ($results as $result) {
74 echo $result->Title .'<br />';
75 }
76 ?>]]> </programlisting>
77 </example>
78 </sect2>
79 <sect2 id="zend.service.yahoo.newssearch">
80 <title>Yahoo! News zoeken</title>
81 <para>
82 Yahoo! News zoeken is eenvoudig; gebruik eenvoudigweg de <code>newsSearch()</code> methode zoals in het
83 volgende voorbeeld. Voor alle details verwijzen we je door naar de
84 <ulink url="http://developer.yahoo.net/search/news/V1/newsSearch.html">Yahoo! News zoeken
85 Documentatie</ulink>.
86 </para>
87 <example>
88 <title>Yahoo! News zoeken</title>
89 <programlisting><![CDATA[<?php
90 require_once 'Zend/Service/Yahoo.php';
91 $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
92 $results = $yahoo->newsSearch('PHP');
93 foreach ($results as $result) {
94 echo $result->Title .'<br />';
95 }
96 ?>]]> </programlisting>
97 </example>
98 </sect2>
99 <sect2 id="zend.service.yahoo.classes">
100 <title>Zend_Service_Yahoo Klassen</title>
101 <para>
102 De volgende klassen worden allemaal teruggestuurd door de verschillende Yahoo! zoekopdrachten. Elk zoektype
103 stuurt een set resultaten terug die specifiek zijn aan het zoektype. Deze kunnen gemakkelijk worden
104 doorlopen omdat elk resultaat in een resultaattype object zit. Alle klassen voor resultaatsets
105 implementeren de <code>SeekableIterator</code> interface die ervoor zorgt dat je gemakkelijk door een
106 set resultaten kan lopen en een specifiek resultaat erin kan zoeken.
107 <itemizedlist>
108 <listitem><para><link linkend="zend.service.yahoo.classes.resultset"><code>Zend_Service_Yahoo_ResultSet</code></link></para></listitem>
109 <listitem><para><link linkend="zend.service.yahoo.classes.webresultset"><code>Zend_Service_Yahoo_WebResultSet</code></link></para></listitem>
110 <listitem><para><link linkend="zend.service.yahoo.classes.imageresultset"><code>Zend_Service_Yahoo_ImageResultSet</code></link></para></listitem>
111 <listitem><para><link linkend="zend.service.yahoo.classes.localresultset"><code>Zend_Service_Yahoo_LocalResultSet</code></link></para></listitem>
112 <listitem><para><link linkend="zend.service.yahoo.classes.newsresultset"><code>Zend_Service_Yahoo_NewsResultSet</code></link></para></listitem>
113 <listitem><para><link linkend="zend.service.yahoo.classes.result"><code>Zend_Service_Yahoo_Result</code></link></para></listitem>
114 <listitem><para><link linkend="zend.service.yahoo.classes.webresult"><code>Zend_Service_Yahoo_WebResult</code></link></para></listitem>
115 <listitem><para><link linkend="zend.service.yahoo.classes.imageresult"><code>Zend_Service_Yahoo_ImageResult</code></link></para></listitem>
116 <listitem><para><link linkend="zend.service.yahoo.classes.localresult"><code>Zend_Service_Yahoo_LocalResult</code></link></para></listitem>
117 <listitem><para><link linkend="zend.service.yahoo.classes.newsresult"><code>Zend_Service_Yahoo_NewsResult</code></link></para></listitem>
118 <listitem><para><link linkend="zend.service.yahoo.classes.image"><code>Zend_Service_Yahoo_Image</code></link></para></listitem>
119 </itemizedlist>
120 </para>
121 <sect3 id="zend.service.yahoo.classes.resultset">
122 <title>Zend_Service_Yahoo_ResultSet</title>
123 <para>
124 Elk van de aan de zoekopdracht specifieke resultaten is uitgebreid vanaf deze basisklasse.
125 </para>
126 <para>
127 Elk van de specifieke set resultaten geeft een specifiek
128 <link linkend="zend.service.yahoo.classes.result">Zend_Service_Yahoo_Result</link> object terug.
129 </para>
130 <sect4 id="zend.service.yahoo.classes.resultset.totalResults">
131 <title>Zend_Service_Yahoo_ResultSet::totalResults()</title>
132 <para>
133 <methodsynopsis>
134 <type>int</type>
135 <methodname>totalResults</methodname>
136 <void />
137 </methodsynopsis>
138 </para>
139 <para>
140 Geeft het aantal resultaten terug die de zoekopdracht terug stuurde.
141 </para>
142 </sect4>
143 <sect4 id="zend.service.yahoo.classes.resultset.properties">
144 <title>Eigenschappen</title>
145 <table>
146 <title>Zend_Service_Yahoo_ResultSet</title>
147 <tgroup cols="3">
148 <thead>
149 <row>
150 <entry>Naam</entry>
151 <entry>Type</entry>
152 <entry>Beschrijving</entry>
153 </row>
154 </thead>
155 <tbody>
156 <row>
157 <entry>totalResultsAvailable</entry>
158 <entry>int</entry>
159 <entry>
160 Totaal aantal gevonden resultaten.
161 </entry>
162 </row>
163 <row>
164 <entry>totalResultsReturned</entry>
165 <entry>int</entry>
166 <entry>Aantal resultaten in de huidige set resultaten</entry>
167 </row>
168 <row>
169 <entry>firstResultPosition</entry>
170 <entry>int</entry>
171 <entry>Positie van het eerste resultaat in deze set, relatief aan het totaal aantal resultaten.</entry>
172 </row>
173 </tbody>
174 </tgroup>
175 </table>
176 <para>
177 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
178 </para>
179 </sect4>
180 </sect3>
181 <sect3 id="zend.service.yahoo.classes.webresultset">
182 <title>Zend_Service_Yahoo_WebResultSet</title>
183 <para>
184 <code>Zend_Service_Yahoo_WebResultSet</code> vertegenwoordigt een Yahoo! Web Search set resultaatsets.
185 </para>
186 <note>
187 <para>
188 <code>Zend_Service_Yahoo_WebResultSet</code> breidt <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link> uit.
189 </para>
190 </note>
191 <para>
192 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
193 </para>
194 </sect3>
195 <sect3 id="zend.service.yahoo.classes.imageresultset">
196 <title>Zend_Service_Yahoo_ImageResultSet</title>
197 <para>
198 <code>Zend_Service_Yahoo_ImageResultSet</code> vertegenwoordigt een Yahoo! Image Search set resultaatsets.
199 </para>
200 <note>
201 <para>
202 <code>Zend_Service_Yahoo_ImageResultSet</code> breidt <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link> uit.
203 </para>
204 </note>
205 <para>
206 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
207 </para>
208 </sect3>
209 <sect3 id="zend.service.yahoo.classes.localresultset">
210 <title>Zend_Service_Yahoo_LocalResultSet</title>
211 <para>
212 <code>Zend_Service_Yahoo_LocalResultSet</code> vertegenwoordigt een Yahoo! Local Search set resultaatsets.
213 </para>
214 <table>
215 <title>Zend_Service_Yahoo_LocalResultSet Eigenschappen</title>
216 <tgroup cols="3">
217 <thead>
218 <row>
219 <entry>Naam</entry>
220 <entry>Type</entry>
221 <entry>Beschrijving</entry>
222 </row>
223 </thead>
224 <tbody>
225 <row>
226 <entry>resultSetMapURL</entry>
227 <entry>string</entry>
228 <entry>De URL van een webpagina die een grafische kaart bevat met alle teruggestuurde resultaten erop
229 afgebeeld.</entry>
230 </row>
231 </tbody>
232 </tgroup>
233 </table>
234 <note>
235 <para>
236 <code>Zend_Service_Yahoo_LocalResultSet</code> breidt <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link> uit.
237 </para>
238 </note>
239 <para>
240 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
241 </para>
242 </sect3>
243 <sect3 id="zend.service.yahoo.classes.newsresultset">
244 <title>Zend_Service_Yahoo_NewsResultSet</title>
245 <para>
246 <code>Zend_Service_Yahoo_NewsResultSet</code> vertegenwoordigt een Yahoo! News Search set resultaatsets.
247 </para>
248 <note>
249 <para>
250 <code>Zend_Service_Yahoo_NewsResultSet</code> breidt <link linkend="zend.service.yahoo.classes.resultset">Zend_Service_Yahoo_ResultSet</link> uit.
251 </para>
252 </note>
253 <para>
254 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
255 </para>
256 </sect3>
257 <sect3 id="zend.service.yahoo.classes.result">
258 <title>Zend_Service_Yahoo_Result</title>
259 <para>
260 Elk van de aan de zoekopdracht specifieke resultaten is uitgebreid van deze basis klasse.
261 </para>
262 <sect4 id="zend.service.yahoo.classes.result.properties">
263 <title>Eigenschappen</title>
264 <table>
265 <title>Zend_Service_Yahoo_Result Eigenschappen</title>
266 <tgroup cols="3">
267 <thead>
268 <row>
269 <entry>Naam</entry>
270 <entry>Type</entry>
271 <entry>Beschrijving</entry>
272 </row>
273 </thead>
274 <tbody>
275 <row>
276 <entry>Title</entry>
277 <entry>string</entry>
278 <entry>Titel van het resultaat item</entry>
279 </row>
280 <row>
281 <entry>Url</entry>
282 <entry>string</entry>
283 <entry>URL van het resultaat item</entry>
284 </row>
285 <row>
286 <entry>ClickUrl</entry>
287 <entry>string</entry>
288 <entry>URL om naar het resultaat item te linken</entry>
289 </row>
290 </tbody>
291 </tgroup>
292 </table>
293 <para>
294 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
295 </para>
296 </sect4>
297 </sect3>
298 <sect3 id="zend.service.yahoo.classes.webresult">
299 <title>Zend_Service_Yahoo_WebResult</title>
300 <para>
301 Elk Web Search resultaat wordt teruggestuurd als een <code>Zend_Service_Yahoo_WebResult</code> object.
302 </para>
303 <sect4 id="zend.service.yahoo.classes.webresult.properties">
304 <title>Eigenschappen</title>
305 <table>
306 <title>Zend_Service_Yahoo_WebResult Eigenschappen</title>
307 <tgroup cols="3">
308 <thead>
309 <row>
310 <entry>Naam</entry>
311 <entry>Type</entry>
312 <entry>Beschrijving</entry>
313 </row>
314 </thead>
315 <tbody>
316 <row>
317 <entry>Summary</entry>
318 <entry>string</entry>
319 <entry>Samenvatting van het resultaat</entry>
320 </row>
321 <row>
322 <entry>MimeType</entry>
323 <entry>string</entry>
324 <entry>Mimetype van het resultaat</entry>
325 </row>
326 <row>
327 <entry>ModificationDate</entry>
328 <entry>string</entry>
329 <entry>Datum van de laatste wijziging van het resultaat als een UNIX timestamp.</entry>
330 </row>
331 <row>
332 <entry>CacheUrl</entry>
333 <entry>string</entry>
334 <entry>Yahoo! web cache URL voor het resultaat indien die bestaat.</entry>
335 </row>
336 <row>
337 <entry>CacheSize</entry>
338 <entry>int</entry>
339 <entry>De grootte van het item in de Cache</entry>
340 </row>
341 </tbody>
342 </tgroup>
343 </table>
344 <para>
345 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
346 </para>
347 </sect4>
348 </sect3>
349 <sect3 id="zend.service.yahoo.classes.imageresult">
350 <title>Zend_Service_Yahoo_ImageResult</title>
351 <para>
352 Elk Image Search resultaat wordt teruggestuurd als een <code>Zend_Service_Yahoo_ImageResult</code> object.
353 </para>
354 <sect4 id="zend.service.yahoo.classes.imageresult.properties">
355 <title>Eigenschappen</title>
356 <table>
357 <title>Zend_Service_Yahoo_ImageResult Eigenschappen</title>
358 <tgroup cols="3">
359 <thead>
360 <row>
361 <entry>Naam</entry>
362 <entry>Type</entry>
363 <entry>Beschrijving</entry>
364 </row>
365 </thead>
366 <tbody>
367 <row>
368 <entry>Summary</entry>
369 <entry>string</entry>
370 <entry>Samenvatting van het resultaat</entry>
371 </row>
372 <row>
373 <entry>RefererUrl</entry>
374 <entry>string</entry>
375 <entry>De URL van de pagina die het beeld bevat</entry>
376 </row>
377 <row>
378 <entry>FileSize</entry>
379 <entry>int</entry>
380 <entry>De grootte van het bestand in bytes</entry>
381 </row>
382 <row>
383 <entry>FileFormat</entry>
384 <entry>string</entry>
385 <entry>Het beeldformaat (bmp, gif, jpeg, png, enz...)</entry>
386 </row>
387 <row>
388 <entry>Height</entry>
389 <entry>int</entry>
390 <entry>De hoogte van het beeld</entry>
391 </row>
392 <row>
393 <entry>Width</entry>
394 <entry>int</entry>
395 <entry>De breedte van het beeld</entry>
396 </row>
397 <row>
398 <entry>Thumbnail</entry>
399 <entry><link linkend="zend.service.yahoo.classes.image">Zend_Service_Yahoo_Image</link></entry>
400 <entry>Beeld thumbnail</entry>
401 </row>
402 </tbody>
403 </tgroup>
404 </table>
405 <para>
406 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
407 </para>
408 </sect4>
409 </sect3>
410 <sect3 id="zend.service.yahoo.classes.localresult">
411 <title>Zend_Service_Yahoo_LocalResult</title>
412 <para>
413 Elk Local Search resultaat wordt teruggestuurd als een <code>Zend_Service_Yahoo_LocalResult</code> object.
414 </para>
415 <sect4 id="zend.service.yahoo.classes.localresult.properties">
416 <title>Eigenschappen</title>
417 <table>
418 <title>Zend_Service_Yahoo_LocalResult Eigenschappen</title>
419 <tgroup cols="3">
420 <thead>
421 <row>
422 <entry>Naam</entry>
423 <entry>Type</entry>
424 <entry>Beschrijving</entry>
425 </row>
426 </thead>
427 <tbody>
428 <row>
429 <entry>Address</entry>
430 <entry>string</entry>
431 <entry>Straat adres van het resultaat</entry>
432 </row>
433 <row>
434 <entry>City</entry>
435 <entry>string</entry>
436 <entry>Stad waar het resultaat woont</entry>
437 </row>
438 <row>
439 <entry>State</entry>
440 <entry>string</entry>
441 <entry>Staat waarin het resultaat woont</entry>
442 </row>
443 <row>
444 <entry>Phone</entry>
445 <entry>string</entry>
446 <entry>Telefoonnummer van het resultaat</entry>
447 </row>
448 <row>
449 <entry>Rating</entry>
450 <entry>int</entry>
451 <entry>Door gebruikers gegeven classificatie voor het resultaat</entry>
452 </row>
453 <row>
454 <entry>Distance</entry>
455 <entry>float</entry>
456 <entry>De afstand tot het resultaat vanaf de door jou opgegeven plaats</entry>
457 </row>
458 <row>
459 <entry>MapUrl</entry>
460 <entry>string</entry>
461 <entry>URL van een kaart voor het resultaat</entry>
462 </row>
463 <row>
464 <entry>BusinessUrl</entry>
465 <entry>string</entry>
466 <entry>URL voor de bedrijfswebsite, indien bekend</entry>
467 </row>
468 <row>
469 <entry>BusinessClickUrl</entry>
470 <entry>string</entry>
471 <entry>URL om naar de bedrijfswebsite te linken, indien bekend</entry>
472 </row>
473 </tbody>
474 </tgroup>
475 </table>
476 <para>
477 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
478 </para>
479 </sect4>
480 </sect3>
481 <sect3 id="zend.service.yahoo.classes.newsresult">
482 <title>Zend_Service_Yahoo_NewsResult</title>
483 <para>
484 Elk News Search resultaat wordt teruggestuurd als een <code>Zend_Service_Yahoo_NewsResult</code> object.
485 </para>
486 <sect4 id="zend.service.yahoo.classes.newsresult.properties">
487 <title>Eigenschappen</title>
488 <table>
489 <title>Zend_Service_Yahoo_NewsResult Eigenschappen</title>
490 <tgroup cols="3">
491 <thead>
492 <row>
493 <entry>Naam</entry>
494 <entry>Type</entry>
495 <entry>Beschrijving</entry>
496 </row>
497 </thead>
498 <tbody>
499 <row>
500 <entry>Summary</entry>
501 <entry>string</entry>
502 <entry>Samenvatting van het resultaat</entry>
503 </row>
504 <row>
505 <entry>NewsSource</entry>
506 <entry>string</entry>
507 <entry>Het bedrijf dat het artikel publiceerde</entry>
508 </row>
509 <row>
510 <entry>NewsSourceUrl</entry>
511 <entry>string</entry>
512 <entry>De URL van het bedrijf dat het artikel publiceerde</entry>
513 </row>
514 <row>
515 <entry>Language</entry>
516 <entry>string</entry>
517 <entry>De taal waarin het artikel is geschreven</entry>
518 </row>
519 <row>
520 <entry>PublishDate</entry>
521 <entry>string</entry>
522 <entry>De publicatiedatum van het artikel als een UNIX timestamp</entry>
523 </row>
524 <row>
525 <entry>ModificationDate</entry>
526 <entry>string</entry>
527 <entry>De datum waarop het artikel het laatst werd gewijzigd als een UNIX timestamp</entry>
528 </row>
529 <row>
530 <entry>Thumbnail</entry>
531 <entry><link linkend="zend.service.yahoo.classes.image">Zend_Service_Yahoo_Image</link></entry>
532 <entry>Beeld Thumbnail voor het artikel indien het bestaat</entry>
533 </row>
534 </tbody>
535 </tgroup>
536 </table>
537 <para>
538 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
539 </para>
540 </sect4>
541 </sect3>
542 <sect3 id="zend.service.yahoo.classes.image">
543 <title>Zend_Service_Yahoo_Image</title>
544 <para>
545 Alle beelden die door de Yahoo! Image Search of de Yahoo! News Search worden teruggestuurd
546 worden voorgesteld als <code>Zend_Service_Yahoo_Image</code> objecten
547 </para>
548 <sect4 id="zend.service.yahoo.classes.image.properties">
549 <title>Eigenschappen</title>
550 <table>
551 <title>Zend_Service_Yahoo_Image Eigenschappen</title>
552 <tgroup cols="3">
553 <thead>
554 <row>
555 <entry>Naam</entry>
556 <entry>Type</entry>
557 <entry>Beschrijving</entry>
558 </row>
559 </thead>
560 <tbody>
561 <row>
562 <entry>Url</entry>
563 <entry>string</entry>
564 <entry>Beeld URL</entry>
565 </row>
566 <row>
567 <entry>Width</entry>
568 <entry>int</entry>
569 <entry>Beeld wijdte</entry>
570 </row>
571 <row>
572 <entry>Height</entry>
573 <entry>int</entry>
574 <entry>Beeld hoogte</entry>
575 </row>
576 </tbody>
577 </tgroup>
578 </table>
579 <para>
580 <link linkend="zend.service.yahoo.classes">Terug naar de klasselijst</link>
581 </para>
582 </sect4>
583 </sect3>
584 </sect2>
585 </sect1>
586 <!--
587 vim:se ts=4 sw=4 et:
588 -->