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.
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
.
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.
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 />'; } ?>
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.
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.
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.
int totalResults();
Retourne le nombre de résultats retourné par la recherche.
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. |
Zend_Service_Yahoo_WebResultSet
représent un jeu de résutat Yahoo! Web Search.
Note | |
---|---|
|
Zend_Service_Yahoo_ImageResultSet
représente un jeu de résultat Yahoo! Image Search.
Note | |
---|---|
|
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 | |
---|---|
|
Zend_Service_Yahoo_NewsResultSet
représente un jeu de résultat Yahoo! News Search.
Note | |
---|---|
|
Chaque résultat spécifique à la recherche est étendu de cette classe de base.
Each Web Search result is returned as a Zend_Service_Yahoo_WebResult
object.
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. |
Each Image Search result is returned as a Zend_Service_Yahoo_ImageResult
object.
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 |
Chaque résultat de recherche locale est retourné dans un objet Zend_Service_Yahoo_LocalResult
.
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 |
Chaque résultat de News Search est retourné comme un objet Zend_Service_Yahoo_NewsResult
.
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 |
Toutes les images retournées, par Yahoo! Image Search ou Yahoo! News Search sont représentées par un objet Zend_Service_Yahoo_Image
.