Dépannage

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Erreurs

En cas d'erreur, un corps de réponse d'erreur au format standard est renvoyé et le code d'état HTTP est défini sur un état d'erreur.

La réponse contient un objet avec un seul objet error doté des clés suivantes:

  • code : identique à l'état HTTP de la réponse.
  • message: brève description de l'erreur.
  • status : code d'état indiquant la nature de l'erreur.

Par exemple, l'envoi d'un paramètre placeId non valide renvoie l'erreur suivante:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

Voici les erreurs possibles :

Coder État Message Dépannage
400 INVALID_ARGUMENT La clé que vous avez fournie n'est pas valide. Votre clé API n'est pas valide ou n'a pas été incluse dans la requête. Veuillez vous assurer que vous avez inclus l'intégralité de la clé et que vous avez activé l'API pour cette clé.
400 INVALID_ARGUMENT Le paramètre ""path" contient une valeur non valide: =[" Votre demande contenait des arguments non valides. Les causes les plus probables de cette erreur sont les suivantes :
  • Un problème est survenu avec votre paramètre path.
    Veuillez vous assurer que vous avez au moins 1 point. Chaque point doit être une paire de chiffres séparés par une virgule, par exemple: 48.409114,-123.369158. Les points doivent être séparés par une barre verticale: '|'.
  • Votre demande inclut un placeId non valide.
  • Votre requête incluait à la fois placeId et path. Un seul de ces paramètres peut être spécifié pour chaque requête.

Cette erreur ne sera pas renvoyée si une propriété placeId est transmise pour une route qui n'existe plus, ou pour un lieu qui n'est plus une route.

403 PERMISSION_DENIED La demande non enregistrée a été bloquée. Veuillez vous inscrire via la Google Developers Console. La demande a été refusée pour une ou plusieurs des raisons suivantes :
  • La clé API est manquante ou incorrecte.
  • La facturation n'a pas été activée pour votre compte.
  • Une limite d'utilisation que vous avez définie a été dépassée.
  • Le mode de paiement fourni n'est plus valide (une carte de crédit est arrivée à expiration, par exemple).

Pour utiliser les produits Google Maps Platform, vous devez activer la facturation dans votre compte, et toutes les requêtes doivent inclure une clé API valide. Pour résoudre ce problème, procédez comme suit:

404 NOT_FOUND HTTPS est requis pour ce service. Assurez-vous d'envoyer les requêtes à https://roads.googleapis.com/, et non à http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED La requête a été limitée, car le nombre maximal de requêtes pour le projet a été atteint. Vous avez dépassé la limite de requêtes que vous avez configurée dans la console Google Cloud Platform. Cette limite est généralement définie sur le nombre de requêtes par jour, le nombre de requêtes pour 100 secondes et le nombre de requêtes pour 100 secondes par utilisateur. Cette limite doit être configurée pour empêcher un ou plusieurs groupes d'utilisateurs d'épuiser votre quota quotidien, tout en permettant un accès raisonnable à tous les utilisateurs. Consultez la section Limiter l'utilisation des API pour configurer ces limites.

Intervalle exponentiel entre les tentatives

En cas d'échec des requêtes, assurez-vous de relancer les requêtes avec un intervalle exponentiel entre les tentatives. Par exemple, si une requête échoue une fois, réessayez après une seconde. Si elle échoue à nouveau, réessayez après deux secondes, puis quatre secondes, etc. Cela garantit que les requêtes défaillantes ou les échecs à grande échelle n'inondent pas les serveurs de Google, car de nombreux clients tentent de relancer les requêtes très rapidement.

Questions fréquentes sur le dépannage

Problèmes d'implémentation

À quelle fréquence dois-je échantillonner la position de mon véhicule ?
Toutes les 1 à 10 secondes sont recommandées pour obtenir des résultats instantanés de haute qualité.
Le nombre de points que je peux envoyer par requête est-il limité ?
Oui. Une requête ne peut pas comporter plus de 100 points.
Quel niveau de précision dois-je utiliser pour stocker mes paires de latitude/longitude ancrées ?
Pour vous assurer que les chemins d'ancrage suivent les routes à tous les niveaux de zoom, même au niveau de zoom maximal, vous devez stocker vos paires latitude/longitude ancrées à 7 décimales.
Puis-je utiliser des polylignes encodées pour afficher des tracés ancrés ?
Les polylignes encodées ne sont spécifiées qu'avec une précision de 5 décimales, ce qui génère une erreur d'environ 2 mètres. Les polylignes encodées ne sont donc pas adaptées si vous souhaitez que vos tracés alignés suivent la route à des niveaux de zoom élevés.

