Usa la macro ONLYOFFICE per ottenere e inserire informazioni dettagliate sull’indirizzo
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’indirizzo in base ai dati dell’indirizzo e li inserisce in un foglio di calcolo.
Informazioni sull’API di Geoapify Geocoding
Geoapify 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’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.
Concetto di macro
- Legge l’indirizzo dalla cella specificata.
- Invia una richiesta all’API Geoapify Geocoding per recuperare i dettagli dell’indirizzo.
- Elabora la risposta e crea l’oggetto Dettagli indirizzo.
- Incolla i dettagli dell’indirizzo nel foglio di lavoro.
- Legge l’indirizzo successivo e ripeti il processo.
Costruire la macro
Innanzitutto, segniamo le variabili:
const API_KEY = 'your_API_key'
const ENDPOINT = 'https://api.geoapify.com/v1/geocode/search'
const oWorksheet = Api.GetActiveSheet()
let row = 2
La variabile API_KEY contiene la chiave API Geoapify. La variabile ENDPOINT memorizza l’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’invio di una richiesta all’API:
makeRequest(oWorksheet.GetRange(`A${row}`).GetText())
// REQUEST
function makeRequest(ADDRESS) {
if (ADDRESS === '') return
$.ajax({
url: `${ENDPOINT}?text=${addressToRequest(ADDRESS)}&apiKey=${API_KEY}`,
dataType: 'json',
}).done(successFunction)
}
Utilizza la funzione $.ajax per effettuare una richiesta HTTP GET all’endpoint, passando l’indirizzo come parametro.
Quindi la funzione addressToRequest trasforma l’indirizzo in un formato compatibile con l’URL:
function addressToRequest (address) {
return address.replaceAll(' ', '%20').replaceAll(',', '%2C')
}
Se la richiesta API ha esito positivo, viene chiamata successFunction. Riceve la risposta dall’API come parametro:
function successFunction(response) {
const data = createAddressDetailsObject(response)
pasteAddressDetails(data)
reload()
}
Quindi la funzione createAddressDetailsObject elabora la risposta. Se l’indirizzo non viene trovato, viene restituito un messaggio di errore. In caso contrario, la funzione crea l’oggetto Dettagli indirizzo:
// 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
}
Per controllare i dati ricevuti, utilizziamo la funzione checkMissingData. Sostituisce i campi mancanti con un trattino:
function checkMissingData(data) {
Object.keys(data).forEach(key => {
if(data[key] === undefined) data[key] = '-'
})
return data
}
Quindi incolliamo i dati con la funzione pasteAddressDetails. La funzione utilizza l’oggetto oWorksheet per indirizzare il foglio attivo e selezionare l’intervallo appropriato:
function pasteAddressDetails(data) {
const oRange = oWorksheet.GetRange(`B${row}:F${row}`)
Se è presente un messaggio di errore, viene incollato nell’intervallo:
if (data.error !== undefined) {
oRange.SetValue([[data.error]])
}
In caso contrario, i dettagli dell’indirizzo vengono popolati nell’intervallo utilizzando la funzione SetValue:
else {
oRange.SetValue([
[data.country],
[data.county],
[data.city],
[data.post_code],
[data.full_address_line]
])
}La funzione quindi incrementa la riga e chiama in modo ricorsivo makeRequest per elaborare l’indirizzo successivo:
// Execute recursively until "Address" value is empty
row++
makeRequest(oWorksheet.GetRange(`A${row}:A${row}`).GetText())
}
Successivamente, invochiamo la funzione di ricarica. Attiva un ricalcolo del foglio di calcolo dopo l’elaborazione di ciascun indirizzo:
function reload() {
let reload = setInterval(function(){
Api.asc_calculate(Asc.c_oAscCalculateType.All);
})
}
L’intero codice della macro è il seguente:
(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)}&apiKey=${API_KEY}`,
dataType: 'json',
}).done(successFunction)
}
// London, United Kingdom -> 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 => {
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);
})
}
})();
Eseguiamo la macro e vediamo come funziona!
Ora, con questa macro, puoi automatizzare la tua routine e recuperare facilmente informazioni dettagliate sull’indirizzo. Ci auguriamo che ti farà risparmiare tempo e ridurrà al minimo l’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!
