29.8. Zend_Service_Yahoo

29.8.1. Einführung

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

29.8.2. Suchen im Web mit Yahoo!

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.

Beispiel 29.32. Suchen im Web mit Yahoo!

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

29.8.3. Finden von Bildern mit Yahoo!

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.

Beispiel 29.33. Finden von Bildern mit Yahoo!

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

29.8.4. Finden von lokalen Geschäften und Services mit Yahoo!

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 29.34. 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 />';
}
?>       

29.8.5. Suchen mit Yahoo! News

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

Beispiel 29.35. Suchen in Yahoo! News

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

29.8.6. Zend_Service_Yahoo Klassen

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.

29.8.6.1. Zend_Service_Yahoo_ResultSet

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.

29.8.6.1.1. Zend_Service_Yahoo_ResultSet::totalResults()

int totalResults();

Gibt die Anzahl an Ergebnissen für diese Suche zurück.

29.8.6.1.2. Eigenschaften

Tabelle 29.15. 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..

Zurück zur Liste der Klassen

29.8.6.2. Zend_Service_Yahoo_WebResultSet

Zend_Service_Yahoo_WebResultSet repräsentiert das Ergebnis Set einer Yahoo! Suche.

[Anmerkung] Anmerkung

Zend_Service_Yahoo_WebResultSet erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

29.8.6.3. Zend_Service_Yahoo_ImageResultSet

Zend_Service_Yahoo_ImageResultSet repräsentiert das Ergebnis Set einer Yahoo! Bilder Suche.

[Anmerkung] Anmerkung

Zend_Service_Yahoo_ImageResultSet erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

29.8.6.4. Zend_Service_Yahoo_LocalResultSet

Zend_Service_Yahoo_LocalResultSet repräsentiert das Ergebnis Set einer Yahoo! Lokalbereichs Suche.

Tabelle 29.16. 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] Anmerkung

Zend_Service_Yahoo_LocalResultSet erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

29.8.6.5. Zend_Service_Yahoo_NewsResultSet

Zend_Service_Yahoo_NewsResultSet repräsentiert das Ergebnis einer Yahoo! News Suche.

[Anmerkung] Anmerkung

Zend_Service_Yahoo_NewsResultSet erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

29.8.6.6. Zend_Service_Yahoo_Result

Jedes der speziellen Suchergebnisse ist von dieser Basis Klasse erweitert.

29.8.6.6.1. Eigenschaften

Tabelle 29.17. Zend_Service_Yahoo_Result Eigenschaften

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

Zurück zur Liste der Klassen

29.8.6.7. Zend_Service_Yahoo_WebResult

Jedes Suchergebnis im Web wird als Zend_Service_Yahoo_WebResult Objekt zurückgegeben.

29.8.6.7.1. Eigenschaften

Tabelle 29.18. 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

Zurück zur Liste der Klassen

29.8.6.8. Zend_Service_Yahoo_ImageResult

Jedes Suchergebnis für Bilder wird als Zend_Service_Yahoo_ImageResult Objekt zurückgegeben.

29.8.6.8.1. Eigenschaften

Tabelle 29.19. 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

Zurück zur Liste der Klassen

29.8.6.9. Zend_Service_Yahoo_LocalResult

Jedes Suchergebnis für Pläne wird als Zend_Service_Yahoo_LocalResult Objekt zurückgegeben.

29.8.6.9.1. Eigenschaften

Tabelle 29.20. 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

Zurück zur Liste der Klassen

29.8.6.10. Zend_Service_Yahoo_NewsResult

Jedes News Suchergebnis wird als Zend_Service_Yahoo_NewsResult Objekt zurückgegeben.

29.8.6.10.1. Eigenschaften

Tabelle 29.21. 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

Zurück zur Liste der Klassen

29.8.6.11. Zend_Service_Yahoo_Image

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

29.8.6.11.1. Eigenschaften

Tabelle 29.22. Zend_Service_Yahoo_Image Eigenschaften

Name Typ Beschreibung
Url string URL des Bildes
Width int Breite des Bildes
Height int Höhe des Bildes

Zurück zur Liste der Klassen