Concepts clés

Pour générer un isochrone, fournissez à l'API un point de départ, un mode de transport (voiture, deux-roues, vélo ou marche) et une limite de temps. Vous pouvez également ajuster les préférences d'itinéraire et l'apparence visuelle du polygone obtenu.

Modes de transport

Utilisez le paramètre obligatoire travelMode (travel_mode) pour spécifier le mode de transport :

•  : calcule l'accessibilité d'une voiture de tourisme sur les routes carrossables en utilisant les limitations de vitesse affichées, la hiérarchie des routes, les pénalités de virage et, éventuellement, les conditions de circulation en temps réel.DRIVE
• TWO_WHEELER : calcule l'accessibilité pour un véhicule motorisé à deux roues (comme une moto ou un scooter) en utilisant des règles d'accès routier spécifiques au mode et des vitesses modélisées inférieures à DRIVE sur les routes à grande vitesse. Par conséquent, un isochrone de TWO_WHEELER couvre généralement une zone plus grande que BICYCLE, mais plus petite que DRIVE le long des autoroutes à grande vitesse.
• BICYCLE : calcule l'accessibilité pour un cycliste sur les rues, les bandes cyclables et les voies partagées accessibles aux vélos, avec des vitesses ajustées en fonction du type de route et de la pente, à l'exclusion des autoroutes et des voies rapides à accès contrôlé.
• WALK : calcule l'accessibilité pour un piéton le long des trottoirs, des sentiers, des pistes et des rues accessibles aux piétons, avec une vitesse de marche ajustée en fonction de la pente. La traversée à pied ignore les restrictions de circulation à sens unique.

Remarque : Traversées en ferry et sur l'eau
L'API Isochrones ne traverse que les routes, les ponts, les tunnels et les chemins. Les itinéraires en ferry et les traversées en bateau sont exclus des calculs d'accessibilité pour tous les modes de transport. Les îles ou péninsules reliées uniquement par ferry n'apparaîtront pas dans l'isochrone généré, sauf si le point de départ se trouve sur cette masse terrestre.

Horizon temporel

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

• Durée minimale et maximale : la durée doit être d'au moins "1s" (1 seconde). Zéro ("0s"), les durées négatives et les durées inférieures à une seconde (comme "0.5s") renvoient une erreur 400 INVALID_ARGUMENT. L'API accepte un temps de trajet maximal de 3 600 secondes (1 heure) pour les modes DRIVE et TWO_WHEELER, et de 7 200 secondes (2 heures) pour les modes WALK et BICYCLE.
• Seuil minimal du polygone : l'API convertit les segments de route atteints en cellules de grille spatiale. Par conséquent, les durées très courtes renvoient un petit polygone couvrant les cellules de grille autour de l'origine ancrée.
• Performances : le temps de calcul dépend de la durée demandée et du mode de transport sélectionné. Une isochrone de conduite d'une heure couvre une zone géographique et un réseau routier beaucoup plus vastes qu'une isochrone de marche d'une heure, ce qui entraîne une latence plus élevée pour la requête de conduite.
• Mise en forme : l'API utilisant google.protobuf.Duration, la durée doit être mise en forme sous la forme d'une chaîne se terminant par un "s" (par exemple, "3600s") plutôt que par un entier.

Points d'origine et alignement sur la route

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

• Coordonnées (location) : paire de latitude et de longitude. Indiquez à la fois latitude (en [-90, 90]) et longitude (en [-180, 180]). Si vous omettez l'un d'eux, l'API le traite comme 0.0, ce qui place le point sur l'équateur ou le méridien de Greenwich. Si vous omettez les deux ({}) ou si vous envoyez (0, 0), l'API renvoie une erreur 400 INVALID_ARGUMENT.
• ID de lieu (place) : identifiant unique d'un lieu spécifique sur Google Maps. Lorsque vous fournissez un ID de lieu, le service résout le lieu en fonction de ses coordonnées de centroïde et l'aligne sur la route la plus proche. Utilisez le format de nom de ressource commençant par places/ (par exemple, places/ChIJIQBpAG2ahYAR_6128GcTUEo). Un ID de lieu simple sans le préfixe places/ est également accepté. Pour en savoir plus sur les ID de lieu, consultez ID de lieu.

Quelle que soit la méthode de saisie, 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'alignement sur la route. L'alignement sur les routes présente les caractéristiques suivantes :

