Wir führen Sie durch die Erstellung eines Makros, das auf der Grundlage der Adressdaten detaillierte Informationen abruft und diese in eine Tabellen einfügt.

Makro für detaillierte Adressinformationen| #site_title

Oft ist die Arbeit mit schlecht eingegebenen Daten eine große Herausforderung. Aber was wäre, wenn es eine Möglichkeit gäbe, dies zu automatisieren? In diesem Artikel führen wir Sie durch die Erstellung eines Makros, das auf der Grundlage der grundlegenden Adressdaten detaillierte Adressinformationen abruft und diese in eine Tabellenkalkulation einfügt.
<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>Über Geoapify Geokodierungs-API</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> Geokodierungs-API ist ein leistungsstarkes Tool, mit dem Entwickler Geokodierungsfunktionen in ihre Anwendungen und Dienste integrieren können. Geokodierung ist der Prozess der Umwandlung von Adressen oder Ortsnamen in geografische Koordinaten.
Mit der Geoapify Geokodierungs-API können Sie detaillierte Daten über Adressen abrufen, einschließlich Straßennamen, Städtenamen, Postleitzahlen, Verwaltungsregionen und mehr. Und wir planen, diese Funktion zu nutzen und in unser Makro zu integrieren.
<h2>Konzept dieses Makros</h2>
<ul>
<li>Lesen Sie die Adresse aus der angegebenen Zelle.</li>
<li>Senden Sie eine Anfrage an die Geoapify Geokodierungs-API, um die Adressdetails abzurufen.</li>
<li>Verarbeiten Sie die Antwort und erstellen Sie das Objekt Address Details.</li>
<li>Fügen Sie die Adressdetails in die Tabellenkalkulation ein.</li>
<li>Lesen Sie die nächste Adresse und wiederholen Sie den Vorgang.</li>
</ul>
<h2>Erstellung eines Makros</h2>
Zunächst deklarieren wir Variablen:
<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>
Die Variable API_KEY enthält Ihren Geoapify-API-Schlüssel. Die Variable ENDPOINT speichert den API-Endpunkt für den Geokodierungsdienst. Die Variable oWorksheet zielt auf die aktive Tabellenkalkulation ab. Und die Variable row ermöglicht die Auswahl der gewünschten Zeile.
Dann fügen wir die Funktion makeRequest hinzu, die für das Senden einer Anfrage an die API zuständig ist:
<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>
Sie verwendet die Funktion $.ajax, um eine HTTP GET-Anforderung an den Endpunkt zu stellen und die Adresse als Parameter zu übergeben.
Anschließend wandelt die Funktion addressToRequest die Adresse in ein Format um, das mit der URL kompatibel ist:
<pre class="theme:github font:monospace lang:js decode:true">function addressToRequest (address) {
        return address.replaceAll(' ', '%20').replaceAll(',', '%2C')
    }
</pre>
Wenn die API-Anforderung erfolgreich ist, wird die successFunction aufgerufen. Sie erhält die Antwort von der API als Parameter:
<pre class="theme:github font:monospace lang:js decode:true ">  function successFunction(response) {
        const data = createAddressDetailsObject(response)
        pasteAddressDetails(data)
        reload()
    }
</pre>
Dann verarbeitet die Funktion createAddressDetailsObject die Antwort. Wenn die Adresse nicht gefunden wird, wird eine Fehlermeldung zurückgegeben. Andernfalls erstellt die Funktion die 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>
Um die empfangenen Daten zu überprüfen, verwenden wir die Funktion checkMissingData. Sie ersetzt die fehlenden Felder durch einen Bindestrich:
<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>
Dann fügen wir die Daten mit der Funktion pasteAddressDetails ein. Die Funktion verwendet das oWorksheet-Objekt, um das aktive Blatt anzuvisieren und den entsprechenden Bereich auszuwählen:
<pre class="theme:github font:monospace lang:js decode:true ">function pasteAddressDetails(data) {
        const oRange = oWorksheet.GetRange(`B${row}:F${row}`)
</pre>
Wenn es eine Fehlermeldung gibt, wird sie in den Bereich eingefügt:
<pre class="theme:github font:monospace lang:js decode:true"> if (data.error !== undefined) {
            oRange.SetValue([[data.error]])
        } 
</pre>
Andernfalls werden die Adressdaten mit der Funktion SetValue in den Bereich eingefügt:
<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>
Die Funktion inkrementiert dann die Zeile und ruft rekursiv makeRequest auf, um die nächste Adresse zu verarbeiten:
<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>
Danach rufen wir die Funktion reload auf. Sie löst eine Neuberechnung der Tabellenkalkulation aus, nachdem jede Adresse verarbeitet wurde:
<pre class="theme:github font:monospace lang:js decode:true"> function reload() {
        let reload = setInterval(function(){
            Api.asc_calculate(Asc.c_oAscCalculateType.All);
        })
    }
</pre>
Der gesamte Makrocode lautet wie folgt:
<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>
Führen wir das Makro aus und sehen wir, wie es funktioniert!
<div style="width: 640px;" class="wp-video">
<video class="wp-video-shortcode" id="video-61889-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>
Mit diesem Makro können Sie nun Ihre Routine automatisieren und mühelos detaillierte Adressinformationen abrufen. Wir hoffen, dass Sie damit Zeit sparen und die manuelle Dateneingabe minimieren können. Dies ist nur eines von vielen Beispielen dafür, was Sie durch die Implementierung unserer API-Methoden erreichen können.
Wir möchten Sie ermutigen, zu experimentieren und Ihre eigenen Makros zu erstellen. Stellen Sie uns Ihre Fragen oder teilen Sie uns Ihre Ideen mit. Wir sind offen für Diskussionen und Zusammenarbeit. Viel Glück bei Ihren Versuchen!
<div class="useful-links">
<h3>Nützliche Links</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">Geoapify Geokodierungs-API</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">Beispiele von ONLYOFFICE-Makros</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">ONLYOFFICE-API für Tabellenkalkulationen</a>
<a href="https://github.com/ONLYOFFICE" target="_blank" rel="noopener">ONLYOFFICE auf 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">YouTube-Anweisungen für ONLYOFFICE-Makros</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">Überwachung der Luftqualitätsdaten mit dem ONLYOFFICE-Makro</a>
</div>

Verwenden Sie das ONLYOFFICE-Makro, um detaillierte Adressinformationen zu erhalten und einzufügen

Neuste beiträge

Zurück zur Schule 2023 mit ONLYOFFICE: Rabatte für Ausbildung

Treffen Sie ONLYOFFICE diesen Herbst: Zurück-zur-Schule-Workshops und internationale Veranstaltungen

ONLYOFFICE HackerOne-Programm: Aktualisierungen im Sommer 2023