Zend Framework 1.9.9 Manual
|
|
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.
Example #1 Suchen im Web mit Yahoo!
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->webSearch('PHP');
foreach ($results as $result) {
echo $result->Title .'
';
}
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.
Example #2 Finden von Bildern mit Yahoo!
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->imageSearch('PHP');
foreach ($results as $result) {
echo $result->Title .'
';
}
Mit Yahoo können Videos gesucht werden indem Zend_Service_Yahoo's
videoSearch() Methode verwendet wird. Für komplette Details und
eine Liste an Optionen sollte in die » Yahoo! Video
Search Dokumentation gesehen werden.
Example #3 Videos mit Yahoo! finden
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->videoSearch('PHP');
foreach ($results as $result) {
echo $result->Title .'
';
}
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 Such Documentation sehen
Example #4 Finden von lokalen Geschäften und Services mit Yahoo!
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->localSearch('Apple Computer', array('zip' => '95014'));
foreach ($results as $result) {
echo $result->Title .'
';
}
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 Such Dokumenation sehen
Example #5 Suchen in Yahoo! News
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->newsSearch('PHP');
foreach ($results as $result) {
echo $result->Title .'
';
}
Das Durchsuchen von Yahoo! Site Explorer Inbound Links ist einfach; es muß nur die inlinkDataSearch() Methode wie im folgenden Beispiel verwendet werden. Für komplette Details, kann in die » Yahoo! Site Explorer Inbound Links Dokumentation gesehen werden.
Example #6 Durchsuchen von Yahoo! Site Explorer Inbound Links
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->inlinkDataSearch('http://framework.zend.com/');
foreach ($results as $result) {
echo $result->Title .'
';
}
Das Durchsuchen von Yahoo! Site Explorer's PageData ist einfach; es muß nur die pageDataSearch() Methode wie im folgenden Beispiel verwendet werden. Für komplette Details, kann in die » Yahoo! Site Explorer PageData Dokumentation gesehen werden.
Example #7 Durchsuchen von Yahoo! Site Explorer's PageData
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
$results = $yahoo->pageDataSearch('http://framework.zend.com/');
foreach ($results as $result) {
echo $result->Title .'
';
}
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.
Gibt die Anzahl an Ergebnissen für diese Suche zurück.
| 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.
Note:
Zend_Service_Yahoo_WebResultSeterweitert Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_ImageResultSet repräsentiert das Ergebnis
Set einer Yahoo! Bilder Suche.
Note:
Zend_Service_Yahoo_ImageResultSeterweitert Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_VideoResultSet repräsentiert ein Yahoo!
Video Suchergebnis.
Note:
Zend_Service_Yahoo_VideoResultSeterweitert Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_LocalResultSet repräsentiert das Ergebnis
Set einer Yahoo! Lokalbereichs Suche.
| Name | Typ | Beschreibung |
|---|---|---|
| resultSetMapURL | string | Die URL der Webseite, welche den grafischen Plan, mit allen auf Ihr geplotteten Ergebnissen, beinhaltet. |
Note:
Zend_Service_Yahoo_LocalResultSeterweitert Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_NewsResultSet repräsentiert das Ergebnis
einer Yahoo! News Suche.
Note:
Zend_Service_Yahoo_NewsResultSeterweitert Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_InlinkDataResultSet repräsentiert das
Ergebnis einer Yahoo! Inbound Link Suche.
Note:
Zend_Service_Yahoo_InlinkDataResultSeterweitert Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_PageDataResultSet repräsentiert das
Ergebnis einer Yahoo! PageData Suche.
Note:
Zend_Service_Yahoo_PageDataResultSeterweitert Zend_Service_Yahoo_ResultSet
Jedes der speziellen Suchergebnisse ist von dieser Basis Klasse erweitert.
| Name | Typ | Beschreibung |
|---|---|---|
| Title | string | Titel dieses Ergebnisses |
| Url | string | Die URL dieses Ergebnisses |
| ClickUrl | string | Die URL für den Link zu diesem Ergebnis |
Jedes Suchergebnis im Web wird als
Zend_Service_Yahoo_WebResult Objekt zurückgegeben.
| 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.
| 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 Video Suchergebnis wird als
Zend_Service_Yahoo_VideoResult Objekt zurückgegeben.
| Name | Typ | Beschreibung |
|---|---|---|
| Summary | string | Zusammenfassung des Ergebnisses |
| RefererUrl | string | Die URL der Seite die das Video enthält |
| FileSize | int | Die Größe der Videodatei in Bytes |
| FileFormat | string | Das Format des Videos (avi, flash, mpeg, msmedia, quicktime, realmedia, usw.) |
| Height | int | Die Höhe des Videos in Pixel |
| Width | int | Die Breite des Videos in Pixel |
| Duration | int | Die Länge des Videos in Sekunden |
| Channels | int | Anzahl an Audiokanälen im Video |
| Streaming | boolean | Wird das Video gestreamt oder nicht |
| Thumbnail | Zend_Service_Yahoo_Image | Thumbnail Bild |
Jedes Suchergebnis für Pläne wird als
Zend_Service_Yahoo_LocalResult Objekt zurückgegeben.
| 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.
| 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 |
Jedes Ergebnis einer Inbound Link Suche wird als
Zend_Service_Yahoo_InlinkDatabResult Objekt zurückgegeben.
Jedes Ergebnis einer PageData Suche wird als
Zend_Service_Yahoo_PageDatabResult Objekt zurückgegeben.
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
| Name | Typ | Beschreibung |
|---|---|---|
| Url | string | URL des Bildes |
| Width | int | Breite des Bildes |
| Height | int | Höhe des Bildes |
|
|
|