Passa ai contenuti principali

Integrare le funzionalità di Bing nei nostri siti web – Parte 1 - Introduzione

Vorrei inaugurare una serie di post illustrarvi le API di base dei servizi messi a disposizione dal motore di ricerca Bing.

Bing è accessibile attraverso tre differenti protocolli: XML, JSON e SOAP.
Queste tre modalità di accesso ai risultati ci permettono di scegliere il miglior modo per integrare funzionalità di ricerca nella nostra applicazione.

Grazie al protocollo XML, possiamo fare esperimenti sulle API di Bing utilizzando un normale browser.
Per fare questo è necessario recuperare un AppID, un parametro da passare alla richiesta Get che faremo con il browser che permette al sistema di riconoscerci.
Possiamo generare l’AppID andando sul sito per lo sviluppo con Bing (http://search.live.com/developers), loggarci con il nostro Windows Live ID e creare l’AppID utilizzando l’apposito link.
Per la creazione dell’AppID sarà necessario inserire alcune informazioni relative all’applicazione che utilizzerà l’ID generato:

 04-08-2009 8.03

Una volta che abbiamo in mano l’AppID possiamo sperimentare le funzionalità utilizzando un normale browser e una semplice richiesta Get con opportuni parametri in query string.
Gli url che possiamo utilizzare per effettuare dei test sono i seguenti:

http://api.search.live.net/xml.aspx (risultati in XML)

http://api.search.live.net/json.aspx (risultati in JSON)

Per semplicità utilizziamo il primo dei due (ma ciò che diremo vale anche per il secondo).
La richiesta Get va corredata da alcuni parametri in query string (oltre al già citato AppID):

Query : il parametro contiene le parole da ricercare (ad esempio “Bing”);
Sources : indica la sorgente da cui attingere i risultati. I possibili valori per questo parametro sono:

  • Ad : ricerca di inserzioni pubblicitarie;
  • Image  : immagini;
  • InstantAnswer : risposte a domande quali “quanti secondi ci sono in un anno?”, etc., etc.;
  • MobileWeb : contenuti web per dispositivi mobile;
  • News : notizie ;
  • Phonebook : dettagli su attività commerciali;
  • RelatedSearch : contenuti legati alla ricerca effettuata e di possibile interesse;
  • Spell : risultati con uno spelling simile a quello ricercato;
  • Translation : traduzioni tra differenti lingue;
  • Video : video correlati alla ricerca effettuata;
  • Web : classici contenuti web.

e sono valide anche  combinazioni degli stessi, utilizzando il carattere “+”.

La scelta oculata della sorgente dati ci consente di fornire differenti tipologie di risultati per ogni ricerca effettuata dall’utente.

Esistono altri parametri utilizzabili che gestiscono al paginazione dei risultati e che vedremo più avanti.

Tanto per entrare nel vivo, proviamo ad aprire il browser e a digitare il seguente URL:

http://api.search.live.net/xml.aspx?Appid=<appid>&query=Bing&sources=Web

dove <appid> va sostituito con il proprio AppID visto in precedenza.
Il risultato che otteniamo è il seguente:

04-08-2009 7.20

L’Header contiene le parole utilizzate per la ricerca, mentre il Body contiene gli effettivi risultati.

In caso di sorgenti multiple, ad esempio “Web+News+Image”, otteniamo:

04-08-2009 8.14

Per ogni tipologia di sorgente richiesta vengono forniti (con un particolare namespace) il numero totale dei risultati, l’offset (in sostanza la pagina di visualizzazione come vedremo avanti) e l’elenco dei primi n elementi trovati (con n=10 per impostazione predefinita).

Il nodo Total (tipizzato nelle diverse tipologie di sorgenti) rappresenta il numero totale (stimato) dei valori che soddisfano i parametri di ricerca. Questo valore va preso con le pinze in quanto potrebbe non essere esattamente uguale al numero dei risultati effettivi. Si tratta di una stima e come tale va utilizzata.

Il nodo Offset ci dice quale è l’indice del primo nodo risultato riportato nella lista dei risultati. Ci fornisce indicazioni riguardo alla pagina di risultati che stiamo esaminando.

Possiamo variare il numero di elementi di ogni sorgente restituiti per ogni ricerca utilizzando il parametro <sourcetype>.count. In questo modo, se aggiungiamo il parametro web.count=20 alla nostra query, otterremo 20 elementi di ricerca per il web e 10 per tutte le altre eventuali sorgenti richieste.
Facendo dei tentativi empirici si può riscontrare che se mettiamo, ad esempio, Web.count=51 otteniamo un errore che, invece, non otteniamo con Web.count=50.

Per poter lavorare sull’offset dei risultati (ottenendo, quindi le pagine successive dei risultati di ricerca) possiamo agire sul parametro <sourceType>.offset. In questo modo, se mettiamo Web.offset=21 ed eseguiamo la query, otteniamo i risultati a partire dal 21-esimo.

Ovviamente, i parametri visti in precedenza possono lavorare i combinazione per fornirci ampia flessibilità nelle ricerche.

Nel prossimo post analizzeremo i possibili parametri che possono essere utilizzati nelle API di Bing.

     Riferimenti

Per maggiori informazioni potete consultare la documentazione presente ai seguenti link:

Bing API, Version 2
Bing Developer Center

 

Commenti

Post popolari in questo blog

MVP Reconnect …… ovvero quando entri nella “famigghia” resti sempre nella “famigghia”!!!

Ma di che “famigghia” stiamo parlando!!!!

Fermi tutti, non si tratta di robe strane o sette segrete o affari malavitosi….stiamo parlando della grande famiglia dei Microsoft MVP.

Per chi non sapesse cosa sono i Microsoft MVP, vi consiglio di fare un giro sul sito ufficiale del programma (link), ma, volendolo spiegare in pochisime parole, si tratta di un riconoscimento che Microsoft da a persone che si distinguono per il loro impegno, aiutando gli altri ad ottenere il massimo grazie alle tecnologie Microsoft. Si tratta di persone, non dipendenti Microsoft, che mettono la loro passione, il loro tempo, la loro buona volontà per la divulgazione e la condivisione della conoscenza. Non necessariamente (come qualcuno erroneamente sostiene, evidentemente non conoscendo le basi del programma) si tratta di professionisti nel termine letterale del termine ma si tratta comunque di un gruppo di persone che sacrifica un pò del suo tempo (e, a volte, vi assicuro neanche pò!!!) per la sua passione.

Pe…

Template di progetto per sviluppare applicazioni WPF con Intel® RealSense™

E’ disponibile, nella gallery di Visual Studio, la prima versione del mio template di progetto per applicazioni WPF scritte in C# che permette di realizzare applicazioni con l’SDK di Intel® RealSense™.Il template si può scaricare direttamente all’interno Visual Studio utilizzando il tool “Extensions and Updates”oppure all’indirizzo https://visualstudiogallery.msdn.microsoft.com/1c36ecfd-8c00-4aee-b20c-a1726ab6424dIl template esegue le seguenti operazioni per voi:Aggiunge la reference all’assembly libpxcclr.cs.dll (nelle due distinte versioni per x86 e x64);Aggiunge lo script di post build per copiare la libreria libpxccpp2c.dll dalla cartella dell’SDK alla cartella bin del vostro progetto.Una volta creato il progetto dovete rimuovere la configurazione di compilazione AnyCPU (che non ha più senso) dalla vostra solution e sarete pronti per sviluppare con Intel® RealSense™.Ovviamente dovete installare l’SDK che potete scaricare all’indirizzo https://software.intel.com/en-us/intel-realsen…

Nuova versione del Band SDK

E’ di ieri l’annuncio del rilascio della nuova versione dell’SDK per il Microsoft Band.
Si tratta della versione 1.3.10417 (la precedente e, prima della serie, era la 1.3.10219 preview).
Maggiori informazioni, download dell’SDK per le tre piattaforme Windows Phone, iOS e Android all’indirizzo http://developer.microsoftband.com/.
Allo stesso indirizzo potrete trovare anche la documentazione.
Nei mesi scorsi mi sono gia’ occupato della precedente versione e questi sono i post che ne parlano:
Microsoft Band SDK Preview - First LookMicrosoft Band SDK Preview - ”Hello Band”Microsoft Band SDK Preview - Accesso ai sensoriMicrosoft Band SDK Preview - TileMicrosoft Band SDK Preview - NotificheMicrosoft Band SDK Preview - Personalizzazione
Gli argomenti trattati e il codice proposto dovrebbe, ad una prima lettura delle nuove funzionalita’ inserite, essere ancora valido e funzionante ma nei prossimi giorni prendero’ in esame tutti gli argomenti dei precedenti post e vedremo cosa cambia e cosa e’ …