24.5. Zend_Service_Yahoo
Poprzedni | Rozdział 24. Zend_Service | Następny

## 24.5. Zend_Service_Yahoo

### 24.5.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.

### 24.5.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 24.13. 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 />';
    }
    ?>

### 24.5.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 24.14. 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 />';
    }
    ?>

### 24.5.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 24.15. 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 />';
    }
    ?>

### 24.5.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 24.16. 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 />';
    }
    ?>

### 24.5.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.

- `Zend_Service_Yahoo_ResultSet`

- `Zend_Service_Yahoo_WebResultSet`

- `Zend_Service_Yahoo_ImageResultSet`

- `Zend_Service_Yahoo_LocalResultSet`

- `Zend_Service_Yahoo_NewsResultSet`

- `Zend_Service_Yahoo_Result`

- `Zend_Service_Yahoo_WebResult`

- `Zend_Service_Yahoo_ImageResult`

- `Zend_Service_Yahoo_LocalResult`

- `Zend_Service_Yahoo_NewsResult`

- `Zend_Service_Yahoo_Image`

#### 24.5.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.

##### 24.5.6.1.1. Zend_Service_Yahoo_ResultSet::totalResults()

`int totalResults();`

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

##### 24.5.6.1.2. Właściwości

Tabela 24.13. 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

#### 24.5.6.2. Zend_Service_Yahoo_WebResultSet

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

| Notatka
`Zend_Service_Yahoo_WebResultSet` rozszerza klasę Zend_Service_Yahoo_ResultSet

Powrót do listy klas

#### 24.5.6.3. Zend_Service_Yahoo_ImageResultSet

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

| Notatka
`Zend_Service_Yahoo_ImageResultSet` rozszerza klasę Zend_Service_Yahoo_ResultSet

Powrót do listy klas

#### 24.5.6.4. Zend_Service_Yahoo_LocalResultSet

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

Tabela 24.14. 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
`Zend_Service_Yahoo_LocalResultSet` rozszerza klasę Zend_Service_Yahoo_ResultSet

Powrót do listy klas

#### 24.5.6.5. Zend_Service_Yahoo_NewsResultSet

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

| Notatka
`Zend_Service_Yahoo_NewsResultSet` rozszerza klasę Zend_Service_Yahoo_ResultSet

Powrót do listy klas

#### 24.5.6.6. Zend_Service_Yahoo_Result

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

##### 24.5.6.6.1. Właściwości

Tabela 24.15. 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

#### 24.5.6.7. Zend_Service_Yahoo_WebResult

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

##### 24.5.6.7.1. Właściwości

Tabela 24.16. 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

#### 24.5.6.8. Zend_Service_Yahoo_ImageResult

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

##### 24.5.6.8.1. Właściwości

Tabela 24.17. 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

#### 24.5.6.9. Zend_Service_Yahoo_LocalResult

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

##### 24.5.6.9.1. Właściwości

Tabela 24.18. 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

#### 24.5.6.10. Zend_Service_Yahoo_NewsResult

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

##### 24.5.6.10.1. Właściwości

Tabela 24.19. 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

#### 24.5.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`

##### 24.5.6.11.1. Właściwości

Tabela 24.20. 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

Poprzedni | Początek rozdziału | Następny
24.4. Zend_Service_Flickr | Spis treści | Rozdział 25. Zend_Session