En este artículo te ayudaremos a crear una macro de ONLYOFFICE que recupere información detallada sobre la dirección y la inserte en una hoja de cálculo.

Macro de ONLYOFFICE para obtener información de la dirección

A menudo trabajar con datos mal introducidos puede ser un gran problema. Pero, ¿y si hubiera una forma de automatizar esta tarea? En este artículo te ayudaremos a crear una macro que recupere información detallada sobre la dirección a partir de los datos básicos de la dirección y la inserte en una hoja de cálculo.
<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="Utiliza la macro de ONLYOFFICE para obtener e insertar información detallada sobre la dirección" 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>Acerca de la API de geocodificación de Geoapify</h2>
La API de geocodificación de <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> es una potente herramienta que permite a los desarrolladores integrar funciones de geocodificación en sus aplicaciones y servicios. La geocodificación es el proceso de convertir direcciones o nombres de lugares en coordenadas geográficas.
Con la API de geocodificación de Geoapify, es posible recuperar datos detallados sobre direcciones, incluidos nombres de calles, nombres de ciudades, códigos postales, regiones administrativas, etc. Y tenemos previsto aprovechar esta función e integrarla en nuestra macro.
<h2>Concepto de la macro</h2>
<ul>
<li>Leer la dirección de la celda especificada.</li>
<li>Enviar una solicitud a la API de geocodificación de Geoapify para obtener los detalles de la dirección.</li>
<li>Procesar la respuesta y crear el objeto Detalles de la dirección.</li>
<li>Pegar los detalles de la dirección en la hoja de cálculo.</li>
<li>Leer la siguiente dirección y repetir el proceso.</li>
</ul>
<h2>Creación de la macro</h2>
En primer lugar, declaramos las variables:
<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 variable API_KEY contiene tu clave de la API de Geoapify. La variable ENDPOINT almacena el punto final de la API para el servicio de geocodificación. La variable oWorksheet se refiere a la hoja de cálculo activa. Y la variable row permite seleccionar la fila deseada.
A continuación añadimos la función makeRequest que se encarga de enviar una solicitud a la 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>
Utiliza la función $.ajax para realizar una solicitud HTTP GET al endpoint, pasando la dirección como parámetro.
A continuación, la función addressToRequest transforma la dirección en un formato compatible con la URL:
<pre class="theme:github font:monospace lang:js decode:true ">function addressToRequest (address) {
        return address.replaceAll(' ', '%20').replaceAll(',', '%2C')
    }
</pre>
Si la solicitud a la API tiene éxito, se llama a la función successFunction. Recibe la respuesta de la API como parámetro:
<pre class="theme:github font:monospace lang:js decode:true ">  function successFunction(response) {
        const data = createAddressDetailsObject(response)
        pasteAddressDetails(data)
        reload()
    }
</pre>
A continuación, la función createAddressDetailsObject procesa la respuesta. Si no se encuentra la dirección, se devuelve un mensaje de error. En caso contrario, la función crea el objeto Detalles de la dirección:
<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>
Para comprobar los datos recibidos, utilizamos la función checkMissingData. Sustituye los campos que faltan por un guion:
<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>
A continuación, pegamos los datos con la función pasteAddressDetails. La función utiliza el objeto oWorksheet para localizar la hoja activa y seleccionar el rango apropiado:
<pre class="theme:github font:monospace lang:js decode:true ">function pasteAddressDetails(data) {
        const oRange = oWorksheet.GetRange(`B${row}:F${row}`)
</pre>
Si hay un mensaje de error, se pega en el rango:
<pre class="theme:github font:monospace lang:js decode:true "> if (data.error !== undefined) {
            oRange.SetValue([[data.error]])
        } 
</pre>
De lo contrario, los detalles de la dirección se rellenan en el rango utilizando la función 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>
A continuación, la función incrementa la fila y llama recursivamente a makeRequest para procesar la siguiente dirección:
<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>
Después, invocamos la función de recarga. Ésta provoca un nuevo cálculo de la hoja de cálculo después de procesar cada dirección:
<pre class="theme:github font:monospace lang:js decode:true "> function reload() {
        let reload = setInterval(function(){
            Api.asc_calculate(Asc.c_oAscCalculateType.All);
        })
    }
</pre>
El código completo de la macro es el siguiente:
<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>
Vamos a ejecutar la macro y ver cómo funciona:
<div style="width: 640px;" class="wp-video">
<video class="wp-video-shortcode" id="video-61884-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>
Ahora, con esta macro, puedes automatizar tu rutina y recuperar información detallada de direcciones sin esfuerzo. Esperamos que te ahorre tiempo y minimice la introducción manual de datos. Este es solo uno de los muchos ejemplos de lo que puedes hacer implementando nuestros métodos de la API.
Te animamos a que experimentes y crees tus propias macros. No dudes en hacernos preguntas o compartir tus ideas con nosotros. Estamos abiertos al debate y la cooperación. Te deseamos mucha suerte en tus exploraciones.
<div class="useful-links">
<h3>Enlaces útiles</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 de geocodificación de 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">Ejemplos de macros de ONLYOFFICE</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 de hojas de cálculo de ONLYOFFICE</a>
<a href="https://github.com/ONLYOFFICE" target="_blank" rel="noopener">ONLYOFFICE en 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 en YouTube sobre macros 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">Controla los datos de calificación del aire con la macro de ONLYOFFICE</a>
</div>

Utiliza la macro de ONLYOFFICE para obtener e insertar información detallada sobre la dirección

Entradas recientes

Los mejores generadores de textos con IA en 2023

ONLYOFFICE este otoño: webinars sobre la vuelta al cole y eventos internacionales

Resumen de los eventos de ONLYOFFICE: el verano de 2023