Vous êtes prêt !

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

Activer Google Maps JavaScript 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 JavaScript API et les services connexes
  3. Créer les clés appropriées
Continuer

Messages d'erreur


Google Maps JavaScript API affiche les messages d'erreur et d'avertissement via window.console. Les tableaux ci-dessous répertorient les codes d'erreur qui peuvent être renvoyés par Google Maps JavaScript API, en décrivent les causes et expliquent comment y remédier. Pour en savoir plus sur l'identification des messages d'erreur, voir la section sur la vérification des erreurs dans le navigateur.

Codes d'erreur de Google Maps JavaScript API

Si une erreur se produit lorsque vous chargez Google Maps JavaScript API, consultez le tableau ci-dessous pour trouver les explications associées aux codes d'erreur.

Code d'erreur Message Description
InvalidKeyOrUnauthorizedURLMapError The provided Google API key is invalid or this site is not authorized to use it.

La clé d'API incluse dans l'élément de script qui charge l'API n'est pas valide, ou bien l'URL actuellement utilisée pour charger Google Maps JavaScript API n'a pas été ajoutée à la liste des points d'accès autorisés. Vous devez peut-être activer Google Maps JavaScript API sous APIs dans la Google API Console.

Voir Obtenir une clé d'API.

NotLoadingAPIFromGoogleMapError The Google Maps JavaScript API must be downloaded directly from Google's servers.

L'élément de script qui charge Google Maps JavaScript API n'est pas correctement inclus dans votre page. Pour que l'API fonctionne correctement, elle doit être chargée directement à partir du site https://maps.googleapis.com.

Voir Charger Maps API.

TOSViolationMapError This website appears to violate the Google Maps API Terms of Service. The Google Maps API has been disabled for this website.

Votre application a été bloquée pour non-respect des Conditions de service de Google Maps APIs, suite à plusieurs e-mails de notification. Pour envoyer une demande de déblocage et de révision de votre implémentation, remplissez ce formulaire. Vous recevrez une réponse par e-mail sous quelques jours ouvrables.

Si vous possédez une licence Google Maps APIs Premium Plan, utilisez vos informations d'identification Google Maps APIs Premium Plan pour résoudre cette erreur. Voir le guide dédié aux clés d'API et ID client.

UnauthorizedURLForClientIdMapError This URL is not authorized to use the Google Maps Client ID provided.

L'ID client Premium Plan ou Maps APIs for Work inclus dans le chargement du script n'est pas valide ou a expiré, ou bien l'adresse actuellement utilisée pour charger Google Maps JavaScript API n'a pas été ajoutée à la liste des URL autorisées.

Voir Enregistrer les URL autorisées.

Codes d'erreur de Google Maps JavaScript API pour les développeurs

Si une erreur se produit sur la console Chrome JavaScript, la console Firefox Web ou tout autre outil équivalent de vos navigateurs, consultez le tableau ci-dessous pour trouver les explications associées aux codes d'erreur.

Il existe deux types de codes d'erreur : les erreurs et les avertissements. Une erreur indique un problème grave qui s'est produit lors du chargement de Google Maps JavaScript API. Votre page ne peut pas charger l'API correctement et l'API ne fonctionnera pas sur cette page. Un avertissement est un message auxiliaire relatif au chargement de Google Maps JavaScript API. Il décrit les raisons possibles d'une erreur ou suggère des problèmes potentiels dans le code utilisé pour charger Google Maps JavaScript API. Si vous obtenez seulement des avertissements (sans aucune erreur), l'API fonctionnera correctement sur la page. Toutefois, nous recommandons de résoudre également tout problème potentiel.

Code d'erreur de développeur Type Description
ApiNotActivatedMapError Erreur

Google Maps JavaScript API n'est pas activée sur votre projet d'API. Vous devez peut-être activer Google Maps JavaScript API sous APIs dans la Google API Console.

Voir Obtenir une clé d'API.

DeletedApiProjectMapError Erreur

Votre projet d'API a peut-être été supprimé de la Google API Console. Vérifiez pour quel projet vous avez généré la clé d'API incluse dans JavaScript API Loader. Vous pouvez créer un autre projet d'API et obtenir une nouvelle clé sur la Google API Console.

Voir Obtenir une clé d'API.

ExpiredKeyMapError Erreur

La clé d'API incluse dans l'élément de script qui charge l'API a expiré. Vous devez peut-être générer une nouvelle clé d'API dans la Google API Console.

Voir Obtenir une clé d'API.

InvalidClientIdMapError Erreur

