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: 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:PublicSubNew()
IfNot CreateWordApp() Then
ThrowNew ApplicationException("Assembly di interoperabilità con Office non trovato!")
EndIf
EndSub
Private _wordApp As Word.ApplicationClass
ProtectedFunction CreateWordApp() AsBoolean
Dim retval = True
Try
_wordApp = New Word.ApplicationClass()
_wordApp.Visible = False
Catch ex As System.Exception
_wordApp = Nothing
retval = False
EndTry
Return retval
EndFunction

La conversione del file doc sarà effettuata aprendo il file stesso ed eseguendo un’operazione di SaveAs:

Pr…

Cambiare la lingua di Visual Studio 2008

Oggi ho avuto qualche problema installando Windows Mobile 6 Professional SDK Refresh e Windows Mobile 6 Standard SDK Refresh.Scaricati i file di installazione e installati, ho provato a creare un progetto di tipo Windows Mobile 6.0 e mi sono beccato questo errore:Dopo qualche smanettamento abbiamo scoperto (e ringrazio il mitico Matteo per l’aiuto) che il mio Visual Studio 2008, pur essendo in Inglese (prova ne era il fatto che gli hotfix e la SP installata erano nella lingua di Albione) aveva come lingua impostata quella del sistema operativo (italiano).Ovviamente, non avrebbe mai potuto trovare la cartella 1040 (italiano) visto che l’installazione dell’SDK aveva supposto che la lingua del Visual Studio fosse Inglese (1033).La soluzione del problema è duplice:1) Duplicate la cartella 1033 presente nel percorso evidenziato dall’errore e la rinominate 10402) cambiate la lingua di Visual Studio.Per questa ultima eventualità basta andare nel menù Strumenti/Opzioni:e cambiare il linguaggi…

Tascam DR-05 registratore digitale per tutti

Diverso tempo fa ho acquistato il registratore digitale Tascam DR-05 e, ora, dopo diversi mesi di utilizzo, posso dire la mia a proposito.

Si tratta di un ottimo registratore digitale con microfono stereo che permette di ottenere registrazioni di ottima qualitaà anche in ambienti non perfetti dal punto di vista acustico.

Interessante la possibilità di utilizzare un cavalletto di piccole dimensioni come HAMA Mini treppiede o Mini Cavalletto Universale per tenere il microfono sollevato dal tavolo in fase di registrazione grazie allàattacco universale per macchina fotografica che il microfono ha nella parte inferiore.

Da segnalare anche il menu’ ben fatto e la possibilita’ di utilizzare una scheda SD esterna per memorizzare i file audio. Anche a livello di consumo batterie non e’ niente male. Consiglio l’uso delle alcaline non ricaricabili.

Il mio utilizzo e’ stato prettamente di registrazione di podcast vocali (no musica) ma le recensioni confermano che se la cava egregiamente con la mu…