L'API Directions (ancienne) est un service Web qui calcule des itinéraires entre des lieux en voiture, à pied, à vélo et en transports en commun, y compris des itinéraires en plusieurs parties avec des points de cheminement, et renvoie des itinéraires, des étapes et des instructions au format JSON ou XML. Elle est en état "Ancienne" : à partir d'octobre 2026, elle ne pourra plus être activée pour les nouveaux projets Google Cloud. Migrez vers l'API Routes.
API Directions : informations clés
- Produit : API Directions
- Également appelée : API Directions (ancienne version)
- Catégorie : Routes
- Plate-forme : service Web (REST)
- S'exécute sur : le serveur (code backend)
- Étape de lancement : GA
- Cycle de vie : Ancien
- Remplacée par : l'API Routes
- Présentation : Présentation de l'API Directions
- Disponibilité régionale : monde entier. La couverture varie selon la région et le mode de transport (les transports en commun dépendent des données des fournisseurs de transports en commun). (détails de la couverture)
API Directions : quand l'utiliser ?
Utilisez l'API Directions dans les cas suivants :
- Vous gérez un projet Google Cloud existant pour lequel l'API Directions (ancienne version) est déjà activée et qui appelle
maps/api/directions. - Vous avez besoin d'itinéraires côté serveur en voiture, à pied, à vélo ou en transports en commun (points de cheminement pour les modes autres que les transports en commun uniquement), au format JSON ou XML, dans un projet existant.
Quand ne pas utiliser l'API Directions :
- Vous démarrez un nouveau projet Google Cloud. À partir d'octobre 2026, l'API Directions (ancienne version) ne pourra plus être activée pour les nouveaux projets. Utilisez plutôt l'API Routes.
- Vous avez besoin de nouvelles fonctionnalités de routage et de meilleures performances. Utilisez plutôt l'API Routes.
- Vous avez besoin des temps de trajet et des distances pour de nombreux points de départ et destinations dans une seule requête. Utilisez plutôt l'API Routes.
API Directions : configuration
- Service à activer :
directions-backend.googleapis.com - Authentification : clé API
- Premiers pas : Configurer l'API Directions
- Référence : Documentation de référence de l'API Directions
- Tarification : utilisation et facturation de l'API Directions
- Règles : Règles de l'API Directions
- Notes de version : Notes de version de l'API Directions
API Directions : erreurs courantes
- Problème : Les requêtes adressées à l'API Directions (ancienne version) à partir d'un projet dans lequel l'ancienne API n'est pas activée échouent avec l'erreur
LegacyApiNotActivatedMapError. Correction : Si vous êtes propriétaire de l'application, migrez vers l'API Routes. En tant que solution à court terme pendant que vous migrez ou attendez une mise à jour d'application, vous pouvez activer l'ancienne API en remplissant le formulaire d'activation de l'ancienne API. Consultez /maps/legacy. - Problème : l'utilisation du préfixe
via:sur les points de cheminement en fait des points de passage stricts, ce qui peut entraîner des détours importants ou un étatZERO_RESULTS. Solution : Utilisez des points de cheminement d'arrêt (sans préfixevia:), sauf si un point de passage strict est requis. Consultez /maps/documentation/directions/get-directions. - Problème : Les requêtes comportant de 11 à 25 points de cheminement,
optimize:true, des durées tenant compte du trafic (duration_in_traffic) ou les modificateurs d'emplacementside_of_roadouheadingsont facturées au SKU Directions Advanced (Pro) plus élevé. Solution : N'utilisez ces fonctionnalités que lorsque vous en avez besoin. Limitez le nombre de points de cheminement à 10 ou moins, et omettezoptimize:true,departure_time(pour la conduite),side_of_roadetheadingpour rester sur le SKU Essentials. Consultez /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - Problème : Pour la conduite,
departure_timene peut pas être dans le passé (la requête échoue avecINVALID_REQUEST). Sansdeparture_time, l'itinéraire et la durée utilisent le trafic moyen indépendant du temps, et aucunduration_in_trafficn'est renvoyé. Solution : Définissezdeparture_timesurnowou sur une heure ultérieure avecmode=drivingpour obtenirduration_in_traffic. Les requêtes qui renvoientduration_in_trafficsont facturées au SKU Directions Advanced (Pro). Consultez /maps/documentation/directions/get-directions.