Calculer la distance en voiture et convertir des mètres en miles

Niveau de codage: Débutant
Durée: 10 minutes
Type de projet: Fonction personnalisée et automatisation avec un menu personnalisé

Objectifs

  • Comprendre ce que fait la solution.
  • Découvrez le rôle des services Apps Script dans la solution.
  • Configurez le script.
  • Exécutez le script.

À propos de cette solution

À l'aide de fonctions personnalisées, vous pouvez calculer la distance en voiture entre deux lieux et convertir la distance en miles. Une automatisation supplémentaire fournit un menu personnalisé qui vous permet d'ajouter des instructions étape par étape de l'adresse de départ à l'adresse de fin dans une nouvelle feuille.

Capture d'écran d'un itinéraire en voiture dans une feuille de calcul.

Comment ça marche ?

Le script utilise deux fonctions personnalisées et une automatisation.

  • La fonction drivingDistance(origin, destination) utilise le service Maps pour calculer l'itinéraire en voiture entre deux lieux et renvoyer la distance entre les deux adresses, exprimée en mètres.
  • La fonction metersToMiles(meters) calcule le nombre équivalent de miles pour un nombre donné de mètres.
  • L'automatisation invite l'utilisateur à saisir la ligne d'adresses de départ et d'arrivée pour laquelle calculer l'itinéraire et ajoute l'itinéraire détaillé à une nouvelle feuille.

Services Apps Script

Cette solution utilise les services suivants:

  • Service Spreadsheet : ajoute le menu personnalisé, des données de démonstration pour tester cette solution et met en forme les nouvelles feuilles lorsque le script ajoute des itinéraires.
  • Service de base : utilise la classe Browser pour inviter l'utilisateur à saisir un numéro de ligne pour l'itinéraire et l'avertir en cas d'erreur.
  • Service Utilitaires : met à jour les chaînes modélisées avec des informations spécifiées par l'utilisateur.
  • Service Maps : obtenez un itinéraire Google Maps détaillé de l'adresse de départ à l'adresse d'arrivée.

Prérequis

Pour utiliser cet exemple, vous devez remplir les conditions préalables suivantes:

  • Un compte Google (les comptes Google Workspace peuvent nécessiter l'approbation d'un administrateur)
  • Un navigateur Web avec accès à Internet.

Configurer le script

  1. Créez une copie de la feuille de calcul Calculer la distance en voiture et convertir des mètres en miles. Le projet Apps Script correspondant à cette solution est joint à la feuille de calcul.
    Créer une copie
  2. Pour ajouter des en-têtes et des données de démonstration à votre feuille, cliquez sur Itinéraires > Préparer la feuille. Vous devrez peut-être actualiser la page pour que ce menu personnalisé s'affiche.
  3. Lorsque vous y êtes invité, autorisez le script. Si l'écran de consentement OAuth affiche l'avertissement Cette application n'est pas validée, continuez en sélectionnant Paramètres avancés > Accéder à {Project Name} (non sécurisé).

  4. Cliquez à nouveau sur Instructions > Préparer la feuille.

Exécuter le script

  1. Dans la cellule C2, saisissez la formule =DRIVINGDISTANCE(A2,B2) et appuyez sur Entrée. Si vous vous trouvez dans un emplacement qui utilise des virgules décimales, vous devrez peut-être saisir =DRIVINGDISTANCE(A2;B2) à la place.
  2. Dans la cellule D2, saisissez la formule =METERSTOMILES(C2) et appuyez sur Entrée.
  3. (Facultatif) Ajoutez des lignes supplémentaires d'adresses de départ et d'arrivée, et copiez les formules des colonnes C et D pour calculer les distances en voiture entre différents lieux.
  4. Cliquez sur Itinéraire > Générer étape par étape.
  5. Dans la boîte de dialogue, saisissez le numéro de ligne des adresses pour lesquelles vous souhaitez générer un itinéraire, puis cliquez sur OK.
  6. Examinez les instructions de navigation dans la nouvelle feuille créée par le script.

Examiner le code

Pour examiner le code Apps Script de cette solution, cliquez sur Afficher le code source ci-dessous:

Afficher le code source

Code.gs

sheets/customFunctions/customFunctions.gs
/**
 * @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;
}

Contributeurs

Cet échantillon est géré par Google avec l'aide d'Experts Google Developers.

Étapes suivantes