29.8. Zend_Service_Yahoo

29.8.1. Wprowadzenie

Zend_Service_Yahoo jest prostym API do użycia z wieloma Yahoo! REST API. Zend_Service_Yahoo pozwala ci na przeszukiwanie sieci za pomocą Yahoo! Web search, Yahoo! News, Yahoo! Local, Yahoo! Images. Aby użyć Yahoo! REST API, musisz posiadać Yahoo! Application ID. Aby otrzymać Application ID, proszę wypełnij i wyślij formularz rejestracji aplikacji.

29.8.2. Przeszukiwanie sieci Web z Yahoo!

Zend_Service_Yahoo pozwala przeszukiwać sieć poprzez Yahoo! używając metody webSearch(), która akceptuje treść zapytania w pierwszym parametrze oraz jako opcjonalny drugi parametr tablicę opcji wyszukiwania. Pełne informacje i listę opcji możesz znaleźć w dokumentacji Yahoo! Web Search. Metoda webSearch() zwraca obiekt Zend_Service_Yahoo_WebResultSet.

Przykład 29.32. Przeszukiwanie sieci Web z 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 />';
}
?>       

29.8.3. Wyszukiwanie obrazków z Yahoo!

Możesz szukać obrazków poprzez Yahoo używając metody imageSearch() klasy Zend_Service_Yahoo. Ta metoda akceptuje treść zapytania w pierwszym parametrze oraz jako opcjonalny drugi parametr tablicę opcji wyszukiwania, tak jak metoda webSearch(). Pełne informacje i listę opcji możesz znaleźć w dokumentacji Yahoo! Image Search.

Przykład 29.33. Wyszukiwanie obrazków z 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 />';
}
?>       

29.8.4. Przeszukiwanie lokalnych firm i usług za pomocą Yahoo!

Możesz szukać lokalnych firm i usług za pomocą Yahoo! używając metody localSearch(). Aby dowiedzięc sę więcej, sprawdź dokumentację Yahoo! Local Search.

Przykład 29.34. Przeszukiwanie lokalnych firm i usług za pomocą 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 />';
}
?>       

29.8.5. Przeszukiwanie Yahoo! News

Przeszukiwanie Yahoo! News jest proste; po prostu użyj metody newsSearch() method, tak jak w poniższym przykładzie. Aby dowiedzięc sę więcej, sprawdź dokumentację Yahoo! News Search.

Przykład 29.35. Przeszukiwanie Yahoo! News

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

29.8.6. Klasy Zend_Service_Yahoo

Poniższe klasy są zwracane przez różne wyszukiwania Yahoo!. Każdy typ wyszukiwania zwraca zestaw wyników o specyficznym typie, który można łatwo iterować poprzez poszczególne obiekty wyników. Wszystkie klasy zestawów wyników implementują interfejs SeekableIterator, pozwalając na łatwą iterację i szukanie specyficznego wyniku.

29.8.6.1. Zend_Service_Yahoo_ResultSet

Każdy ze specyficznych zestawów wyników wyszukiwania rozszerza tę bazową klasę.

Każdy ze specyficznych zestawów wyników wyszukiwania zwraca obiekty wyniku Zend_Service_Yahoo_Result.

29.8.6.1.1. Zend_Service_Yahoo_ResultSet::totalResults()

int totalResults();

Zwraca ilość zwróconych wyników wyszukiwania.

29.8.6.1.2. Właściwości

Tabela 29.15. Zend_Service_Yahoo_ResultSet

Nazwa Typ Opis
totalResultsAvailable int Całkowita ilość znalezionych wyników.
totalResultsReturned int Ilość wyników w obecnym zestawie wyników
firstResultPosition int Pozycja pierwszego wyniku w tym zestawie, relatywna do całkowitej ilości wyników.

Powrót do listy klas

29.8.6.2. Zend_Service_Yahoo_WebResultSet

Zend_Service_Yahoo_WebResultSet reprezentuje zestaw wyników wyszukiwania w Yahoo! Web Search.

[Notatka] Notatka

Zend_Service_Yahoo_WebResultSet rozszerza klasę Zend_Service_Yahoo_ResultSet

Powrót do listy klas

29.8.6.3. Zend_Service_Yahoo_ImageResultSet

Zend_Service_Yahoo_ImageResultSet reprezentuje zestaw wyników wyszukiwania w Yahoo! Image Search.

[Notatka] Notatka

Zend_Service_Yahoo_ImageResultSet rozszerza klasę Zend_Service_Yahoo_ResultSet

Powrót do listy klas

29.8.6.4. Zend_Service_Yahoo_LocalResultSet

Zend_Service_Yahoo_LocalResultSet reprezentuje zestaw wyników wyszukiwania w Yahoo! Local Search.

Tabela 29.16. Właściwości Zend_Service_Yahoo_LocalResultSet

