Créez une macro qui récupère des informations détaillées sur les adresses à partir des données de base et les insère dans une feuille de calcul.

Macro ONLYOFFICE pour récupérer l'information sur l'adresse

Bien souvent, le fait de travailler avec des données mal saisies peut s&#8217;avérer très gênant. Existe-il un moyen d&#8217;automatiser cette tâche ? Dans cet article, nous vous guiderons dans la création d&#8217;une macro qui récupère des informations détaillées sur les adresses à partir des données de base et les insère dans une feuille de calcul.
<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" />
<h2>À propos de l&#8217;API de géocodage Geoapify</h2>
L&#8217;API de géocodage 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> est un outil puissant qui permet aux développeurs d&#8217;intégrer la fonctionnalité de géocodage dans leurs applications et services. Le géocodage consiste à convertir des adresses ou des noms de lieux en coordonnées géographiques.
Avec l&#8217;API de géocodage de Geoapify, vous pouvez récupérer des données détaillées sur les adresses, y compris les noms de rue, les noms de ville, les codes postaux, les régions administratives, etc. Nous prévoyons de tirer parti de cette fonctionnalité et de l&#8217;intégrer dans notre macro.
<h2>Concept de macro</h2>
<ul>
<li>Lire l&#8217;adresse de la cellule spécifiée.</li>
<li>Envoyer une demande à l&#8217;API de géocodage de Geoapify pour obtenir les détails de l&#8217;adresse.</li>
<li>Traiter la réponse et créer l&#8217;objet Détails de l&#8217;adresse.</li>
<li>Coller les détails de l&#8217;adresse dans la feuille de calcul.</li>
<li>Lire l&#8217;adresse suivante et répéter le processus.</li>
</ul>
<h2>Construire la macro</h2>
Tout d&#8217;abord, nous déclarons des 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 contient votre clé API Geoapify. La variable ENDPOINT contient le point de terminaison de l&#8217;API pour le service de géocodage. La variable oWorksheet cible la feuille de calcul active. La variable row permet de sélectionner la ligne souhaitée.
Nous ajoutons ensuite la fonction makeRequest qui est chargée d&#8217;envoyer une demande à l&#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>
Il utilise la fonction $.ajax pour effectuer une requête HTTP GET vers le point de terminaison, en transmettant l&#8217;adresse en tant que paramètre.
La fonction addressToRequest transforme ensuite l&#8217;adresse dans un format compatible avec l&#8217;URL :
<pre class="theme:github font:monospace lang:js decode:true ">function addressToRequest (address) {
        return address.replaceAll(' ', '%20').replaceAll(',', '%2C')
    }
</pre>
Si la demande d&#8217;API aboutit, la fonction successFunction est appelée. Elle reçoit la réponse de l&#8217;API en tant que paramètre :
<pre class="theme:github font:monospace lang:js decode:true ">  function successFunction(response) {
        const data = createAddressDetailsObject(response)
        pasteAddressDetails(data)
        reload()
    }
</pre>
La fonction createAddressDetailsObject traite ensuite la réponse. Si l&#8217;adresse n&#8217;est pas trouvée, un message d&#8217;erreur est renvoyé. Dans le cas contraire, la fonction crée l&#8217;objet Address Details :
<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>
Pour vérifier les données reçues, nous utilisons la fonction checkMissingData. Elle remplace les champs manquants par un tiret :
<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>
Nous collons ensuite les données à l&#8217;aide de la fonction pasteAddressDetails. Cette fonction utilise l&#8217;objet oWorksheet pour cibler la feuille active et sélectionner la plage appropriée :
<pre class="theme:github font:monospace lang:js decode:true ">function pasteAddressDetails(data) {
        const oRange = oWorksheet.GetRange(`B${row}:F${row}`)
</pre>
S&#8217;il y a un message d&#8217;erreur, il est collé dans la plage :
<pre class="theme:github font:monospace lang:js decode:true "> if (data.error !== undefined) {
            oRange.SetValue([[data.error]])
        } 
</pre>
Dans le cas contraire, les détails de l&#8217;adresse sont renseignés dans la plage à l&#8217;aide de la fonction 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 fonction incrémente ensuite la ligne et appelle récursivement makeRequest pour traiter l&#8217;adresse suivante :
<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>
Ensuite, nous invoquons la fonction reload. Elle déclenche un nouveau calcul de la feuille de calcul après le traitement de chaque adresse :
<pre class="theme:github font:monospace lang:js decode:true "> function reload() {
        let reload = setInterval(function(){
            Api.asc_calculate(Asc.c_oAscCalculateType.All);
        })
    }
</pre>
Le code macro complet est le suivant :
<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>
Exécutons la macro et voyons comment elle fonctionne !
<div style="width: 640px;" class="wp-video">
<video class="wp-video-shortcode" id="video-61831-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>
Désormais, grâce à cette macro, vous pouvez automatiser votre routine et récupérer sans effort des informations détaillées sur les adresses. Nous espérons qu&#8217;elle vous permettra de gagner du temps et de minimiser la saisie manuelle des données. Ce n&#8217;est qu&#8217;un exemple parmi tant d&#8217;autres de ce que vous pouvez faire en mettant en œuvre les méthodes de notre API.
Nous vous encourageons à expérimenter et à créer vos propres macros. N&#8217;hésitez pas à nous poser des questions ou à nous faire part de vos idées. Nous sommes ouverts à la discussion et à la coopération. Nous vous souhaitons bonne chance dans vos explorations !
<div class="useful-links">
<h3>Liens utiles</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 géocodage 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">Exemples de macros 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 tableur ONLYOFFICE</a>
<a href="https://github.com/ONLYOFFICE" target="_blank" rel="noopener">ONLYOFFICE sur 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">Tutoriel YouTube sur les 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">Contrôler les données de qualification de l&#8217;air avec la macro ONLYOFFICE</a>
</div>

Utilisez la macro ONLYOFFICE pour obtenir et insérer des informations détaillées sur l’adresse

Billets récents

Utilisez la macro ONLYOFFICE pour analyser les données d’une feuille de calcul

Rentrée scolaire 2023 avec ONLYOFFICE : réductions pour l’éducation

Meilleurs générateurs de texte IA en 2023