PHP  »  Articoli  »  Web service 2.0 

Ricerca di news

Analizziamo ora la ricerca di notizie sul web sfruttando il medesimo web service. Come per le immagini, anche in questo caso sarà necessario utilizzare un indirizzo ad hoc per le nostre richieste, nell'usuale forma (in grassetto la parte da cambiare):

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

Rimangono validi i parametri descritti per la ricerca sul web, a cui andiamo ad aggiungere un ulteriore parametro per filtrare le notizie in base alla data di pubblicazione: con il parametro age possiamo appunto indicare l'intervallo temporale in cui cercare. Il valore predefinito è pari a 7d (7 days, ossia la ricerca viene effettuata su notizie pubblicate negli ultimi 7 giorni). In generale un valore per questo parametro viene costruito concatenando un numero intero ad una delle seguenti lettere:

• s, seconds, ossia secondi
• m, minutes, ossia minuti
• h, hours, ossia ore
• d, days, ossia giorni
• w, weeks, ossia settimane

Il numero intero e la lettera vanno riportati senza spaziatura, ed è possibile inoltre indicare un intervallo sfruttando il segno meno ("trattino"), ad esempio 5d-10d indica la ricerca di notizie vecchie dai 5 ai 10 giorni. Non è consentito indicare intervalli multipli o inserire più volte il parametro age. L'archivio delle notizie mantiene un indice fino a 30 giorni, quindi non è consentito cercare notizie più vecchie.

Interpretare i risultati della ricerca di news

Analogamente a quanto già visto per pagine web e immagini, anche la ricerca di news ci porta ad avere come risposta un documento XML il cui nodo più importante, che rappresenta il result set, si chiama appunto <resultset_news>. Al suo interno troveremo un nodo <result> per ciascuna news trovata, con diverse nodi figli che vanno a descrivere tutte le informazioni della notizia in questione.

Di seguito proponiamo l'elenco di tali nodi ed il relativo significato:

• title, il titolo della notizia
• abstract, un breve riassunto
• date, la data di pubblicazione o di ultima revisione
• time, l'orario di pubblicazione o di ultima revisione
• language, la lingua in cui è scritta la notizia (ad esempio "en english")
• url, l'indirizzo URL in cui è riportata la notizia
• clickurl, l'indirizzo da utilizzare nei propri risultati come link alla notizia
• source, il nome della fonte da cui è tratta la notizia
• sourceurl, l'indirizzo URL della fonte

Conclusioni

L'interpretazione dei risultati avviene in modo assolutamente analogo a quanto visto per la ricerca di pagine web e per la ricerca di immagini, per cui sarà sufficiente utilizzare gli esempi proposti in precedenza adattandoli al contesto delle news. In particolare, un aspetto molto interessante sarà la ricerca mirata per una singola lingua o per un singolo paese, nel caso in cui si vogliano utilizzare solo notizie localizzate.

Abbiamo dunque visto che con poche righe di codice è possibile integrare le funzionalità di ricerca all'interno delle proprie pagine web. Oltre alla ricerca, che magari gli utenti preferiscono effettuare direttamente su un motore di ricerca, potrebbe essere interessante aggiungere alle nostre pagine web notizie o immagini in tema con l'argomento del nostro sito, sfruttando quindi l'indice di Yahoo! per avere contenuti che possono dare un piccolo valore aggiunto alle nostre pagine.

Altri articoli

Altre guide

Altre newsletter