Problèmes courants

Certains points ne sont pas ancrés ou les chemins d'ancrage ne sont pas renseignés. Comment puis-je corriger cela ?
  • Si vous échantillonnez vos points à intervalles réguliers, assurez-vous qu'ils sont échantillonnés à des intervalles plus courts (toutes les 1 à 10 secondes). Si un intervalle plus long est utilisé (par exemple, 60 secondes), l'algorithme de suivi du tracé de la route risque de ne pas pouvoir déterminer les routes empruntées avec une précision suffisante.
  • Si vous cliquez manuellement sur une carte pour créer des points, il est très facile de créer des trajets avec peu de points ou des points creux que l'algorithme d'ancrage ne gère pas correctement. L'algorithme d'ancrage fonctionne mieux pour les points proches les uns des autres. Essayez la démonstration Snap to Roads ou utilisez l'inspecteur de routes pour tester vos chemins.
Pourquoi mes chemins balisés sont-ils décalés ou légèrement en dehors de la route lorsque je fais un zoom avant ?
  • Est-ce que vous tronquez la précision des paires latitude/longitude tracées avant de les afficher ? Le stockage de paires latitude/longitude ancrées avec une précision inférieure à 7 chiffres après la virgule entraîne des erreurs de précision lorsque le tracé coupé est affiché sur la carte.
  • Utilisez-vous des polylignes encodées ? Les polylignes encodées tronquent les paires latitude/longitude à cinq décimales, ce qui génère une erreur de plusieurs mètres, ce qui génère des lignes irrégulières ou légèrement décalées par rapport à la route à des niveaux de zoom élevés.

Si aucun des cas ci-dessus ne se produit, les tuiles de carte ont peut-être été récemment mises à jour, ce qui les a désynchronisées avec l'index de route utilisé pour l'ancrage. Si seules quelques-unes de vos requêtes sont concernées, cela est probablement la cause de ce problème. Étant donné que Google Maps est mis à jour régulièrement, cette situation peut se produire de temps à autre. Cette situation peut se produire plus souvent si vous consultez régulièrement d'anciens chemins sur une carte (par exemple, les chemins tracés il y a plusieurs semaines). Pour une visualisation optimale, vous devez ancrer les anciens chemins juste avant de les afficher sur une carte, afin de minimiser les incohérences entre les tuiles de la carte et l'index de route utilisé pour l'ancrage.

Pour quelle raison la limitation de vitesse de la route X peut-elle ne pas s'afficher correctement ?
Les limites de vitesse proviennent de plusieurs sources qui varient en termes de précision et de couverture. Si vous identifiez un schéma (par exemple, les limitations de vitesse pour un type de route spécifique ou une zone spécifique qui est régulièrement incorrecte), veuillez nous en informer en procédant comme suit :
  1. Ouvrez Google Maps sur votre ordinateur OU dans l'application Google Maps pour Android.
  2. Ouvrez le menu de gauche.
  3. Sélectionnez Envoyer des commentaires. Remarque: Vous serez peut-être invité à vous connecter.
  4. Sélectionnez Modifier la carte.
  5. Sélectionnez la section de route que vous souhaitez modifier.
  6. Sélectionnez Suivant.
  7. Dans le champ "Autre", indiquez que la limitation de vitesse est incorrecte pour cette route.
  8. Sélectionnez Envoyer.
Vous pouvez également signaler d'autres problèmes ici (par exemple, si le nom de la route est incorrect, si elle est mal tracée, si elle est fermée ou si elle est privée).
Pourquoi mon trajet accroché coupe-t-il des angles au lieu de suivre la route ?
Pour résoudre ce problème, vérifiez les points suivants :
  • Assurez-vous que le paramètre interpolate est défini sur true.
  • Vérifiez que vos points de données d'origine sont échantillonnés à intervalles suffisamment proches (toutes les 1 à 10 secondes).
Pourquoi est-ce que beaucoup de segments de route sont renvoyés dans le tracé tracé pour une route sans changement de limitation de vitesse ?
Lorsque le paramètre interpolate est défini sur true, la requête de suivi de la route renvoie une polyligne qui suit les angles, les courbes et les ronds-points. Si les courbes de la route sont renvoyées, plusieurs segments de route sont renvoyés même si la limitation de vitesse ne change pas, afin de créer une polyligne qui suit de près la géométrie de la route.