13.5. Zend_Service_Yahoo

13.5.1. Introduction

Zend_Service_Yahoo est une API simple pour utiliser les APIs REST de Yahoo! Zend_Service_Yahoo vous permet de rechercher dans Yahoo! Web search, Yahoo! News, Yahoo! Local et Yahoo! Images. Pour pouvoir utiliser l'API REST de Yahoo!, vous devez avoir un identifiant Yahoo Application. Pour obtenir un identifiant Yahoo Application, veuillez compléter et soumettre le formulaire de demande d'identifiant Yahoo! Application.

13.5.2. Rechercher sur le Web avec Yahoo!

Zend_Service_Yahoo vous permet d'effectuer des recherches sur le net avec Yahoo! en utilisant la méthode webSearch(), qui accepte une chaîne de requête en paramètre, et un tableau d'options de recherches comme second paramètre. Pour la liste détaillée des options, veuillez vous référer à la documentation Yahoo! Web Search. La méthode webSearch() retourne un objet Zend_Service_Yahoo_WebResultSet.

Exemple 13.11. Rechercher sur le Web avec Yahoo!

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

13.5.3. Trouver des images avec Yahoo!

Vous pouvez rechercher des Images avec Yahoo! en utilisant la méthode imageSearch() de Zend_Service_Yahoo. Cette méthode accepte une chaîne de requête en paramètres, et un tableau d'options en second paramètre optionnel. Pour la liste complète des options, veuillez vous référer à la documentation Yahoo! Image Search.

Exemple 13.12. Trouver des images avec Yahoo!

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

13.5.4. Trouver des entreprises et des services locaux avec Yahoo!

Vous pouvez rechercher des entreprises et des services locaux avec Yahoo!, en utilisant la méthode localSearch(). Pour plus de détails, veuillez vous référer à la documentation Yahoo! Local Search.

Exemple 13.13. Trouver des entreprises locales et des services avec Yahoo!

<?php
require_once 'Zend/Service/Yahoo.php';
$yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
$results = $yahoo->localSearch('Ordinateurs Apple', array('zip' => '95014'));
foreach ($results as $result) {
    echo $result->Title .'<br />';
}
?>       

13.5.5. Rechercher dans Yahoo! News

Rechercher dans Yahoo! News est simple, il vous suffit simplement d'utiliser la méthode newsSearch(), comme le montre l'exemple suivant. Pour plus de détails, veuillez vous référer à la documentation Yahoo! News Search.

Exemple 13.14. Rechercher dans Yahoo! News

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

13.5.6. Classes Zend_Service_Yahoo

Les classes sont toutes retournées par les divers recherches Yahoo!. Chaque type de recherche retourne un jeu de résultat de spécifique sur lequel on peut facilement itérer, avec chaque résultat contenu dans un résultat du type de l'objet. Toutes les classes de jeu de résultat implémentent l'interface SeekableIterator, permettant des itérations et une recherche sur un résultat particulier.

13.5.6.1. Zend_Service_Yahoo_ResultSet

Chaque jeu de résultat spécifique à la recherche est étendu de cette classe de base.

Chaque jeu de résultat spécifique à la recherche retourne un objet Zend_Service_Yahoo_Result spécifique à la recherche.

13.5.6.1.1. Zend_Service_Yahoo_ResultSet::totalResults()

int totalResults();

Retourne le nombre de résultats retourné par la recherche.

13.5.6.1.2. Propriétés

Tableau 13.13. Zend_Service_Yahoo_ResultSet

Nom Type Description
totalResultsAvailable int Nombre total de résultats trouvés.
totalResultsReturned int Nombre de résultats pour le jeu de résultat courant.
firstResultPosition int Position du premier résultat dans ce jeu, par rapport au nombre total des résultats.

Retour à la liste des classes

13.5.6.2. Zend_Service_Yahoo_WebResultSet

Zend_Service_Yahoo_WebResultSet représent un jeu de résutat Yahoo! Web Search.

[Note] Note

Zend_Service_Yahoo_WebResultSet étend Zend_Service_Yahoo_ResultSet.

Retour à la liste des classes

13.5.6.3. Zend_Service_Yahoo_ImageResultSet

Zend_Service_Yahoo_ImageResultSet représente un jeu de résultat Yahoo! Image Search.

[Note] Note

Zend_Service_Yahoo_ImageResultSet étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

13.5.6.4. Zend_Service_Yahoo_LocalResultSet

