24.5. Zend_Service_Yahoo
Zurück | Kapitel 24. Zend_Service | Weiter

## 24.5. Zend_Service_Yahoo

### 24.5.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

### 24.5.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 24.13. 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 />';
    }
    ?>

### 24.5.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 24.14. 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 />';
    }
    ?>

### 24.5.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 24.15. 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 />';
    }
    ?>

### 24.5.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 24.16. 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 />';
    }
    ?>

### 24.5.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.

- `Zend_Service_Yahoo_ResultSet`

- `Zend_Service_Yahoo_WebResultSet`

- `Zend_Service_Yahoo_ImageResultSet`

- `Zend_Service_Yahoo_LocalResultSet`

- `Zend_Service_Yahoo_NewsResultSet`

- `Zend_Service_Yahoo_Result`

- `Zend_Service_Yahoo_WebResult`

- `Zend_Service_Yahoo_ImageResult`

- `Zend_Service_Yahoo_LocalResult`

- `Zend_Service_Yahoo_NewsResult`

- `Zend_Service_Yahoo_Image`

#### 24.5.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.

##### 24.5.6.1.1. Zend_Service_Yahoo_ResultSet::totalResults()

`int totalResults();`

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

##### 24.5.6.1.2. Eigenschaften

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

Zurück zur Liste der Klassen

#### 24.5.6.2. Zend_Service_Yahoo_WebResultSet

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

| Anmerkung
`Zend_Service_Yahoo_WebResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

#### 24.5.6.3. Zend_Service_Yahoo_ImageResultSet

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

| Anmerkung
`Zend_Service_Yahoo_ImageResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

#### 24.5.6.4. Zend_Service_Yahoo_LocalResultSet

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

Tabelle 24.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_LocalResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

#### 24.5.6.5. Zend_Service_Yahoo_NewsResultSet

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

| Anmerkung
`Zend_Service_Yahoo_NewsResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

#### 24.5.6.6. Zend_Service_Yahoo_Result

Jedes der speziellen Suchergebnisse ist von dieser Basis Klasse erweitert.

##### 24.5.6.6.1. Eigenschaften

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

#### 24.5.6.7. Zend_Service_Yahoo_WebResult

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

##### 24.5.6.7.1. Eigenschaften

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

Zurück zur Liste der Klassen

#### 24.5.6.8. Zend_Service_Yahoo_ImageResult

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

##### 24.5.6.8.1. Eigenschaften

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

Zurück zur Liste der Klassen

#### 24.5.6.9. Zend_Service_Yahoo_LocalResult

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

##### 24.5.6.9.1. Eigenschaften

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

Zurück zur Liste der Klassen

#### 24.5.6.10. Zend_Service_Yahoo_NewsResult

Jedes News Suchergebnis wird als `Zend_Service_Yahoo_NewsResult` Objekt zurückgegeben.

##### 24.5.6.10.1. Eigenschaften

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

Zurück zur Liste der Klassen

#### 24.5.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

##### 24.5.6.11.1. Eigenschaften

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

Zurück | Nach oben | Weiter
24.4. Zend_Service_Flickr | Zum Anfang | Kapitel 25. Zend_Session