Concepts clés

Pour générer une isochrone, fournissez à l'API une origine, un mode de transport tel que la voiture, le vélo ou la marche, et une limite de temps. Vous pouvez également ajuster les préférences de routage et l'apparence visuelle du polygone obtenu.

Horizon temporel

La contrainte principale que vous fournissez au service est travel_duration. Cela définit l'horizon temporel du calcul.

  • Durée maximale : l'API accepte une durée de trajet maximale de 3 600 secondes (1 heure) pour le mode DRIVE et de 7 200 secondes (2 heures) pour les modes WALK et BICYCLE.
  • Performances : le temps de calcul est proportionnel à la durée demandée et au mode de déplacement sélectionné. Un isochrone de conduite d'une heure couvre une zone géographique et un réseau routier beaucoup plus vastes qu'un isochrone de marche d'une heure, ce qui entraîne une latence plus élevée pour la requête de conduite.

Points d'origine et accrochage aux routes

Vous pouvez spécifier le point de départ de l'isochrone de deux manières :

  • Coordonnées : paire de latitude et de longitude (location).
  • ID de lieu : identifiant unique d'un lieu spécifique sur Google Maps (place). Lorsque vous fournissez un ID de lieu, le service utilise le centroïde de ce lieu comme point d'origine. Notez que l'API attend le format du nom de la ressource, tel que places/ChIJ.... Pour en savoir plus sur les ID de lieu, consultez ID de lieu.

Quelle que soit la méthode d'entrée, l'API ne calcule pas les temps de trajet à partir du point physique exact si ce point ne se trouve pas sur une route, par exemple à l'intérieur d'un parc ou d'un bâtiment. Pour gérer cette situation, le service utilise l'accrochage aux routes. L'accrochage à la route présente les caractéristiques suivantes :

  • Alignement intelligent : le service tente d'aligner votre point de départ sur le segment de route praticable le plus proche.
  • Conscience du mode : la logique d'accrochage tient compte de votre travel_mode. Si vous demandez DRIVE, l'API ignore les chemins réservés aux piétons et recherche la rue carrossable la plus proche. Si vous demandez WALK, l'API privilégie les chemins et les trottoirs praticables à pied.
  • Cas d'échec : si l'API ne trouve pas de segment de route approprié à environ 100 mètres de votre point de départ, elle renvoie une erreur 404 NOT_FOUND. Cela indique généralement que le point est trop éloigné du réseau routier ou qu'il se trouve dans une zone où les données cartographiques ne sont pas compatibles avec le mode de déplacement demandé.

Sensibilisation au trafic

Contrôlez l'influence des données de trafic sur le polygone généré à l'aide du paramètre routing_preference :

  • TRAFFIC_UNAWARE (par défaut) : utilise les limitations de vitesse et la hiérarchie des routes pour générer le polygone isochrone. Cela produit une forme déterministe qui ne fluctue pas en fonction de l'heure de la journée. Ce paramètre est idéal pour l'analyse générale ou la planification de scénarios de référence.
  • TRAFFIC_AWARE : calcule les isochrones en utilisant les conditions de trafic en temps réel ou prédictives au moment de la requête. La zone accessible se réduit en cas d'embouteillages et s'étend en dehors des heures de pointe.

Lissage et fidélité

Vous pouvez personnaliser l'apparence et la précision des polygones de sortie à l'aide des paramètres polygon_fidelity et enable_smoothing. Bien que ces options soient indépendantes, elles fonctionnent ensemble pour déterminer la forme finale.

  • polygon_fidelity : contrôle la taille des cellules de grille sous-jacentes utilisées pour calculer la zone accessible.

    • LOW : utilise des cellules de grille plus grandes. Idéal pour couvrir de grandes zones sans lacunes, ce qui permet d'obtenir une forme généralisée.
    • MEDIUM : précision équilibrée.
    • HIGH : utilise des cellules de grille plus petites. Permet un ajustement plus précis au réseau routier, mais peut produire des zones vides ou des trous si le réseau routier est clairsemé.
    • POLYGON_FIDELITY_UNSPECIFIED : si elle n'est pas spécifiée, le service sélectionne dynamiquement la fidélité en fonction de la durée du trajet demandée.
      Fidélité élevée, moyenne et faible des polygones
      Fidélité élevée, moyenne et faible des polygones

  • enable_smoothing : contrôle si les bords nets des cellules de la grille définies par la fidélité sont arrondis.

    • false (brut) : valeur par défaut. Renvoie le calcul géométrique exact. Les bords semblent irréguliers ou en escalier. Idéal pour la précision analytique, comme les tests stricts point dans polygone. Latence inférieure à celle de la version lissée.
    • true (lissé) : applique un algorithme de post-traitement pour arrondir les angles. Idéal pour l'affichage visuel sur les cartes.
      Isochrone avec et sans lissage
      Isochrone avec et sans lissage