Inserire i dati in Excel in automatico? Crea una macro che recupera informazioni dettagliate sull'indirizzo e li inserisce in un foglio di calcolo.

Inserire dati in Excel con la macro di ONLYOFFICE

Molto spesso, lavorare con dati non strutturati inseriti in foglio Excel potrebbe ostacolare i calcoli. Esiste un modo per inserire i dati in Excel in automatico? In questo articolo ti guideremo attraverso la creazione di una macro che recupera informazioni dettagliate sull&#8217;indirizzo in base ai dati dell&#8217;indirizzo e li inserisce in un foglio di calcolo.
<img decoding="async" loading="lazy" class="aligncenter wp-image-61811" src="https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08135145/Geocoding-API-Macros.png" alt="Use ONLYOFFICE macro to obtain and insert detailed address information" width="736" height="372" srcset="https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08135145/Geocoding-API-Macros.png 1470w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08135145/Geocoding-API-Macros-300x151.png 300w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08135145/Geocoding-API-Macros-1024x517.png 1024w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08135145/Geocoding-API-Macros-768x388.png 768w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08135145/Geocoding-API-Macros-634x320.png 634w, https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08135145/Geocoding-API-Macros-353x178.png 353w" sizes="(max-width: 736px) 100vw, 736px" />
&nbsp;
<h2>Informazioni sull&#8217;API di Geoapify Geocoding</h2>
<a href="https://www.geoapify.com/geocoding-api?utm_source=blog&amp;utm_medium=article+&amp;utm_id=geocoding_spreadsheet_macro" target="_blank" rel="noopener">Geoapify</a> Geocoding API è un potente strumento che consente agli sviluppatori di integrare funzionalità di geocoding nelle loro applicazioni e servizi. La geocodifica è il processo di conversione di indirizzi o nomi di luoghi in coordinate geografiche.
Con l&#8217;API Geoapify Geocoding, puoi recuperare dati dettagliati sugli indirizzi, inclusi nomi di strade, nomi di città, codici postali, regioni amministrative e altro. E abbiamo in programma di sfruttare questa funzionalità e integrarla nella nostra macro.
<h2>Concetto di macro</h2>
<ul>
<li>Legge l&#8217;indirizzo dalla cella specificata.</li>
<li>Invia una richiesta all&#8217;API Geoapify Geocoding per recuperare i dettagli dell&#8217;indirizzo.</li>
<li>Elabora la risposta e crea l&#8217;oggetto Dettagli indirizzo.</li>
<li>Incolla i dettagli dell&#8217;indirizzo nel foglio di lavoro.</li>
<li>Legge l&#8217;indirizzo successivo e ripeti il processo.</li>
</ul>
<h2>Costruire la macro</h2>
Innanzitutto, segniamo le variabili:
<pre class="theme:github font:monospace lang:js decode:true">   const API_KEY = 'your_API_key'
    const ENDPOINT = 'https://api.geoapify.com/v1/geocode/search'
    const oWorksheet = Api.GetActiveSheet()
    let row = 2
</pre>
La variabile API_KEY contiene la chiave API Geoapify. La variabile ENDPOINT memorizza l&#8217;endpoint API per il servizio di geocodifica. La variabile oWorksheet ha come target il foglio di calcolo attivo. E la variabile row  consente di selezionare la riga desiderata.
Quindi aggiungiamo la funzione makeRequest che è responsabile dell&#8217;invio di una richiesta all&#8217;API:
<pre class="theme:github font:monospace lang:js decode:true">  makeRequest(oWorksheet.GetRange(`A${row}`).GetText())
 
    // REQUEST
    function makeRequest(ADDRESS) {
        if (ADDRESS === '') return
        $.ajax({
            url: `${ENDPOINT}?text=${addressToRequest(ADDRESS)}&amp;apiKey=${API_KEY}`,
            dataType: 'json',
        }).done(successFunction)
    }
</pre>
Utilizza la funzione $.ajax per effettuare una richiesta HTTP GET all&#8217;endpoint, passando l&#8217;indirizzo come parametro.
Quindi la funzione addressToRequest trasforma l&#8217;indirizzo in un formato compatibile con l&#8217;URL:
<pre class="theme:github font:monospace lang:js decode:true ">function addressToRequest (address) {
        return address.replaceAll(' ', '%20').replaceAll(',', '%2C')
    }
