Passa ai contenuti principali

Integrare le funzionalità di Bing nei nostri siti web – Parte 5 – JSON & SOAP

In questo post della serie riservata a Bing diamo, rapidamente, un’occhiata agli entry point delle API che si basano sui protocolli JSON e SOAP. Le precedenti puntate sono disponibili ai seguenti link: Parte 1, Parte 2, Parte 3 e Parte 4.

     JSON

L’entry point per ottenere una risposta alla nostra ricerca con la serializzazione JSON è il seguente:

http://api.search.live.net/json.aspx

Tutti i discorsi visti nei precedenti posts relativi ai parametri di configurazione della ricerca sono ancora validi, per questo motivo, se effettuiamo una richiesta Get al seguente indirizzo:

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

otteniamo:

captured_Image.png

     Parametro JsonType

Nelle richieste JSON è possibile specificare il formato con cui restituire i risultati della ricerca tramite il parametro JsonType.
I possibili valori per JsonType sono:

raw : i risultati di ricerca sono restituiti in puro JSON;

callback : i risultati di ricerca vengono restituiti come argomento della funzione javascript indicata nel parametro JsonCallback;

function : viene restituita una funzione Javascript la cui chiamata restituisce i risultati di ricerca.

Se il parametro non viene assegnato, viene preso il valore raw per default.

     SOAP

Le funzionalità di ricerca di Bing sono utilizzabili anche tramite il protocollo SOAP referenziando il wsdl presente all’indirizzo:

http://api.bing.net/search.wsdl?AppID=<appid>&Version=2.2

Nella seguente figura riportiamo uno scorcio del wsdl:

captured_Image.png[6]

Per informazioni sull’utilizzo dei servizi web service esposti in formato SOAP e delle classi proxy che vengono generate dalla reference al WSDL, vi consiglio di guardare la documentazione ufficiale al seguente link.

La seguente funzione permette di effettuare la ricerca dei video presenti in rete che rispondono ai criteri di ricerca passati per argomento:

Public Function Search(ByVal text As String, _



                       ByVal recordCount As UInteger, _



                       ByRef totalPage As UInteger, _



                       Optional ByVal pageNumber As UInteger = 0, _



                       Optional ByVal market As String = "it-IT") As List(Of BingAPI.VideoResult)



        Dim retList As List(Of BingAPI.VideoResult) = Nothing



        If Not String.IsNullOrEmpty(text) Then



            Dim startIndex = recordCount * pageNumber



            Dim parameters = New BingAPI.SearchRequest()



            parameters.Video = New BingAPI.VideoRequest()



            parameters.Video.Count = recordCount



            parameters.Video.Offset = startIndex



            parameters.Market = market



            parameters.Query = text



            Using srv As New BingAPI.BingPortTypeClient()



                Try



                    Dim response = Me._Service.Search(parameters)



                    retList = response.Video.Results.ToList()



                    totalPage = CUInt(Math.Truncate(response.Video.Total / recordCount + 0.5))



                Catch ex As Exception



                    Throw



                End Try



            End Using



        Else



            retList = New List(Of BingAPI.VideoResult)



        End If



        Return retList



    End Function




La funzione accetta un testo di ricerca, un numero di record per pagina, il numero di pagina da restituire (opzionale), il market (opzionale) e restituisce il numero totale (approssimato) di elementi della ricerca e la lista dei risultati.

La classe VideoResult è una delle classi wrapper generate dalla reference al servizio SOAP di Bing:



captured_Image.png[1]



La classe BingPointPortClient è, invece, la classe per l’accesso al servizio di ricerca:



 



captured_Image.png[1]



Il protocollo SOAP è, decisamente, più semplice da utilizzare, fornendo in maniera automatica le wrapper classi per la gestione dei risultati.



     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

VB.NET : Aggregare stringhe con LINQ

Tip facile facile, ma a qualcuno potrebbe servire. Supponiamo di avere una lista di stringhe (magari come risultato di una query LINQ) e di voler ottenere una stringa con la concatenazione delle stesse: Dim list = CreateList() Dim concatStr = (From s In list _ Select s).Aggregate( Function (currentString, nextString) currentString + nextString) MessageBox.Show(concatStr) Il metodo CreateList non ci interessa, in questo momento, ma crea una lista di oggetti String. Protected Function CreateList() As IEnumerable( Of String ) Dim list As String () = {" stringa1 ", " stringa2 ", " stringa3 ", " stringa4 ", " stringa5 "} Return list.AsEnumerable() End Function Questo metodo potrebbe restituire una qualsiasi lista di oggetti di cui, nella select successiva recuperiamo solo stringhe. La stessa tecnica è utilizzabile per concatenare stringhe inserendovi un carattere separatore Dim list = CreateList() Dim

VB.NET: SplashScreen con effetto fade-in

In questo post vorrei proporvi un modo per realizzare una splash screen per le nostre applicazioni Windows Form che appare progressivamente con un effetto fade. Supponiamo di avere il nostro progetto VB.NET in una soluzione Visual Studio 2008 in cui abbiamo il sorgente della nostra applicazione Windows Form. Inseriamo una splash screen utilizzando il menù Progetto->Aggiungi Nuovo Elemento e selezionando il tipo di elemento “Schermata Iniziale” A questo punto Visual Studio creerà, automaticamente, la schermata iniziale che possiamo personalizzare graficamente come vogliamo. Per poter fare in modo che questa finestra appaia nel momento in cui avviamo l’applicazione, è necessario aprire le proprietà del progetto e impostare la maschera di avvio: In questo modo, all’avvio dell’applicazione, la schermata appare immediatamente e scompare un attimo prima della visualizzazione della finestra dell’applicazione. Possiamo far apparire la schermata iniziale con un ef

VB.NET: Convertire un file DOC in RTF e PDF con office interop

In questo post vorrei proporvi del codice per poter convertire un file .doc in un file .rtf oppure .pdf utilizzando le API di interoperabilità di Office. Creeremo una classe, DocConverter, che esporrà le due funzionalità sopra citate. Cominciamo con il prevedere un attributo privato della classe che rappresenterà l’applicazione Word che utilizzeremo per la conversione. Creeremo l’istanza dell’attributo privato all’interno del costruttore della classe: Public Sub New () If Not CreateWordApp() Then Throw New ApplicationException(" Assembly di interoperabilità con Office non trovato! ") End If End Sub Private _wordApp As Word.ApplicationClass Protected Function CreateWordApp() As Boolean Dim retval = True Try _wordApp = New Word.ApplicationClass() _wordApp.Visible = False Catch ex As System.Exception _wordApp = Nothing retval = False End Try Return retval End Function La conve