Niveau de programmation : Débutant
Durée : 10 minutes
Type de projet : Fonction personnalisée et
automatisation avec un menu personnalisé
Objectifs
- Comprendre le fonctionnement de la solution.
- Comprendre le fonctionnement des services Apps Script dans la solution.
- Configurer le script.
- Exécuter 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 de mètres en miles. Une automatisation supplémentaire fournit un menu personnalisé qui vous permet d'ajouter des instructions détaillées de l'adresse de départ à l'adresse de destination dans une nouvelle feuille.

Fonctionnement
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 en mètres. - La fonction
metersToMiles(meters)calcule le nombre de miles équivalent pour un nombre de mètres donné. - L'automatisation invite l'utilisateur à saisir la ligne d'adresses de départ et de destination pour lesquelles calculer l'itinéraire en voiture, et ajoute l'itinéraire détaillé dans une nouvelle feuille.
Services Apps Script
Cette solution utilise les services suivants :
- Service Spreadsheet : ajoute le menu personnalisé , ajoute des données de démonstration pour tester cette solution et met en forme les nouvelles feuilles lorsque le script ajoute des itinéraires en voiture.
- Service Base : utilise la classe
Browserpour inviter l'utilisateur à saisir un numéro de ligne pour les itinéraires et l'alerte en cas d'erreur. - Service Utilities : met à jour les chaînes de modèles avec les informations spécifiées par l'utilisateur.
- Service Maps : obtient des itinéraires Google Maps détaillés de l'adresse de départ à l'adresse de destination.
Prérequis
Pour utiliser cet exemple, vous devez remplir les prérequis suivants :
- Un compte Google (l'approbation de l'administrateur peut être nécessaire pour les comptes Google Workspace)
- Un navigateur Web avec accès à Internet
Configurer le script
Créez une copie de la feuille de calcul Calculate driving distance and convert meters to miles (Calculer la distance en voiture et convertir les mètres en miles). Le projet Apps Script de cette solution est joint à la feuille de calcul :
Pour ajouter des en-têtes et des données de démonstration à votre feuille, cliquez sur Directions > Prepare sheet (Itinéraires > Préparer la feuille). Vous devrez peut-être actualiser la page pour que ce menu personnalisé s'affiche.
Lorsque vous y êtes invité, autorisez les scripts. <<../_snippets/oauth.md>>
Cliquez à nouveau sur Directions > Prepare sheet (Itinéraires > Préparer la feuille).
Exécuter le script
- Dans la cellule
C2, saisissez la formule=DRIVINGDISTANCE(A2,B2)et appuyez sur Entrée. Si vous vous trouvez dans un pays où les virgules décimales sont utilisées, vous devrez peut-être saisir=DRIVINGDISTANCE(A2;B2)à la place. - Dans la cellule
D2, saisissez la formule=METERSTOMILES(C2)et appuyez sur Entrée. - (Facultatif) Ajoutez d'autres lignes d'adresses de départ et de destination, puis copiez les formules dans les colonnes
CetDpour calculer les distances en voiture entre différents lieux. - Cliquez sur Directions > Generate step-by-step (Itinéraires > Générer un itinéraire détaillé).
- 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.
- Consultez l'itinéraire en voiture 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 :
Afficher le code source
Code.gs
Contributeurs
Cet exemple est géré par Google avec l'aide de Google Developer Experts.