TigerZF
🌐Español

64.21. Zend_Service_Flickr

64.21.1. Introducción

Zend_Service_Flickr es una API simple para usar el servicio web REST de Flickr. Para poder usar los servicios web de Flickr, debe tener una clave API. Para obtener una clave y para más información acerca del servicio web REST de Flickr, visite la documentación de la API de Flickr.

En el siguiente ejemplo, usamos el método tagSearch() para buscar fotos que tengan "php" en las etiquetas.

Ejemplo 64.98. Búsqueda simple de fotos en Flickr

$flickr = new Zend_Service_Flickr('MY_API_KEY');

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

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

[Note] Parámetro opcional

tagSearch() acepta un segundo parámetro opcional como un array de opciones.

64.21.2. Búsqueda de fotos e información de usuarios de Flickr

Zend_Service_Flickr proporciona varias formas de obtener información sobre los usuarios de Flickr:

  • userSearch(): Acepta una cadena de consulta de etiquetas separadas por espacios y un segundo parámetro opcional como un array de opciones de búsqueda, y devuelve un conjunto de fotos como un objeto Zend_Service_Flickr_ResultSet.

  • getIdByUsername(): Devuelve una cadena con el ID de usuario asociado con el nombre de usuario indicado.

  • getIdByEmail(): Devuelve una cadena con el ID de usuario asociado con la dirección de correo electrónico indicada.

Ejemplo 64.99. Búsqueda de las fotos públicas de un usuario de Flickr por dirección de correo electrónico

En este ejemplo, tenemos la dirección de correo electrónico de un usuario de Flickr, y buscamos las fotos públicas del usuario usando el método userSearch():

$flickr = new Zend_Service_Flickr('MY_API_KEY');

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

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

64.21.3. Búsqueda de fotos en el pool de un grupo

Zend_Service_Flickr permite recuperar las fotos del pool de un grupo a partir del ID del grupo. Use el método groupPoolGetPhotos():

Ejemplo 64.100. Recuperación de las fotos del pool de un grupo por ID de grupo

$flickr = new Zend_Service_Flickr('MY_API_KEY');

    $results = $flickr->groupPoolGetPhotos($groupId);

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

[Note] Parámetro opcional

groupPoolGetPhotos() acepta un segundo parámetro opcional como un array de opciones.

64.21.4. Recuperación de detalles de imágenes de Flickr

Zend_Service_Flickr permite obtener de forma rápida y sencilla los detalles de una imagen a partir de un ID de imagen dado. Simplemente use el método getImageDetails(), como en el siguiente ejemplo:

Ejemplo 64.101. Recuperación de detalles de imágenes de Flickr

Una vez que tiene un ID de imagen de Flickr, es sencillo obtener información sobre la imagen:

$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";

64.21.5. Clases de resultado de Zend_Service_Flickr

Las siguientes clases son devueltas por tagSearch() y userSearch():

64.21.5.1. Zend_Service_Flickr_ResultSet

Representa un conjunto de resultados de una búsqueda en Flickr.

[Note] Nota

Implementa la interfaz SeekableIterator para facilitar la iteración (por ejemplo, usando foreach()), así como el acceso directo a un resultado específico usando seek().

64.21.5.1.1. Propiedades

Tabla 64.16. Propiedades de Zend_Service_Flickr_ResultSet

Nombre Tipo Descripción
totalResultsAvailable int Número total de resultados disponibles
totalResultsReturned int Número total de resultados devueltos
firstResultPosition int El desplazamiento en el conjunto total de resultados de este conjunto de resultados

64.21.5.1.2. Zend_Service_Flickr_ResultSet::totalResults()

int totalResults();

Devuelve el número total de resultados en este conjunto de resultados.

Volver a la lista de clases

64.21.5.2. Zend_Service_Flickr_Result

Un único resultado de imagen de una consulta a Flickr

64.21.5.2.1. Propiedades

Tabla 64.17. Propiedades de Zend_Service_Flickr_Result

Nombre Tipo Descripción
id string ID de la imagen
owner string El NSID del propietario de la foto.
secret string Una clave usada en la construcción de la URL.
server string El nombre del servidor a usar para la construcción de la URL.
title string El título de la foto.
ispublic string La foto es pública.
isfriend string La foto es visible para usted porque es amigo del propietario.
isfamily string La foto es visible para usted porque es familiar del propietario.
license string La licencia bajo la cual está disponible la foto.
dateupload string La fecha en que se subió la foto.
datetaken string La fecha en que se tomó la foto.
ownername string El nombre de pantalla del propietario.
iconserver string El servidor usado para el ensamblado de las URLs de icono.
Square Zend_Service_Flickr_Image Una miniatura de 75x75 de la imagen.
Thumbnail Zend_Service_Flickr_Image Una miniatura de 100 píxeles de la imagen.
Small Zend_Service_Flickr_Image Una versión de 240 píxeles de la imagen.
Medium Zend_Service_Flickr_Image Una versión de 500 píxeles de la imagen.
Large Zend_Service_Flickr_Image Una versión de 640 píxeles de la imagen.
Original Zend_Service_Flickr_Image La imagen original.

Volver a la lista de clases

64.21.5.3. Zend_Service_Flickr_Image

Representa una imagen devuelta por una búsqueda en Flickr.

64.21.5.3.1. Propiedades

Tabla 64.18. Propiedades de Zend_Service_Flickr_Image

Nombre Tipo Descripción
uri string URI de la imagen original
clickUri string URI pulsable (es decir, la página de Flickr) de la imagen
width int Ancho de la imagen
height int Alto de la imagen

Volver a la lista de clases