# Zend_Service_Yahoo

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

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

### Suchen im Web mit Yahoo!

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

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

### Finden von Bildern mit Yahoo!

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

## Videos mit Yahoo! finden

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.

### Videos mit Yahoo! finden

    $yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID");
    $results = $yahoo->videoSearch('PHP');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }

## 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 Such Documentation sehen

### 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 .'<br />';
    }

## 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 Such Dokumenation sehen

### Suchen in Yahoo! News

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

## Durchsuchen von Yahoo! Site Explorer Inbound Links

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.

### 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 .'<br />';
    }

## Durchsuchen von Yahoo! Site Explorer's PageData

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.

### 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 .'<br />';
    }

## 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_VideoResultSet`

- `Zend_Service_Yahoo_LocalResultSet`

- `Zend_Service_Yahoo_NewsResultSet`

- `Zend_Service_Yahoo_InlinkDataResultSet`

- `Zend_Service_Yahoo_PageDataResultSet`

- `Zend_Service_Yahoo_Result`

- `Zend_Service_Yahoo_WebResult`

- `Zend_Service_Yahoo_ImageResult`

- `Zend_Service_Yahoo_VideoResult`

- `Zend_Service_Yahoo_LocalResult`

- `Zend_Service_Yahoo_NewsResult`

- `Zend_Service_Yahoo_InlinkDataResult`

- `Zend_Service_Yahoo_PageDataResult`

- `Zend_Service_Yahoo_Image`

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

#### Zend_Service_Yahoo_ResultSet::totalResults()

int `totalResults`

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

#### Eigenschaften

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

### Zend_Service_Yahoo_WebResultSet

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

`Zend_Service_Yahoo_WebResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_ImageResultSet

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

`Zend_Service_Yahoo_ImageResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_VideoResultSet

`Zend_Service_Yahoo_VideoResultSet` repräsentiert ein Yahoo! Video Suchergebnis.

`Zend_Service_Yahoo_VideoResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_LocalResultSet

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

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

`Zend_Service_Yahoo_LocalResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_NewsResultSet

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

`Zend_Service_Yahoo_NewsResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_InlinkDataResultSet

`Zend_Service_Yahoo_InlinkDataResultSet` repräsentiert das Ergebnis einer Yahoo! Inbound Link Suche.

`Zend_Service_Yahoo_InlinkDataResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_PageDataResultSet

`Zend_Service_Yahoo_PageDataResultSet` repräsentiert das Ergebnis einer Yahoo! PageData Suche.

`Zend_Service_Yahoo_PageDataResultSet` erweitert Zend_Service_Yahoo_ResultSet

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_Result

Jedes der speziellen Suchergebnisse ist von dieser Basis Klasse erweitert.

#### Eigenschaften

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

### Zend_Service_Yahoo_WebResult

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

#### Eigenschaften

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

### Zend_Service_Yahoo_ImageResult

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

#### Eigenschaften

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

### Zend_Service_Yahoo_VideoResult

Jedes Video Suchergebnis wird als `Zend_Service_Yahoo_VideoResult` Objekt zurückgegeben.

#### Eigenschaften

##### Zend_Service_Yahoo_VideoResult Eigenschaften

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

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_LocalResult

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

#### Eigenschaften

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

### Zend_Service_Yahoo_NewsResult

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

#### Eigenschaften

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

### Zend_Service_Yahoo_InlinkDataResult

Jedes Ergebnis einer Inbound Link Suche wird als `Zend_Service_Yahoo_InlinkDatabResult` Objekt zurückgegeben.

Zurück zur Liste der Klassen

### Zend_Service_Yahoo_PageDataResult

Jedes Ergebnis einer PageData Suche wird als `Zend_Service_Yahoo_PageDatabResult` Objekt zurückgegeben.

Zurück zur Liste der Klassen

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

#### Eigenschaften

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