L'ID client inclus dans l'élément de script qui charge l'API n'est pas valide ou a expiré. Veillez à utiliser correctement votre ID client. L'ID client doit commencer par le préfixe « gme- ». Si cette erreur s'affiche alors que vous utilisez votre ID client correctement, l'ID client a peut-être expiré. Contactez votre gestionnaire de compte Google.

Si vous ne possédez pas de licence Premium Plan ou Maps APIs for Work, vous devez utiliser un paramètre key avec votre clé d'API, à la place du paramètre client.

Voir Votre ID client.

InvalidKeyMapError Erreur

La clé d'API incluse dans l'élément de script qui charge l'API est introuvable. Veillez à utiliser une clé d'API correcte. Vous pouvez générer une nouvelle clé d'API sur la Google API Console.

Voir Obtenir une clé d'API.

MissingKeyMapError Erreur

Il manque le paramètre d'authentification requis pour l'élément de script qui charge l'API. Si vous utilisez la version standard de Maps JavaScript API, vous devez utiliser un paramètre key avec une clé d'API valide. Si vous êtes un client Premium Plan, vous devez utiliser soit un paramètre client avec votre ID client, soit un paramètre key avec une clé d'API valide.

Voir le guide dédié aux clés d'API et ID client.

ProjectDeniedMapError Erreur

La requête n'a pas abouti. Pour plus de détails sur l'erreur, examinez la Google API Console.

Voir Google API Console.

RefererDeniedMapError Erreur

Votre application a été bloquée pour non-respect des Conditions de service de Google Maps APIs, suite à plusieurs e-mails de notification. Pour envoyer une demande de déblocage et de révision de votre implémentation, remplissez ce formulaire. Vous recevrez une réponse par e-mail sous quelques jours ouvrables.

RefererNotAllowedMapError Erreur

L'URL actuellement utilisée pour charger Google Maps JavaScript API n'a pas été ajoutée à la liste des points d'accès autorisés. Vérifiez les paramètres de points d'accès de votre clé d'API sur la Google API Console.

Voir Clés d'API dans la Google API Console. Pour plus d'informations, voir Meilleures pratiques d'utilisation sécurisée des clés d'API.

OverQuotaMapError Erreur

Le nombre de requêtes a dépassé les limites d'utilisation de Google Maps JavaScript API. Les requêtes de votre application fonctionneront de nouveau à la prochaine réinitialisation du quota journalier.

Pour plus de détails, voir le guide dédié aux limites d'utilisation. Cette page explique également comment accroître vos limites d'utilisation.

ClientIdLooksLikeCryptoKey Avertissement

Vous avez peut-être spécifié une clé cryptographique dans le paramètre client. Si vous possédez une licence Premium Plan ou Maps APIs for Work, indiquez votre ID client dans le paramètre client. Vous n'avez pas besoin d'utiliser votre clé cryptographique pour Google Maps JavaScript API.

Voir le guide dédié aux ID client pour les clients Premium Plan et Maps APIs for Work.

ClientIdLooksLikeKey Avertissement

Vous avez peut-être spécifié une clé d'API dans le paramètre client. Si vous possédez une licence Premium Plan ou Maps APIs for Work, indiquez votre ID client dans le paramètre client. Si vous avez Google Maps APIs Premium Plan, vous pouvez utiliser un paramètre client ou key. Si vous ne possédez pas de licence, vous devez utiliser un paramètre key à la place du paramètre client.

Voir le guide dédié aux ID client et clés d'API.

InvalidChannel Avertissement

Vous avez peut-être spécifié un paramètre channel non valide. La valeur de ce paramètre doit être une chaîne alphanumérique ASCII qui peut contenir des points (.), des tirets bas (_) et des tirets (-). Veillez à spécifier un paramètre channel valide.

Voir Rapports | Google Maps APIs Premium Plan.

InvalidClientId Avertissement

Le paramètre client ne semble pas contenir un ID client correct. Tout ID client doit commencer par « gme- ».

Voir le guide dédié aux ID client pour les clients Premium Plan ou Maps APIs for Work.

InvalidKey Avertissement

La clé d'API incluse dans l'élément de script qui charge l'API semble incorrecte. Veillez à utiliser une clé d'API correcte. Vous pouvez générer une nouvelle clé d'API sur la Google API Console.

Voir Obtenir une clé d'API.

InvalidVersion Avertissement

Vous avez peut-être spécifié un numéro de version incorrect dans l'élément de script. Veillez à utiliser un numéro de version correct.

Voir Versionnage | Google Maps JavaScript API.

KeyLooksLikeClientId Avertissement Vous avez peut-être spécifié un ID client dans le paramètre key. Si vous possédez une licence Premium Plan ou Maps APIs for Work, indiquez votre ID client dans le paramètre client, à la place du paramètre key. Si vous avez Google Maps APIs Premium Plan, vous pouvez utiliser un paramètre client ou key. Si vous ne possédez pas de licence, vous devez utiliser un paramètre key à la place du paramètre client.