Nazwa Typ Opis
resultSetMapURL string Adres URL strony zawierającej graficzną mapę z wszystkimi zwróconymi wynikami naniesionymi na niej.
[Notatka] Notatka

Zend_Service_Yahoo_LocalResultSet rozszerza klasę Zend_Service_Yahoo_ResultSet

Powrót do listy klas

29.8.6.5. Zend_Service_Yahoo_NewsResultSet

Zend_Service_Yahoo_NewsResultSet reprezentuje zestaw wyników wyszukiwania z Yahoo! News Search.

[Notatka] Notatka

Zend_Service_Yahoo_NewsResultSet rozszerza klasę Zend_Service_Yahoo_ResultSet

Powrót do listy klas

29.8.6.6. Zend_Service_Yahoo_Result

Każdy ze specyficznych wyników jest rozszerzany z tej bazowej klasy.

29.8.6.6.1. Właściwości

Tabela 29.17. Właściwości Zend_Service_Yahoo_Result

Nazwa Typ Opis
Title string Tytuł elementu wyniku
Url string Adres URL elementu wyniku
ClickUrl string Adres URL do linkowania do elementu wyniku.

Powrót do listy klas

29.8.6.7. Zend_Service_Yahoo_WebResult

Każdy wynik wyszukiwania w Web Search jest zwracany jako obiekt Zend_Service_Yahoo_WebResult.

29.8.6.7.1. Właściwości

Tabela 29.18. Właściwości Zend_Service_Yahoo_WebResult

Nazwa Typ Opis
Summary string Podsumowanie wyniku
MimeType string Typ zawartości wyniku
ModificationDate string Czas ostatniej modyfikacji wyniku w formacie UNIX timestamp.
CacheUrl string Adres bufora Yahoo! dla wyniku, jeśli istnieje.
CacheSize int Rozmiar buforu wyniku

Powrót do listy klas

29.8.6.8. Zend_Service_Yahoo_ImageResult

Każdy wynik wyszukiwania w Image Search jest zwracany jako obiekt Zend_Service_Yahoo_ImageResult.

29.8.6.8.1. Właściwości

Tabela 29.19. Właściwości Zend_Service_Yahoo_ImageResult

Nazwa Typ Opis
Summary string Podsumowanie wyniku
RefererUrl string Adres URL strony, która zawiera dany obrazek
FileSize int Rozmiar pliku obrazka w bajtach
FileFormat string Format obrazka (bmp, gif, jpeg, png, itd.)
Height int Wysokość obrazka
Width int Szerokość obrazka
Thumbnail Zend_Service_Yahoo_Image Miniatura obrazka

Powrót do listy klas

29.8.6.9. Zend_Service_Yahoo_LocalResult

Każdy wynik wyszukiwania w Local Search jest zwracany jako obiekt Zend_Service_Yahoo_LocalResult.

29.8.6.9.1. Właściwości

Tabela 29.20. Właściwości Zend_Service_Yahoo_LocalResult

Nazwa Typ Opis
Address string Adres wyniku wyszukiwania
City string Miasto w którym znajduje się wynik wyszukiwania
State string Stan w którym znajduje się wynik wyszukiwania
Phone string Numer telefonu dla wyniku wyszukiwania
Rating int Ocena przesłana przez użytkownika dla wyniku wyszukiwania
Distance float Dystans do wyniku wyszukiwania z twojej określonej lokacji
MapUrl string Adres URL mapy wyników wyszukiwania
BusinessUrl string Adres URL strony firmy, jeśli jest znana
BusinessClickUrl string Adres URL do linkowania do strony firmy, jeśli jest znana

Powrót do listy klas

29.8.6.10. Zend_Service_Yahoo_NewsResult

Każdy wynik wyszukiwania w News Search jest zwracany jako obiekt Zend_Service_Yahoo_NewsResult.

29.8.6.10.1. Właściwości

Tabela 29.21. Właściwości Zend_Service_Yahoo_NewsResult

Nazwa Typ Opis
Summary string Podsumowanie wyniku
NewsSource string Firma, z której pochodzi ten artykuł
NewsSourceUrl string Adres URL firmy z której pochodzi ten artykuł
Language string Język w jakim napisany jest artykuł
PublishDate string Data publikacji artykułu w formacie UNIX timestamp
ModificationDate string Data ostatniej modyfikacji artykułu w formacie UNIX timestamp
Thumbnail Zend_Service_Yahoo_Image Miniatura obrazka dla artykułu, jeśli istnieje

Powrót do listy klas

29.8.6.11. Zend_Service_Yahoo_Image

Wszystkie obrazki zwrocone przez Yahoo! Image Search lub Yahoo! News Search są reprezentowane przez obiekty Zend_Service_Yahoo_Image

29.8.6.11.1. Właściwości

Tabela 29.22. Właściwości Zend_Service_Yahoo_Image

Nazwa Typ Opis
Url string Adres URL obrazka
Width int Szerokość obrazka
Height int Wysokość obrazka

Powrót do listy klas