Bonnes pratiques concernant l'API Isochrones

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 : résolution. Contrôle la taille des cellules de grille sous-jacentes (cellules S2) utilisées pour calculer la zone accessible.
  • LOW: utilise des cellules de grille plus grandes. Idéal pour couvrir de grandes zones sans espaces vides, ce qui donne 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" lorsque le réseau routier est clairsemé.
  • Par défaut : si aucune valeur n'est spécifiée, le service sélectionne dynamiquement la fidélité en fonction de la durée du trajet demandée.

Conseil : Réduire les trous dans les polygones
Étant donné que les isochrones calculent l'accessibilité à l'aide du réseau routier réel, les zones où les routes sont clairsemées, comme les grands parcs, les zones privées non cartographiées ou les zones industrielles, peuvent naturellement apparaître comme des "trous" inaccessibles à l'intérieur du polygone généré. Si votre cas d'utilisation nécessite une zone de couverture solide et généralisée sans ces espaces vides, définissez explicitement polygon_fidelity sur MEDIUM ou LOW.

• enable_smoothing : esthétique. Détermine si les arêtes vives des cellules de grille définies par la fidélité sont arrondies.
  • false (brut) : renvoie le calcul géométrique exact. Les arêtes apparaissent irrégulières ou en escalier, reflétant les cellules de grille. Idéal pour la précision analytique, comme les tests stricts de point dans un polygone.
  • true (lissé) : applique un algorithme de post-traitement pour arrondir les angles. Idéal pour l'affichage visuel sur les cartes.

Interaction : la fidélité définit le niveau de détail de référence sur lequel l'algorithme de lissage agit.

• Fidélité élevée + lissage : produit une forme détaillée d'aspect naturel qui suit de près les extrémités des routes.
• Fidélité faible + lissage : produit une forme de "tâche" large et généralisée.

Taille de la charge utile et affichage

Les isochrones volumineuses peuvent contenir des milliers de coordonnées, et les charges utiles peuvent être comprises entre 300 et 500 kilo-octets.

• Bande passante : sachez que la taille de la réponse JSON est importante pour les requêtes de durée maximale.
• Affichage : l'affichage de polygones extrêmement détaillés a un impact sur les performances. Envisagez d'utiliser le paramètre enable_smoothing ou des bibliothèques de simplification côté client pour réduire le nombre de sommets à afficher.

Gestion des exceptions

Implémentez une logique de nouvelle tentative avec un intervalle exponentiel entre les tentatives pour les erreurs de serveur 5xx. Toutefois, n'effectuez pas de nouvelle tentative pour les erreurs client 4xx sans modifier vos paramètres :

• INVALID_ARGUMENT (400): vérifiez que votre durée est positive et qu'elle respecte la limite du mode sélectionné, qui est d'au maximum 3 600 secondes pour le mode DRIVE ou de 7 200 secondes pour les autres modes.
• NOT_FOUND (404) : le point d'origine n'a pas pu s'aligner sur une route. Essayez de rapprocher la coordonnée d'une rue connue ou assurez-vous que la région est prise en charge.