Script créé par Patskins avec la participation de Merguez07
Suivi, avis, suggestions et questions sur le forum eedomus
GOOGLE DISTANCE MATRIX : Principe
Le script utilise le service Google Maps Distance Matrix API. Ce service renvoie des informations qui s'appuient sur l'itinéraire recommandé entre les points de départ et les destinations, selon les calculs de Google Maps API.
Ce service ne renvoie pas d'informations détaillées sur l'itinéraire !
Pour utiliser Google Maps Distance Matrix API, vous devez d'abord activer l'API dans Google API Console et obtenir les informations d'authentification appropriées. Vous devez fournir une clé d'API dans chaque requête
Source : Google Maps Distance Matrix
LIMITATIONS
Chaque requête envoyée à Google Maps Distance Matrix API est limitée par le nombre d'éléments autorisés. Le nombre d'éléments de la requête est obtenu en multipliant le nombre de points de départ par le nombre de destinations. L'API Google Maps Distance Matrix API est soumise aux limites suivantes :
Limites d'utilisation (utilisation de l'API standard)
- 2500 éléments gratuits par jour
- 25 points de départ ou 25 destinations maximum par requête.
- 100 éléments par requête.
- 100 éléments par seconde
Exemples d'utilisations avec le script :
- 2 requêtes (2 trajets différents mais avec le même point de départ) toutes les 5 minutes donnent une moyenne d'environ 580 éléments par jour.
- 2 requêtes (2 trajets différents avec 2 points de départs / destinations différents) toutes les 5 minutes donnent une moyenne d'environ 1160 éléments par jour
INSTALLATION DU SCRIPT
Trois paramètres sont nécessaires :
- En VAR1 : La clé API Google
- En VAR2 : Le point de départ du trajet sous la forme d'une adresse ou de coordonnées de latitude/longitude *
- En VAR3 : Le point de destination du trajet sous la forme d'une adresse ou de coordonnées de latitude/longitude *
Les textes pour le départ et l'arrivée sont plus simples à saisir. Ils ne doivent pas comporter de caractères accentués (ex : saisir "8 place de l eglise, machin sur mer" pour "8 Place de l'église, Machin/Mer"
La fréquence du pooling est réglée à 5 minutes (afin de ne pas dépasser les limites d'utilisation de l'API, pensez à augmenter cette durée si vous multiplez les installations de ce script)
Après validation, création de 3 capteurs :
- Temps de trajet (en minutes) : affiche la valeur en minutes de la durée estimée du trajet
- Temps de trajet (en heures) : affiche le temps de trajet estimé en heures et minutes
- Distance : affiche la distance du trajet en km
Les temps de trajets estimés avec ce script sont les temps de trajets calculés avec les conditions de circulation au moment de la demande
SUGGESTION
En utilisant le seuil à 3 étages disponible sur le store, il est possible de créer des alertes si le temps de trajet devient anormal. Exemple :
Possibilité de paramétrer alors des alertes avec notification (SMS, push, mail...) en cas de problèmes.