Zend_Service_Flickr Introdução às Pesquisas Flickr Zend_Service_Flickr é uma simples API para usar o Flickr REST Web Service. Para poder usar os Flickr web services, você deve possuir uma API key. Para obter uma chave e maiores informações sobre o Flickr REST Web Service, visite a Flickr API Documentation. No exemplo seguinte, nós usamos o método tagSearch() para pesquisar por fotos que tenham o valor "php" nas tags. Simples pesquisa por fotos 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 />'; } ?> tagSearch() aceita um array de opções como segundo parâmetro opcional. Localizando Usuários Flickr Zend_Service_Flickr fornece três caminhos variados para obter informações sobre usuários Flickr: userSearch() : Aceita uma string de busca com tags delimitadas por espaços e um array de opções como segundo parâmetro opcional, retornando um objeto Zend_Service_Flickr_ResultSet. getIdByUsername() : Retorna um user ID associado ao nome de usuário informado. getIdByEmail() : Retorna um user ID associado ao endereço de email informado. Localizando um usuário Flickr pelo endereço de E-Mail Neste exemplo, nós temos um endereço de email de um usuário do Flickr, e usamos o método userSearch() para recuperar informações do usuário: <?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 />'; } ?> Recuperando Detalhes de Imagens Flickr Image Details Zend_Service_Flickr torna fácil e rápida a recuperação de detalhes de imagens baseada em um dado "image ID". Basta usar o método getImageDetails() , como mostrado no exemplo seguinte: Recuperando Flickr Image Details Desde que você conheça o Flickr image ID, recuperar informações sobre a imagem é tarefa simples: <?php require_once 'Zend/Service/Flickr.php'; $flickr = new Zend_Service_Flickr('MY_API_KEY'); $image = $flickr->getImageDetails($imageId); echo "Image ID $imageId is $image->width x $image->height pixels.<br />\n"; echo "<a href=\"$image->clickUri\">Click for Image</a>\n"; ?> Classes Zend_Service_Flickr As seguintes classes são todas retornadas por tagSearch() e userSearch(): Zend_Service_Flickr_ResultSet Zend_Service_Flickr_Result Zend_Service_Flickr_Image Zend_Service_Flickr_ResultSet Representa um conjunto de resultados de uma pesquisa Flickr. Implemente o SeekableIterator para facilitar a iteração (ex: usando foreach ), como também o acesso direto a um resultado específico usando seek() . Propriedades Propriedades de Zend_Service_Flickr_ResultSet Nome Tipo Descrição totalResultsAvailable int Total de resultados disponível totalResultsReturned int Total de resultados retornados firstResultPosition int O deslocamento deste subconjunto de resultados no conjunto de resultados total
Zend_Service_Flickr_ResultSet::totalResults() int totalResults Retorna o total de resultados deste conjunto de resultados. Retornar para a Lista de Classes
Zend_Service_Flickr_Result Um simples imagem resultante de uma busca Flickr Propriedades Propriedades de Zend_Service_Flickr_Result Nome Tipo Descrição id int ID da imagem owner int NSID do proprietário da imagem. secret string Uma chave usada na construção da URL. server string O nome do servidor usado na construção da URL. title string O título da foto. ispublic boolean A foto é pública. isfriend boolean A foto é visível para você porque você é amigo do proprietário. isfamily boolean A foto é visível para você porque você é parente do proprietário. license string Licença sob qual a foto foi publicada. date_upload string Data em que a foto foi enviada. date_taken string Data em que a foto foi produzida. owner_name string O nome de tela do proprietário. icon_server string O servidor usado na montagem das URLs dos ícones. Square Zend_Service_Flickr_Image Um slide de 75x75 da imagem. Thumbnail Zend_Service_Flickr_Image Um slide de 100 pixels da imagem. Small Zend_Service_Flickr_Image Um slide de 240 pixels da imagem. Medium Zend_Service_Flickr_Image Um slide de 500 pixels da imagem. Large Zend_Service_Flickr_Image Um slide de 640 pixels da imagem. Original Zend_Service_Flickr_Image A imagem original.
Retornar para a Lista de Classes
Zend_Service_Flickr_Image Representa uma imagem retornada por uma busca Flickr. Propriedades Propriedades de Zend_Service_Flickr_Image Nome Tipo Descrição uri string URI para a imagem original clickUri string URI clicável (ex. a página Flickr) para a imagem width int Largura da imagem height int Altura da imagem
Retornar para a Lista de Classes