Voir le guide dédié aux ID client et clés d'API

KeyLooksLikeCryptoKey Avertissement

Vous avez peut-être spécifié une clé cryptographique dans le paramètre key. Si vous possédez une licence Premium Plan ou Maps APIs for Work, indiquez votre ID client dans le paramètre client et supprimez le paramètre key de l'élément de script. La clé cryptographique n'est pas requise pour Google Maps JavaScript API. Si vous avez Google Maps APIs Premium Plan, vous pouvez utiliser un paramètre client ou key. Si vous ne possédez pas de licence, vous pouvez obtenir une clé d'API gratuite via la Google API Console.

Voir le guide dédié aux ID client et clés d'API

KeyLooksLikeProjectNumber Avertissement

Vous avez peut-être spécifié un numéro de projet dans le paramètre key. Veillez à utiliser une clé d'API correcte. Vous pouvez générer une nouvelle clé d'API sur la Google API Console.

Voir Obtenir une clé d'API.

NoApiKeys Avertissement

L'élément de script qui charge l'API ne possède pas de clé d'API. Assurez-vous de définir le paramètre key sur une clé d'API valide. Vous pouvez générer une nouvelle clé d'API sur la Google API Console.

Voir Obtenir une clé d'API.

RetiredVersion Avertissement

Vous avez peut-être spécifié une version obsolète de l'élément de script. Les versions 3.0 - 3.24 ne sont plus utilisées. À la place, vous pouvez recevoir la version 3.25. Mettez l'application à jour pour utiliser l'une des versions disponibles.

Voir Versionnage | Google Maps JavaScript API.

SensorNotRequired Avertissement

Le paramètre sensor n'est plus obligatoire pour Google Maps JavaScript API. Il n'empêche pas Google Maps JavaScript API de fonctionner correctement, mais nous recommandons de supprimer sensor de l'élément de script.

SignatureNotRequired Avertissement

Le paramètre signature n'est pas requis pour Google Maps JavaScript API. Il n'empêche pas Google Maps JavaScript API de fonctionner correctement, mais il peut représenter un risque de sécurité. Supprimez-le de l'élément de script.

SignedInDeprecated Avertissement

Le paramètre signed_in est obsolète et sera ignoré dans les futures versions de Google Maps JavaScript API. Son élimination ne gênera pas le fonctionnement de Google Maps JavaScript API, mais votre application changera peut-être de comportement si vous continuez d'utiliser les fonctionnalités actuelles du mode avec connexion (signed-in).

Révisez votre application et consultez la page Cartes avec connexion | Google Maps JavaScript API pour plus de détails sur les changements à venir.

UrlAuthenticationCommonError Erreur

Il s'est produit une erreur qui ne correspond à aucune autre catégorie de cette page. Elle peut être due à un problème temporaire. Relancez la requête après un court délai. Si le problème ne se résout pas, voir le guide du développeur pour vérifier que le format de la requête est correct.

Vérification des erreurs dans le navigateur

Google Maps JavaScript API affiche les messages d'erreur via window.console. Cette section explique comment consulter le résultat window.console dans Google Chrome. Si vous utilisez un autre navigateur, consultez la documentation pour les développeurs correspondant à votre navigateur. Pour référence, les outils suivants permettent de consulter le résultat window.console dans d'autres navigateurs.

Dans Chrome, vous pouvez utiliser la console JavaScript pour consulter le résultat window.console de la manière suivante.

  1. Pour ouvrir les outils de développeur, sélectionnez l'icône de menu > More Tools > Developer Tools.
  2. Pour ouvrir la console JavaScript, appuyez sur la touche ECHAP du clavier. La touche ECHAP active la console JavaScript. Si vous fermez la console, appuyez de nouveau sur la touche ECHAP pour la rouvrir.

Si des erreurs ou des avertissements se produisent lors du chargement de Google Maps JavaScript API, ils s'affichent sous la forme d'une ou plusieurs lignes dans la console. Le format des messages d'erreur et d'avertissement est le suivant :

Google Maps API error: [ERROR CODE] [Link to API document]
ou
Google Maps API warning: [ERROR CODE] [Link to API document]

Consultez le tableau des codes d'erreur ci-dessus pour identifier le code d'erreur fourni dans le message d'erreur. Pour plus de détails sur le message d'erreur, cliquez sur le lien vers la documentation d'API fournie dans le message.

Remarque : Vous pouvez écouter les erreurs d'authentification par programmation.

Envoyer des commentaires concernant…

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