24.4. Zend_Service_Flickr
Poprzedni | Rozdział 24. Zend_Service | Następny

## 24.4. Zend_Service_Flickr

### 24.4.1. Wprowadzenie do przeszukiwania Flickr

`Zend_Service_Flickr` jest prostym API do użycia z serwisem Flickr REST Web Service. W celu użycia web serwisów Flickr, musisz posiadać klucz API. Aby zdoby klucz i uzyskać więcej informacji o Flickr REST Web Service, odwiedź dokumentację Flickr API.

W poniższym przykladzie, używamy metody `tagSearch()` do wyszukiwania zdjęć zawierających etykietę "php".

Przykład 24.10. Proste wyszukiwanie zdjęć Flickr

    <?php
    require_once 'Zend/Service/Flickr.php';

    $flickr = new Zend_Service_Flickr('MY_API_KEY');

    $results = $flickr->tagSearch("php");

    foreach ($results as $result) {
        echo $result->title . '<br />';
    }
    ?>

| Opcjonalny parametr
Metoda `tagSearch()` akceptuje tablicę opcji jako opcjonalny drugi parametr.

### 24.4.2. Wyszukiwanie użytkowników Flickr

Klasa `Zend_Service_Flickr` zapewnia trzy różne możliwości pobierania informacji o użytkowniku serwisu Flickr:

- `userSearch()`: akceptuje w parametrze treść zapytania w postaci etykiet oddzielonych spacją oraz tablicę opcji wyszukiwania jako opcjonalny drugi parametr, a zwraca obiekt `Zend_Service_Flickr_ResultSet`.

- `getIdByUsername()`: Zwraca ID użytkownika powiązane z podaną nazwą użytkownika.

- `getIdByEmail()`:Zwraca ID użytkownika powiązane z podanym adresem email.

Przykład 24.11. Wyszukiwanie użytkownika serwisu Flickr na podstawie adresu e-mail

W tym przykładzie, posiadamy adres e-mail użytkownika serwisu Flickr i pobierzemy informacje o użytkowniku używając metody `userSearch()`:

    <?php
    require_once 'Zend/Service/Flickr.php';

    $flickr = new Zend_Service_Flickr('MY_API_KEY');

    $results = $flickr->userSearch($userEmail);

    foreach ($results as $result) {
        echo $result->title . '<br />';
    }
    ?>

### 24.4.3. Pobieranie szczegółów zdjęcia Flickr

`Zend_Service_Flickr` ułatwia pobieranie informacji o zdjęciu na podstawie podanego ID zdjęcia. Po prostu użyj metody `getImageDetails()`, tak jak w poniższym przykładzie:

Przykład 24.12. Pobieranie szczegółów zdjęcia Flickr

Jeśli posiadasz ID zdjęcia Flickr, pobranie informacji o zdjęciu jest bardzo proste:

    <?php
    require_once 'Zend/Service/Flickr.php';

    $flickr = new Zend_Service_Flickr('MY_API_KEY');

    $image = $flickr->getImageDetails($imageId);

    echo "Obrazek o ID $imageId ma rozmiar $image->width x $image->height pikseli.<br />\n";
    echo "<a href=\"$image->clickUri\">Click for Image</a>\n";
    ?>

### 24.4.4. Klasy Zend_Service_Flickr

Poniższe klasy są zwracane przez metody `tagSearch()` oraz `userSearch()`:

- `Zend_Service_Flickr_ResultSet`

- `Zend_Service_Flickr_Result`

- `Zend_Service_Flickr_Image`

#### 24.4.4.1. Zend_Service_Flickr_ResultSet

Reprezentuje zestaw wyników wysuzkiwania Flickr.

| Notatka
Implementuje interfejs `SeekableIterator` dla łatwej iteracji (np., używając `foreach`), tak samo jak i dla bezpośredniego dostępu do specyficznego wyniku używając metody `seek()`.

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

Tabela 24.10. Właściwości Zend_Service_Flickr_ResultSet

Nazwa | Typ | Opis
--- | --- | ---
totalResultsAvailable | int | Całkowita ilość dostępnych wyników wyszukiwania
totalResultsReturned | int | Całkowita ilość zwróconych wyników wyszukiwania
firstResultPosition | int | Pozycja obecnego zestawu wyników we wszystkich wynikach

##### 24.4.4.1.2. Zend_Service_Flickr_ResultSet::totalResults()

`int totalResults();`

Zwraca całkowitą ilość wyników w tym zestawie wyników wyszukiwania.

Powrót do listy klas

#### 24.4.4.2. Zend_Service_Flickr_Result

Pojedynczy wynik wyszukiwania zdjęcia w serwisie Flickr

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

Tabela 24.11. Właściwości Zend_Service_Flickr_Result

Nazwa | Typ | Opis
--- | --- | ---
id | int | ID zdjęcia
owner | int | Identyfikator NSID właściciela zdjęcia.
secret | string | Klucz używany w konstrukcji URL.
server | string | Nazwa serwera używana w konstrukcji URL.
title | string | Tytuł zdjęcia.
ispublic | boolean | Czy zdjęcie jest publiczne.
isfriend | boolean | Czy zdjęcie jest dla Ciebie widoczne ponieważ jesteś przyjacielem właściciela.
isfamily | boolean | Czy zdjęcie jest dla Ciebie widoczne ponieważ jesteś rodziną właściciela.
license | string | Licencja pod jaką dostępne jest zdjęcie.
date_upload | string | Data wgrania zdjęcia.
date_taken | string | Data zrobienia zdjęcia.
owner_name | string | Wyświetlana nazwa użytkownika.
icon_server | string | Serwer używany przy dołączaniu adresów URL ikon.
Square | Zend_Service_Flickr_Image | Miniaturka zdjęcia o wielkości 75x75.
Thumbnail | Zend_Service_Flickr_Image | Miniaturka zdjęcia o wielkości 100 pikseli.
Small | Zend_Service_Flickr_Image | Wersja zdjęcia o wielkości 240 pikseli.
Medium | Zend_Service_Flickr_Image | Wersja zdjęcia o wielkości 500 pikseli.
Large | Zend_Service_Flickr_Image | Wersja zdjęcia o wielkości 640 pikseli.
Original | Zend_Service_Flickr_Image | Oryginalne zdjęcie.

Powrót do listy klas

#### 24.4.4.3. Zend_Service_Flickr_Image

Reprezentuje zdjęcie zwrócone przez wyszukiwanie Flickr.

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

Tabela 24.12. Właściwości Zend_Service_Flickr_Image

Nazwa | Typ | Opis
--- | --- | ---
uri | string | Adres URI oryginalnego zdjęcia
clickUri | string | Klikalny adres URI (np. strony Flickr) dla zdjęcia
width | int | Szerokość zdjęcia
height | int | Wysokość zdjęcia

Powrót do listy klas

Poprzedni | Początek rozdziału | Następny
24.3. Zend_Service_Amazon | Spis treści | 24.5. Zend_Service_Yahoo