</pre>
Se la richiesta API ha esito positivo, viene chiamata successFunction. Riceve la risposta dall&#8217;API come parametro:
<pre class="theme:github font:monospace lang:js decode:true ">  function successFunction(response) {
        const data = createAddressDetailsObject(response)
        pasteAddressDetails(data)
        reload()
    }
</pre>
Quindi la funzione createAddressDetailsObject elabora la risposta. Se l&#8217;indirizzo non viene trovato, viene restituito un messaggio di errore. In caso contrario, la funzione crea l&#8217;oggetto Dettagli indirizzo:
<pre class="theme:github font:monospace lang:js decode:true ">    // Create Address Details object if address is found
    function createAddressDetailsObject(response) {
        if (response.features.length === 0) {
            return { error: 'Address not found' }
        }
        let data = {
            country: response.features[0].properties.country,
            county: response.features[0].properties.county,
            city: response.features[0].properties.city,
            post_code: response.features[0].properties.postcode,
            full_address_line: response.features[0].properties.formatted
        }
        data = checkMissingData(data)
        return data
    }
</pre>
Per controllare i dati ricevuti, utilizziamo la funzione checkMissingData. Sostituisce i campi mancanti con un trattino:
<pre class="theme:github font:monospace lang:js decode:true "> function checkMissingData(data) {
        Object.keys(data).forEach(key =&gt; {
            if(data[key] === undefined) data[key] = '-'
        })
        return data
    }
</pre>
Quindi incolliamo i dati con la funzione pasteAddressDetails. La funzione utilizza l&#8217;oggetto oWorksheet per indirizzare il foglio attivo e selezionare l&#8217;intervallo appropriato:
<pre class="theme:github font:monospace lang:js decode:true ">function pasteAddressDetails(data) {
        const oRange = oWorksheet.GetRange(`B${row}:F${row}`)
</pre>
Se è presente un messaggio di errore, viene incollato nell&#8217;intervallo:
<pre class="theme:github font:monospace lang:js decode:true "> if (data.error !== undefined) {
            oRange.SetValue([[data.error]])
        } 
</pre>
In caso contrario, i dettagli dell&#8217;indirizzo vengono popolati nell&#8217;intervallo utilizzando la funzione SetValue:
<pre class="theme:github font:monospace lang:js decode:true "> else {
            oRange.SetValue([
                [data.country],
                [data.county],
                [data.city],
                [data.post_code],
                [data.full_address_line]
            ])
        }</pre>
La funzione quindi incrementa la riga e chiama in modo ricorsivo makeRequest per elaborare l&#8217;indirizzo successivo:
<pre class="theme:github font:monospace lang:js decode:true "> // Execute recursively until "Address" value is empty
        row++
        makeRequest(oWorksheet.GetRange(`A${row}:A${row}`).GetText())
    }
</pre>
Successivamente, invochiamo la funzione di ricarica. Attiva un ricalcolo del foglio di calcolo dopo l&#8217;elaborazione di ciascun indirizzo:
<pre class="theme:github font:monospace lang:js decode:true "> function reload() {
        let reload = setInterval(function(){
            Api.asc_calculate(Asc.c_oAscCalculateType.All);
        })
    }