• Alignement intelligent : le service tente d'aligner votre point de départ sur le segment de route traversable le plus proche.
• Prise en compte du mode : la logique d'alignement prend en compte votre travel_mode. Si vous demandez DRIVE ou TWO_WHEELER, l'API ignore les voies piétonnes et recherche la rue carrossable la plus proche. Si vous demandez WALK, l'API donne la priorité aux chemins piétonniers et aux trottoirs.
• Cas d'échec : si l'API ne trouve pas de segment de route approprié dans la distance d'alignement maximale de votre point de départ (environ 200 mètres, ou moins pour WALK et BICYCLE), elle renvoie une erreur 404 NOT_FOUND. Les éléments géographiques de grande taille (comme les parcs, les campus ou les points de vue) peuvent avoir un centroïde d'ID de lieu plus éloigné que la distance d'alignement par rapport à la route la plus proche utilisable par le mode de transport. Dans ce cas, transmettez plutôt les coordonnées location explicites d'une entrée de route.

Sens de circulation (entrant ou sortant)

Vous pouvez calculer l'accessibilité entrante et sortante à l'aide du paramètre travelDirection (travel_direction) :

• FROM (sortant) : calcule la zone accessible depuis le point de départ dans le délai spécifié. Cela convient aux cas d'utilisation tels que les zones de livraison ou la couverture des services.
• TO (Entrant) : calcule la zone à partir de laquelle vous pouvez vous rendre au point de départ dans le délai spécifié. Cela permet de déterminer les zones de chalandise, par exemple d'où les employés peuvent se déplacer pour se rendre à un bureau central.

Remarque : Les isochrones FROM et TO pour un même point de départ peuvent avoir une forme et une zone différentes dans chaque mode. Pour DRIVE, TWO_WHEELER et BICYCLE, les rues à sens unique et les restrictions de changement de direction sont prises en compte. Pour DRIVE et TWO_WHEELER, les bretelles d'autoroute à chaussées séparées et les embouteillages directionnels contribuent également à ce problème. Pour WALK et BICYCLE, la pente est également importante, car les déplacements en montée sont plus lents qu'en descente. Par conséquent, les polygones WALK ne sont presque identiques que sur un terrain plat.

Sensibilisation au trafic

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

• TRAFFIC_UNAWARE (par défaut) : utilise les limites de vitesse en circulation fluide 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 fonction des conditions de circulation en temps réel au moment exact où la requête est traitée (les codes temporels de départ ou d'arrivée personnalisés, futurs ou historiques, ne sont pas configurables dans la version 1). La zone accessible se réduit donc en cas d'embouteillages et s'étend pendant les heures creuses. En cas de circulation fluide ou pendant les heures creuses, TRAFFIC_AWARE et TRAFFIC_UNAWARE peuvent renvoyer des polygones presque identiques. Remarque : Le routage prenant en compte le trafic n'est possible que lorsque travelMode est défini sur DRIVE ou TWO_WHEELER.

Remarque : Les isochrones tenant compte du trafic nécessitent de récupérer les vitesses de circulation en temps réel et présentent une latence plus élevée que les isochrones ne tenant pas compte du trafic.

Lissage et fidélité

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

• polygonFidelity : contrôle la résolution des cellules de la grille spatiale utilisée pour estimer la limite accessible :

  • LOW : utilise les cellules de grille les plus grandes (plusieurs centaines de mètres de diamètre). Idéal pour couvrir de grandes zones avec moins de sommets et sans espaces internes, ce qui donne une forme généralisée qui peut surestimer la zone accessible le long de couloirs routiers étroits.
  • MEDIUM : précision et nombre de sommets équilibrés.
  • HIGH : utilise les cellules de grille les plus petites (environ 100 à 150 mètres de diamètre). Permet d'obtenir un ajustement plus précis au réseau routier atteint, mais peut produire des trous intérieurs là où le réseau routier est clairsemé.
  • POLYGON_FIDELITY_UNSPECIFIED : si ce paramètre n'est pas spécifié, le service sélectionne automatiquement la résolution en fonction du mode de transport et de la durée, en utilisant des cellules plus fines pour les durées courtes et pour WALK, et des cellules plus grossières pour les durées longues. Pour comparer des isochrones sur différentes durées ou modes de transport, définissez explicitement polygonFidelity.

    

    Fidélité élevée, moyenne et faible des polygones

• enableSmoothing : détermine si les bords en escalier des cellules de la grille définies par la fidélité sont arrondis.

  • false (brut) : valeur par défaut. Renvoie la limite alignée sur la grille. Les bords apparaissent en escalier le long des cellules de la grille. Idéal pour la précision analytique, comme les tests stricts de point dans un polygone.
  • true (Lissé) : arrondit les angles vifs pour l'affichage visuel de la carte tout en préservant approximativement la zone de chaque anneau. La limite ne suit plus les cellules de la grille.

    

    Isochrone avec et sans lissage