Zend_Service_Yahoo
ist eine einfach API für die Benutzung von vielen der Yahoo! REST APIs
Zend_Service_Yahoo
erlaubt die Suche im Web mit Hilfe von Yahoo! Web search, Yahoo! News,
Yahoo! Local, Yahoo! Images. Um die Yahoo! REST API zu benutzen, muss man eine Yahoo! Application ID haben.
Um eine Application ID zu bekommen, die folgende Application ID Request Form
ausgefüllt und abgeschickt werden
Zend_Service_Yahoo
ermöglicht es im Web mit Yahoo! zu Suchen mit Hilfe der Methode
webSearch()
, welche einen String als Abfrage Parameter akzeptiert und als optionalen
zweiten Parameter ein Array mit Such Optionen. Für vollständige Details und eine Liste der Optionen
bitte in die Yahoo! Web Such Dokumentation sehen.
Die webSearch()
Methode gibt ein Zend_Service_Yahoo_WebResultSet
Objekt zurück.
Man kann mit Yahoo nach Bildern suchen indem man Zend_Service_Yahoo
's imageSearch()
Methode
benutzt. Diese Methode akzeptiert einen String als Abfrage Parameter und optional ein Array mit
Such-Optionenwie für die webSearch()
Methode
Für vollständige Details und eine Liste der Optionen bitte in die Yahoo! Bild Such Dokumentation sehen.
Man kann mit Yahoo! nach lokalen Geschäften und Services suchen, indem man die localSearch()
Methode
benutzt.
Für vollständige Details bitte in die Yahoo! Lokal Suche Documentation sehen
Beispiel 15.13. Finden von lokalen Geschäften und Services mit Yahoo!
<?php require_once 'Zend/Service/Yahoo.php'; $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID"); $results = $yahoo->localSearch('Apple Computer', array('zip' => '95014')); foreach ($results as $result) { echo $result->Title .'<br />'; } ?>
Suchen mit Yahoo! News ist einfach; nur die newsSearch()
Methode, wie im
nachfolgenden Beispiel gezeigt, benutzen.
Für vollständige Details bitte in die Yahoo! News Suche Dokumenation sehen
Die folgenden Klassen werden durch die verschiedenen Yahoo! Suchen zurückgegeben. Jeder Such Typ gibt einen
speziellen Ergebnistyp zurück, welcher einfach Iteriert werden kann und jedes Ergebnis in einem
Ergebnis Objekt beinhaltet. Alle Ergebnis Klassen beinhalten ein SeekableIterator
Interface,
welches einfachste Iteration und die Suche nach einem speziellen Ergebnis ermöglicht.
Jedes der speziellen Ergebnis Sets ist von dieser Basis Klasse abgeleitet
Jedes der speziellen Ergebnis Sets gibt ein spezielles Zend_Service_Yahoo_Result Objekt zurück.
int totalResults();
Gibt die Anzahl an Ergebnissen für diese Suche zurück.
Tabelle 15.13. Zend_Service_Yahoo_ResultSet
Name | Typ | Beschreibung |
---|---|---|
totalResultsAvailable | int | Anzahl aller gefundenen Ergebnisse. |
totalResultsReturned | int | Anzahl der Ergebnisse des aktuellen Ergebnis Sets |
firstResultPosition | int | Position des ersten Ergebnisses dieses Sets relativ zur kompletten Anzahl aller Ergebnisse.. |
Zend_Service_Yahoo_WebResultSet
repräsentiert das Ergebnis Set einer Yahoo! Suche.
Anmerkung | |
---|---|
|
Zend_Service_Yahoo_ImageResultSet
repräsentiert das Ergebnis Set einer Yahoo! Bilder Suche.
Anmerkung | |
---|---|
|
Zend_Service_Yahoo_LocalResultSet
repräsentiert das Ergebnis Set einer Yahoo! Lokalbereichs Suche.
Tabelle 15.14. Zend_Service_Yahoo_LocalResultSet Properties
Name | Typ | Beschreibung |
---|---|---|
resultSetMapURL | string | Die URL der Webseite, welche den grafischen Plan, mit allen auf Ihr geplotteten Ergebnissen, beinhaltet. |
Anmerkung | |
---|---|
|
Zend_Service_Yahoo_NewsResultSet
repräsentiert das Ergebnis einer Yahoo! News Suche.
Anmerkung | |
---|---|
|
Jedes der speziellen Suchergebnisse ist von dieser Basis Klasse erweitert.
Jedes Suchergebnis im Web wird als Zend_Service_Yahoo_WebResult
Objekt zurückgegeben.
Tabelle 15.16. Zend_Service_Yahoo_WebResult Eigenschaften
Name | Typ | Beschreibung |
---|---|---|
Summary | string | Zusammenfassung des Ergebnisses |
MimeType | string | Mime Typ des Ergebnisses |
ModificationDate | string | Das Datum der letzten Modifikation des Ergebnisses als UNIX Zeitpunkt. |
CacheUrl | string | Die URL des Yahoo! Web Caches für dieses Ergebnis, wenn er existiert. |
CacheSize | int | Die Größe des Cache Eintrages |
Jedes Suchergebnis für Bilder wird als Zend_Service_Yahoo_ImageResult
Objekt zurückgegeben.
Tabelle 15.17. Zend_Service_Yahoo_ImageResult Eigenschaften
Name | Typ | Beschreibung |
---|---|---|
Summary | string | Zusammenfassung des Ergebnisses |
RefererUrl | string | Die URL der Seite welche das Bild beinhaltet |
FileSize | int | Die Größe des Bildes in Bytes |
FileFormat | string | Das Format des Bildes (bmp, gif, jpeg, png, usw.) |
Height | int | Die Höhe des Bildes |
Width | int | Die Breite des Bildes |
Thumbnail | Zend_Service_Yahoo_Image | Das Thumbnail des Bildes |
Jedes Suchergebnis für Pläne wird als Zend_Service_Yahoo_LocalResult
Objekt zurückgegeben.
Tabelle 15.18. Zend_Service_Yahoo_LocalResult Eigenschaften
Name | Typ | Beschreibung |
---|---|---|
Address | string | Die Adresse der Straße im Ergebnis |
City | string | Die Stadt in welcher das Ergebnis beheimatet ist |
State | string | Das Bundesland in welchem das Ergebnis beheimatet ist |
Phone | string | Die Telefonnummer des Ergebnisses |
Rating | int | Das Rating der Benutzer für dieses Ergebnis |
Distance | float | Die Entfernung des Ergebnisses von der eigenen gewählten Position |
MapUrl | string | Die URL zum Plan des Ergebnisses |
BusinessUrl | string | Die URL zur Geschäftswebseite, wenn bekannt |
BusinessClickUrl | string | Die URL zum Verlinken zur Geschäftswebseite, wenn bekannt |
Jedes News Suchergebnis wird als Zend_Service_Yahoo_NewsResult
Objekt zurückgegeben.
Tabelle 15.19. Zend_Service_Yahoo_NewsResult Eigenschaften
Name | Typ | Beschreibung |
---|---|---|
Summary | string | Zusammenfassung des Ergebnisses |
NewsSource | string | Die Firma welche diesen Artikel verschickt hat |
NewsSourceUrl | string | Die URL der Firma welche den Artikel verschickt hat |
Language | string | Die Sprache dieses Artikels |
PublishDate | string | Das Datum an dem dieser Artikel veröffentlicht wurde als UNIX Zeitpunkt |
ModificationDate | string | Das Datum an dem dieser Artikel zuletzt modifiziert wurde als UNIX Zeitpunkt |
Thumbnail | Zend_Service_Yahoo_Image | Das Thumbnail des Bildes für diesen Artikel, wenn es existiert |
Alle Bilder welche durch eine Yahoo! Bilder Suche oder einer Yahoo! News Suche zurückgegeben
werden, werden repräsentiert als Zend_Service_Yahoo_Image
Objekte