Questa pagina è stata tradotta dall'API Cloud Translation.

Calcola la distanza per auto e converti i metri in miglia

Livello di programmazione: Principiante
Durata: 10 minuti
Tipo di progetto: Funzione personalizzata e con un menu personalizzato

Obiettivi

Comprendi cosa fa la soluzione.
Scopri cosa fanno i servizi Apps Script all'interno soluzione.
Configura lo script.
Esegui lo script.

Informazioni su questa soluzione

Utilizzando le funzioni personalizzate, puoi calcolare la distanza percorsa tra due luoghi e converte la distanza da metri a miglia. Un'ulteriore automazione offre un menu personalizzato che ti consente di aggiungere indicazioni stradali passo passo l'indirizzo iniziale all'indirizzo finale in un nuovo foglio.

Screenshot di indicazioni stradali in un foglio.

Come funziona

Lo script utilizza due funzioni personalizzate e un'automazione.

La funzione drivingDistance(origin, destination) utilizza il servizio Maps per calcolare le indicazioni stradali tra due luoghi e restituisce la distanza tra i due indirizzi in metri.
La funzione metersToMiles(meters) calcola il numero equivalente di miglia per un determinato numero di metri.
L'automazione chiede all'utente di inserire riga di indirizzi di partenza e di arrivo per calcolare le indicazioni stradali per aggiunge le indicazioni stradali passo passo a un nuovo foglio.

Servizi Apps Script

Questa soluzione utilizza i seguenti servizi:

Servizio fogli di lavoro: aggiunge il parametro personalizzato aggiunge i dati dimostrativi per testare la soluzione e formatta i nuovi fogli quando lo script aggiunge le indicazioni stradali.
Servizio di base: utilizza la classe Browser per richiede all'utente di inserire un numero di riga per le indicazioni stradali e avvisa l'utente se si verifica un errore.
Servizio di utilità: aggiorna le stringhe basate su modelli con informazioni specificate dall'utente.
Servizio Maps: ottiene le istruzioni dettagliate di Google Maps indicazioni stradali dall'indirizzo di partenza all'indirizzo di arrivo.

Prerequisiti

Per utilizzare questo esempio, sono necessari i seguenti prerequisiti:

Un Account Google (gli account Google Workspace possono richiedono l'approvazione dell'amministratore).
Un browser web con accesso a internet.

Configurare lo script

Crea una copia del campo Calcola la distanza in auto e converti i metri in miglia in un foglio di lavoro. Il progetto Apps Script per questa soluzione è allegata al foglio di lavoro.
Crea una copia
Per aggiungere intestazioni e dati dimostrativi al foglio, fai clic su Indicazioni stradali > Prepara il foglio. Potresti dover aggiorna la pagina per visualizzare questo menu personalizzato.
Quando richiesto, autorizza lo script. Se nella schermata per il consenso OAuth viene visualizzato l'avviso Questa app non è stata verificata. continua selezionando Avanzate > Vai a {Project Name} (non sicuro).
Fai clic su Indicazioni stradali > Prepara foglio. di nuovo.

Esegui lo script

Nella cella C2, inserisci la formula =DRIVINGDISTANCE(A2,B2) e premi Invio. Se ti trovi in una località che utilizza le virgole decimali, potresti dover inserire =DRIVINGDISTANCE(A2;B2) in alternativa.
Nella cella D2, inserisci la formula =METERSTOMILES(C2) e premi Invio.
(Facoltativo) Aggiungi altre righe di indirizzi di partenza e di arrivo e copia il valore formule nelle colonne C e D per calcolare le distanze guida tra in vari luoghi.
Fai clic su Indicazioni stradali >. Genera istruzioni dettagliate.
Nella finestra di dialogo, inserisci il numero di riga degli indirizzi per i quali vuoi genera le indicazioni stradali e fai clic su OK.
Rivedi le indicazioni stradali nel nuovo foglio creato dallo script.

Esamina il codice

Per esaminare il codice Apps Script per questa soluzione, fai clic su Visualizza codice sorgente sotto:

Visualizza codice sorgente

Code.gs

sheets/customFunctions/customFunctions.gs

Visualizza su GitHub

/**
 * @OnlyCurrentDoc Limits the script to only accessing the current sheet.
 */

/**
 * A special function that runs when the spreadsheet is open, used to add a
 * custom menu to the spreadsheet.
 */
function onOpen() {
  try {
    const spreadsheet = SpreadsheetApp.getActive();
    const menuItems = [
      {name: 'Prepare sheet...', functionName: 'prepareSheet_'},
      {name: 'Generate step-by-step...', functionName: 'generateStepByStep_'}
    ];
    spreadsheet.addMenu('Directions', menuItems);
  } catch (e) {
    // TODO (Developer) - Handle Exception
    console.log('Failed with error: %s' + e.error);
  }
}

/**
 * A custom function that converts meters to miles.
 *
 * @param {Number} meters The distance in meters.
 * @return {Number} The distance in miles.
 */
function metersToMiles(meters) {
  if (typeof meters !== 'number') {
    return null;
  }
  return meters / 1000 * 0.621371;
}

/**
 * A custom function that gets the driving distance between two addresses.
 *
 * @param {String} origin The starting address.
 * @param {String} destination The ending address.
 * @return {Number} The distance in meters.
 */
function drivingDistance(origin, destination) {
  const directions = getDirections_(origin, destination);
  return directions.routes[0].legs[0].distance.value;
}

/**
 * A function that adds headers and some initial data to the spreadsheet.
 */