</pre>
L&#8217;intero codice della macro è il seguente:
<pre class="theme:github font:monospace lang:js decode:true ">(function()
{
    const API_KEY = 'your_API_key'
    const ENDPOINT = 'https://api.geoapify.com/v1/geocode/search'
    const oWorksheet = Api.GetActiveSheet()
    let row = 2
    makeRequest(oWorksheet.GetRange(`A${row}`).GetText())
    
    
    // REQUEST
    function makeRequest(ADDRESS) {
        if (ADDRESS === '') return
        $.ajax({
            url: `${ENDPOINT}?text=${addressToRequest(ADDRESS)}&amp;apiKey=${API_KEY}`,
            dataType: 'json',
        }).done(successFunction)
    }
    // London, United Kingdom -&gt; London%2C%20United%20Kingdom
    function addressToRequest (address) {
        return address.replaceAll(' ', '%20').replaceAll(',', '%2C')
    }
    
    
    // RESPONSE
    function successFunction(response) {
        const data = createAddressDetailsObject(response)
        pasteAddressDetails(data)
        reload()
    }
    // Create Address Details object if address is found
    function createAddressDetailsObject(response) {
        if (response.features.length === 0) {
            return { error: 'Address not found' }
        }
        let data = {
            country: response.features[0].properties.country,
            county: response.features[0].properties.county,
            city: response.features[0].properties.city,
            post_code: response.features[0].properties.postcode,
            full_address_line: response.features[0].properties.formatted
        }
        data = checkMissingData(data)
        return data
    }
    // Replace missing fields with '-'
    function checkMissingData(data) {
        Object.keys(data).forEach(key =&gt; {
            if(data[key] === undefined) data[key] = '-'
        })
        return data
    }
    
    
    // PASTE
    function pasteAddressDetails(data) {
        const oRange = oWorksheet.GetRange(`B${row}:F${row}`)
        if (data.error !== undefined) {
            oRange.SetValue([[data.error]])
        } else {
            oRange.SetValue([
                [data.country],
                [data.county],
                [data.city],
                [data.post_code],
                [data.full_address_line]
            ])
        }
        // Execute recursively until "Address" value is empty
        row++
        makeRequest(oWorksheet.GetRange(`A${row}:A${row}`).GetText())
    }
    
    // Sheet has to be reloaded on changes
    function reload() {
        let reload = setInterval(function(){
            Api.asc_calculate(Asc.c_oAscCalculateType.All);
        })
    }
})();
</pre>
Eseguiamo la macro e vediamo come funziona!
<div style="width: 640px;" class="wp-video">
<video class="wp-video-shortcode" id="video-61893-1" width="640" height="335" preload="metadata" controls="controls"><source type="video/webm" src="https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08124014/Geocoding.webm?_=1" /><a href="https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08124014/Geocoding.webm">https://static-blog.onlyoffice.com/wp-content/uploads/2023/06/08124014/Geocoding.webm</a></video></div>
Ora, con questa macro, puoi automatizzare la tua routine e recuperare facilmente informazioni dettagliate sull&#8217;indirizzo. Ci auguriamo che ti farà risparmiare tempo e ridurrà al minimo l&#8217;inserimento manuale dei dati. Questo è solo uno dei tanti esempi di cosa puoi fare implementando i nostri metodi API.
Ti invitiamo gentilmente a sperimentare e creare le tue macro. Non esitate a fare domande o condividere le vostre idee con noi. Siamo aperti alla collaborazione. Buona fortuna!
<div class="useful-links">
<h3>Link utili</h3>
<a href="https://www.geoapify.com/geocoding-api?utm_source=blog&amp;utm_medium=article+&amp;utm_id=geocoding_spreadsheet_macro" target="_blank" rel="noopener">API di Geocodifica Geoapify</a>
<a href="https://api.onlyoffice.com/plugin/macrosamples?utm_source=blog&amp;utm_medium=article+&amp;utm_id=geocoding_spreadsheet_macro" target="_blank" rel="noopener">ONLYOFFICE Esempi di macro</a>
<a href="https://api.onlyoffice.com/docbuilder/spreadsheetapi?utm_source=blog&amp;utm_medium=article+&amp;utm_id=geocoding_spreadsheet_macro" target="_blank" rel="noopener">API per fogli di calcolo ONLYOFFICE</a>
<a href="https://github.com/ONLYOFFICE" target="_blank" rel="noopener">ONLYOFFICE su Github</a>
<a href="https://www.youtube.com/playlist?list=PLCF48HEKMOYNBygGjr9lSw3PLpVXQ6s_t&amp;utm_source=blog&amp;utm_medium=article+&amp;utm_id=geocoding_spreadsheet_macro" target="_blank" rel="noopener">Tutorial di YouTube sulle macro di ONLYOFFICE</a>
<a href="https://www.onlyoffice.com/blog/2022/09/monitor-air-quality-data-with-onlyoffice-macro?utm_source=blog&amp;utm_medium=article+&amp;utm_id=geocoding_spreadsheet_macro" target="_blank" rel="noopener">Monitora i dati sulla qualità dell&#8217;aria con la macro ONLYOFFICE</a>
</div>

Usa la macro ONLYOFFICE per ottenere e inserire informazioni dettagliate sull’indirizzo

Post recenti

Utilizza la macro ONLYOFFICE per analizzare i dati del foglio di calcolo

Back to school 2023 con ONLYOFFICE: sconti per l’istruzione

I migliori scrittori di IA 2023