Dépannage

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 avec les 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 renverra l'erreur suivante :

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

Voici les erreurs possibles :

Intervalle exponentiel entre les tentatives

Lorsque des requêtes échouent, vous devez vous assurer de les relancer avec un intervalle exponentiel entre les tentatives. Par exemple, si une requête échoue une fois, réessayez au bout d'une seconde. Si elle échoue à nouveau, réessayez au bout de deux secondes, puis de quatre secondes, et ainsi de suite. Cela permet de s'assurer que les requêtes défectueuses 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 ?

 Nous vous recommandons de définir un intervalle de 1 à 10 secondes pour obtenir des résultats d'accrochage à la route de haute qualité.

Le nombre de points que je peux envoyer par requête est-il limité ?

Oui, une requête peut comporter jusqu'à 100 points.

Quel niveau de précision dois-je utiliser pour stocker mes paires latitude/longitude accrochées ?

Pour vous assurer que les chemins accrochés suivent les routes à tous les niveaux de zoom, même au niveau de zoom maximal, vous devez stocker vos paires latitude/longitude accrochées avec une précision de sept décimales.

Puis-je utiliser des polylignes encodées pour afficher des chemins ajustés ?

Les polylignes encodées ne sont spécifiées qu'avec une précision de cinq décimales, ce qui entraîne une erreur d'environ deux mètres. Les polylignes encodées ne conviennent donc pas si vous souhaitez que vos chemins ajustés suivent la route à des niveaux de zoom élevés.

Problèmes courants

Certains points ne sont pas accrochés ou des espaces vides apparaissent dans les chemins accrochés. Comment corriger ce problème ?

• Si vous échantillonnez vos points à intervalles réguliers, assurez-vous qu'ils le sont à des intervalles plus courts (toutes les 1 à 10 secondes). Si un intervalle plus long est utilisé (par exemple, 60 secondes), l'algorithme d'accrochage aux routes peut ne pas être en mesure de 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 chemins avec peu de points ou des points épars que l'algorithme d'accrochage ne gère pas bien. L'algorithme d'accrochage fonctionne mieux pour les points proches les uns des autres. Essayez la démonstration d'accrochage aux routes ou utilisez l'inspecteur de routes pour tester vos chemins.

Pourquoi mes chemins accrochés sont-ils irréguliers ou légèrement décalés par rapport à la route lorsque j'effectue un zoom avant ?

• Tronquez-vous la précision des paires latitude/longitude ajustées avant de les afficher ? Si vous stockez des paires latitude/longitude ajustées avec une précision inférieure à sept décimales, cela entraînera des erreurs de précision lorsque le tracé ajusté sera affiché sur la carte.
• Utilisez-vous des polylignes encodées ? Les polylignes encodées tronquent les paires latitude/longitude à cinq décimales, ce qui introduit une erreur de plusieurs mètres. Les lignes sont donc 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 s'applique, il est possible que les tuiles de carte aient été mises à jour récemment, ce qui les a désynchronisées de l'index routier utilisé pour l'accrochage. Si seules quelques-unes de vos requêtes sont concernées, il s'agit probablement de la cause. Comme Google Maps est régulièrement mis à jour, cela peut arriver de temps en temps. Cela peut se produire plus souvent si vous consultez régulièrement d'anciens trajets sur une carte (par exemple, des trajets qui ont été ajustés il y a plusieurs semaines). Pour une visualisation optimale, vous devez réaligner les anciens chemins juste avant de les afficher sur une carte, afin de minimiser les incohérences entre les tuiles de carte et l'index routier utilisé pour l'alignement.

Pourquoi la limitation de vitesse de la route X s'affiche-t-elle de manière incorrecte ?

Les limitations de vitesse proviennent de plusieurs sources dont la précision et la couverture varient. Si vous constatez un problème récurrent, par exemple des limites de vitesse systématiquement incorrectes pour un type de route ou une zone géographique spécifiques, veuillez procéder comme suit pour nous en informer :

1. Ouvrez Google Maps sur votre ordinateur ou l'application Google Maps pour Android.
2. Ouvrez le menu latéral 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 le tronçon 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 la route porte un nom incorrect, est mal dessinée, est fermée ou est privée).

Pourquoi mon tracé ajusté coupe-t-il les virages 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 à des intervalles suffisamment proches (toutes les 1 à 10 secondes).

Pourquoi de nombreux segments de route sont-ils renvoyés dans le chemin d'accès ajusté pour une route sans changement de limitation de vitesse ?

 Lorsque le paramètre interpolate est défini sur true, la requête d'accrochage à la route renvoie une polyligne qui suit la route dans les virages, les courbes et les ronds-points. Si la route est sinueuse, plusieurs sections de route sont renvoyées, 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.