function prepareSheet_() {
  try {
    const sheet = SpreadsheetApp.getActiveSheet().setName('Settings');
    const headers = [
      'Start Address',
      'End Address',
      'Driving Distance (meters)',
      'Driving Distance (miles)'];
    const initialData = [
      '350 5th Ave, New York, NY 10118',
      '405 Lexington Ave, New York, NY 10174'];
    sheet.getRange('A1:D1').setValues([headers]).setFontWeight('bold');
    sheet.getRange('A2:B2').setValues([initialData]);
    sheet.setFrozenRows(1);
    sheet.autoResizeColumns(1, 4);
  } catch (e) {
    // TODO (Developer) - Handle Exception
    console.log('Failed with error: %s' + e.error);
  }
}

/**
 * Creates a new sheet containing step-by-step directions between the two
 * addresses on the "Settings" sheet that the user selected.
 */
function generateStepByStep_() {
  try {
    const spreadsheet = SpreadsheetApp.getActive();
    const settingsSheet = spreadsheet.getSheetByName('Settings');
    settingsSheet.activate();

    // Prompt the user for a row number.
    const selectedRow = Browser
        .inputBox('Generate step-by-step', 'Please enter the row number of' +
        ' the' + ' addresses to use' + ' (for example, "2"):',
        Browser.Buttons.OK_CANCEL);
    if (selectedRow === 'cancel') {
      return;
    }
    const rowNumber = Number(selectedRow);
    if (isNaN(rowNumber) || rowNumber < 2 ||
      rowNumber > settingsSheet.getLastRow()) {
      Browser.msgBox('Error',
          Utilities.formatString('Row "%s" is not valid.', selectedRow),
          Browser.Buttons.OK);
      return;
    }


    // Retrieve the addresses in that row.
    const row = settingsSheet.getRange(rowNumber, 1, 1, 2);
    const rowValues = row.getValues();
    const origin = rowValues[0][0];
    const destination = rowValues[0][1];
    if (!origin || !destination) {
      Browser.msgBox('Error', 'Row does not contain two addresses.',
          Browser.Buttons.OK);
      return;
    }

    // Get the raw directions information.
    const directions = getDirections_(origin, destination);

    // Create a new sheet and append the steps in the directions.
    const sheetName = 'Driving Directions for Row ' + rowNumber;
    let directionsSheet = spreadsheet.getSheetByName(sheetName);
    if (directionsSheet) {
      directionsSheet.clear();
      directionsSheet.activate();
    } else {
      directionsSheet =
        spreadsheet.insertSheet(sheetName, spreadsheet.getNumSheets());
    }
    const sheetTitle = Utilities
        .formatString('Driving Directions from %s to %s', origin, destination);
    const headers = [
      [sheetTitle, '', ''],
      ['Step', 'Distance (Meters)', 'Distance (Miles)']
    ];
    const newRows = [];
    for (const step of directions.routes[0].legs[0].steps) {
      // Remove HTML tags from the instructions.
      const instructions = step.html_instructions
          .replace(/<br>|<div.*?>/g, '\n').replace(/<.*?>/g, '');
      newRows.push([
        instructions,
        step.distance.value
      ]);
    }
    directionsSheet.getRange(1, 1, headers.length, 3).setValues(headers);
    directionsSheet.getRange(headers.length + 1, 1, newRows.length, 2)
        .setValues(newRows);
    directionsSheet.getRange(headers.length + 1, 3, newRows.length, 1)
        .setFormulaR1C1('=METERSTOMILES(R[0]C[-1])');

    // Format the new sheet.
    directionsSheet.getRange('A1:C1').merge().setBackground('#ddddee');
    directionsSheet.getRange('A1:2').setFontWeight('bold');
    directionsSheet.setColumnWidth(1, 500);
    directionsSheet.getRange('B2:C').setVerticalAlignment('top');
    directionsSheet.getRange('C2:C').setNumberFormat('0.00');
    const stepsRange = directionsSheet.getDataRange()
        .offset(2, 0, directionsSheet.getLastRow() - 2);
    setAlternatingRowBackgroundColors_(stepsRange, '#ffffff', '#eeeeee');
    directionsSheet.setFrozenRows(2);
    SpreadsheetApp.flush();
  } catch (e) {
    // TODO (Developer) - Handle Exception
    console.log('Failed with error: %s' + e.error);
  }
}

/**
 * Sets the background colors for alternating rows within the range.
 * @param {Range} range The range to change the background colors of.
 * @param {string} oddColor The color to apply to odd rows (relative to the
 *     start of the range).
 * @param {string} evenColor The color to apply to even rows (relative to the
 *     start of the range).
 */
function setAlternatingRowBackgroundColors_(range, oddColor, evenColor) {
  const backgrounds = [];
  for (let row = 1; row <= range.getNumRows(); row++) {
    const rowBackgrounds = [];
    for (let column = 1; column <= range.getNumColumns(); column++) {
      if (row % 2 === 0) {
        rowBackgrounds.push(evenColor);
      } else {
        rowBackgrounds.push(oddColor);
      }
    }
    backgrounds.push(rowBackgrounds);
  }
  range.setBackgrounds(backgrounds);
}

/**
 * A shared helper function used to obtain the full set of directions
 * information between two addresses. Uses the Apps Script Maps Service.
 *
 * @param {String} origin The starting address.
 * @param {String} destination The ending address.
 * @return {Object} The directions response object.
 */
function getDirections_(origin, destination) {
  const directionFinder = Maps.newDirectionFinder();
  directionFinder.setOrigin(origin);
  directionFinder.setDestination(destination);
  const directions = directionFinder.getDirections();
  if (directions.status !== 'OK') {
    throw directions.error_message;
  }
  return directions;
}

Collaboratori

Questo campione è gestito da Google con l'aiuto degli Esperti Google Developers.