Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps Roads API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou sélectionner un projet
  2. Activer Google Maps Roads API
  3. Créer les clés appropriées
Continuer

Résolution des erreurs

En cas d'erreur, une réponse d'erreur au format standard est renvoyée et le code de statut HTTP prend la valeur d'un statut d'erreur.

La réponse contient un objet avec un seul objet error et les clés suivantes :

  • code : Correspond au statut HTTP de la réponse.
  • message : Description courte de l'erreur.
  • status : Code de statut indiquant la nature de l'erreur.

Par exemple, l'envoi d'un paramètre placeId non valide génère l'erreur suivante :

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

Voici les erreurs possibles :

Code Statut Message Résolution des erreurs
400 INVALID_ARGUMENT The key you provided is invalid. Votre clé d'API n'est pas valide ou n'était pas incluse dans la requête. Vérifiez que vous avez inclus la clé complète et que vous avez activé l'API de cette clé.
400 INVALID_ARGUMENT "\"path\" parameter contains an invalid value: ☃" Votre requête contient des arguments non valides. Les causes les plus probables de cette erreur sont :
  • Un problème avec votre paramètre path.
    Assurez-vous d'avoir au moins 1 point et moins de 100 points. Chaque point doit être composé d'une paire de chiffres séparés par une virgule, comme : 48.409114,-123.369158. Les points doivent être séparés par une barre verticale : « | ».
  • Votre requête incluait un paramètre placeId non valide.
  • Votre requête incluait des paramètres placeId et un paramètre path. Seul l'un de ces paramètres peut être spécifié dans chaque requête.

Cette erreur n'est pas renvoyée si un paramètre placeId est défini pour une route qui n'existe plus ou pour un lieu qui n'est pas une route.

403 PERMISSION_DENIED Unregistered request was blocked. Please sign up using Google Developers Console. Votre clé d'API n'est pas valide ou n'était pas incluse dans la requête. Vérifiez que vous avez inclus la clé complète et que vous avez activé l'API de cette clé.
404 NOT_FOUND HTTPS is required for this service. Assurez-vous d'envoyer les requêtes à https://roads.googleapis.com/ et non pas à http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED The request was throttled due to project QPS limit being reached. Vous avez dépassé le nombre limite de requêtes par seconde et par utilisateur que vous avez configurée dans la API Console. Cette limite doit être configurée de manière à éviter qu'un utilisateur ou un petit groupe d'utilisateurs épuise votre quota journalier, tout en assurant un accès raisonnable à chaque utilisateur.
429 RESOURCE_EXHAUSTED The request was throttled due to daily limit being reached. Vous avez dépassé le quota journalier de votre projet.

Retrait exponentiel

Lorsqu'une requête échoue, assurez-vous d'appliquer un retrait exponentiel aux nouvelles tentatives de requêtes. 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 et ainsi de suite. Cela évite que les requêtes endommagées ou les échecs à grande échelle n'inondent les serveurs de Google, car de nombreux clients tentent de relancer les requêtes très rapidement.

Envoyer des commentaires concernant…

Google Maps Roads API
Google Maps Roads API
Besoin d'aide ? Consultez notre page d'assistance.