PHP  »  Articoli  »  Web service 2.0 

Dopo aver introdotto il lettore all'uso di Yahoo! BOSS ed aver proposto alcuni esempi per l'uso di questo strumento per la ricerca di pagine web, andiamo a completare l'argomento proponendo degli spunti utili per effettuare ricerche mirate di immagini o di news. Questa tematica sarà naturalmente molto simile a quanto già affrontato per la ricerca di pagine web, ma sono presenti numerose piccole differenze che giustificano la scelta di dedicarvi alcuni paragrafi aggiuntivi. Restano valide tutte le indicazioni sul codice fornite in precedenza, quindi l'uso della libreria SimpleXML per interpretare i risultati o l'uso dell'estensione Curl piuttosto che della funzione file_get_contents() per inviare le richieste HTTP.

Ricerca di immagini

Il primo cambiamento riguarda l'indirizzo del web service, che riflette il fatto di effettuare ricerche per immagini:

http://boss.yahooapis.com/ysearch/images/v1/{query}?{parametri}

Rimangono validi tutti i parametri descritti per la ricerca nel web, a cui è possibile aggiungerne altri, quali ad esempio:

• filter, che assume come valori yes oppure no (yes di default, indica l'attivazione del filtro per i contenuti ritenuti offensivi, quali ad esempio violenza o pornografia);
• dimensions, che può assumere uno tra i seguenti valori: all (predefinito), small (miniature o icone), medium (immagini di media dimensione, che di solito non superano la dimensione dello schermo), large (immagini più larghe, che possono raggiungere o superare la dimensione dello schermo), wallpaper oppure widewallpaper.

I risultati della ricerca saranno sempre in formato XML simile a quanto analizzato in precedenza, con le dovute modifiche. In particolare, il nodo principale che contiene tutti i risultati non sarà più <resultset_web> ma ovviamente <resultset_images>, al cui interno troveremo tanti nodi <result> ad indicare i singoli risultati. Il nodo <resultset_images> avrà, in analogia con il corrispondente per la ricerca sul web, alcuni attributi che indicano il numero totale dei risultati (totalhits e deephits) ed il riferimento alla posizione dei risultati che si stanno visualizzando (start e count).

Interpretare i risultati della ricerca di immagini

Per ogni nodo <result> saranno presenti tutta nodi quante sono le informazioni disponibili sulla singola immagine. Di seguito proponiamo un elenco di massima:

• title, il titolo dato all'immagine
• abstract, una sua breve descrizione
• filename, il nome del file
• date, la data di indicizzazione dell'immagine, nel formato aaaa/mm/gg
• width, la larghezza dell'immagine in pixel
• height, l'altezza dell'immagine in pixel
• size, la dimensione del file in byte
• mimetype, il tipo MIME (ad esempio image/jpeg)
• format, il formato dell'immagine (ad esempio jpeg)
• thumbnail_width, la larghezza della miniatura in pixel
• thumbnail_height, l'altezza della miniatura in pixel
• thumbnail_url, l'indirizzo URL della miniatura
• url, l'indirizzo URL dell'immagine
• clickurl, 'indirizzo URL da usare nei propri collegamenti per linkare l'immagine
• refererurl, l'indirizzo URL del referer, ossia della pagina web che ospita l'immagine
• refererclickurl, l'indirizzo URL da usare nei propri collegamenti per linkare il referer

La maggior parte di queste informazioni sono di ovvia interpretazione per quanto riguarda l'utilizzo delle immagini. L'unico appunto probabilmente riguarda l'uso dei campi <clickurl> e <refererclickurl> che forse non sono immediatamente chiari: si tratta, come già visto per la ricerca web, di URL utilizzati da Yahoo! per fini statistici e vanno sempre utilizzati nel caso in cui noi volessimo inserire un collegamento dalle nostre pagine web alle immagini ottenute tramite la ricerca.

Altri vincoli da tenere a mente quanto utilizziamo i risultati della ricerca sono i seguenti:

• è necessario mostrare almeno uno tra i campi <title> e <abstract> in riferimento a ciascuna immagine
• è richiesto di mostrare almeno i primi 40 caratteri del campo <refererurl>
• è richiesto di usare sempre i campi <clickurl> e <refererclickurl> sia per i link, come spiegato sopra, sia per qualsiasi altro tipo di collegamento (ad esempio per mostrare all'interno di un frame la pagina che ospita l'immagine)

Altri articoli

Altre guide

Altre newsletter