Zend_Service_Yahoo_LocalResultSet représente un jeu de résultats Yahoo! Local Search.

Tableau 13.14. Propriétés de Zend_Service_Yahoo_LocalResultSet

Nom Type Description
resultSetMapURL string L'URL de la page Web contenant une carte graphique contenant tous les résultats affiché dessus.
[Note] Note

Zend_Service_Yahoo_LocalResultSet étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

13.5.6.5. Zend_Service_Yahoo_NewsResultSet

Zend_Service_Yahoo_NewsResultSet représente un jeu de résultat Yahoo! News Search.

[Note] Note

Zend_Service_Yahoo_NewsResultSet étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

13.5.6.6. Zend_Service_Yahoo_Result

Chaque résultat spécifique à la recherche est étendu de cette classe de base.

13.5.6.6.1. Propriétés

Tableau 13.15. Propriétés de Zend_Service_Yahoo_Result

Nom Type Description
Title string Titre du résultat
Url string URL du résultat
ClickUrl string URL pour pointer sur ce résultat

Retour à la liste des classes

13.5.6.7. Zend_Service_Yahoo_WebResult

Each Web Search result is returned as a Zend_Service_Yahoo_WebResult object.

13.5.6.7.1. Propriétés

Tableau 13.16. Propriétés de Zend_Service_Yahoo_WebResult

Nom Type Description
Summary string Sommaire du résultat
MimeType string type Mime du résultat
ModificationDate string Timestamp UNIX de la date de la dernière modification du résultat.
CacheUrl string URL Yahoo! du cache web du résultat, s'il existe.
CacheSize int Taille du cache.

Retour à la liste des classes

13.5.6.8. Zend_Service_Yahoo_ImageResult

Each Image Search result is returned as a Zend_Service_Yahoo_ImageResult object.

13.5.6.8.1. Propriétés

Tableau 13.17. Propriétés de Zend_Service_Yahoo_ImageResult

Nom Type Description
Summary string Sommaire du résultat
RefererUrl string L'URL de la page qui contient l'image
FileSize int La taille (en octets) de l'image
FileFormat string Le format de l'image (bmp, gif, jpeg, png, etc.)
Height int La hauteur de l'image
Width int LA largeur de l'image
Thumbnail Zend_Service_Yahoo_Image Vignette de l'image

Retour à la liste des classes

13.5.6.9. Zend_Service_Yahoo_LocalResult

Chaque résultat de recherche locale est retourné dans un objet Zend_Service_Yahoo_LocalResult.

13.5.6.9.1. Propriétés

Tableau 13.18. Propriétés de Zend_Service_Yahoo_LocalResult

Nom Type Description
Address string Adresse de la rue du résultat
City string Ville dans laquelle réside le résultat
State string Etat dans lequel réside le résultat
Phone string Numéro de téléphone du résultat
Rating int Appréciation des utilisateur pour ce résultat
Distance float Distance entre l'endroit ou vous vous trouvez et le résultat
MapUrl string L'URL d'une carte pour le résultat
BusinessUrl string L'URL du site de l'entreprise, s'il est connu
BusinessClickUrl string L'URL pour faire un lien sur le site de l'entreprise, s'il est connu

Retour à la liste des classes

13.5.6.10. Zend_Service_Yahoo_NewsResult

Chaque résultat de News Search est retourné comme un objet Zend_Service_Yahoo_NewsResult.

13.5.6.10.1. Propriétés

Tableau 13.19. Propriétés de Zend_Service_Yahoo_NewsResult

Nom Type Description
Summary string Sommaire du résultat
NewsSource string L'entreprise qui a distribué l'article
NewsSourceUrl string L'URL de l'entreprise qui a distribué l'article
Language string La langue de l'article
PublishDate string La date de publication de l'article, au format timestamp UNIX
ModificationDate string La date de la dernière modification de l'article, au format timestamp UNIX
Thumbnail Zend_Service_Yahoo_Image Miniature de l'image pour cet article, si elle existe

Retour à la liste des classes

13.5.6.11. Zend_Service_Yahoo_Image

Toutes les images retournées, par Yahoo! Image Search ou Yahoo! News Search sont représentées par un objet Zend_Service_Yahoo_Image.

13.5.6.11.1. Propriétés

Tableau 13.20. Propriétés de Zend_Service_Yahoo_Image

Nom Type Description
Url string URL de l'image
Width int Largeur de l'image
Height int Hauteur de l'image

Retour à la liste des classes