Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Clé API et erreurs de facturation
Dans certains cas, une carte plus sombre ou une image "négative" Street View, portant le filigrane "à des fins de développement uniquement", peut s'afficher.
Cela indique généralement des problèmes liés à une clé API ou à la facturation.
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. La procédure suivante permet de résoudre ce problème :
Utilisez-vous une clé API ?
Je ne sais pas. Comment vérifier si j'utilise une clé API ?
Une clé API est transmise en tant que paramètre key dans l'URL utilisée pour charger l'API Maps JavaScript. Voici quelques options qui vous permettront de vérifier si vous utilisez une clé API :
Utilisez l'extension Chrome Google Maps Platform API Checker. Elle vous permet de déterminer si votre site Web met en œuvre correctement les API Google Maps sous licence de Google.
Si vous utilisez une bibliothèque ou un plug-in pour charger l'API Maps JavaScript, vérifiez les paramètres de cette bibliothèque et recherchez une option de clé API.
Vérifiez les erreurs dans votre navigateur.
Si vous voyez les messages suivants, cela signifie que vous n'utilisez pas correctement votre clé API :
Avertissement concernant l'API Google Maps JavaScript : NoApiKeys
Si vous avez accès au code source de votre application, recherchez la balise <script> utilisée pour charger l'API Maps JavaScript.
Lors du chargement de cette API, remplacez YOUR_API_KEY dans le code ci-dessous par votre clé API.
Vérifiez le trafic réseau généré par votre site Web dans le navigateur.
Dans Chrome, vous pouvez afficher cette information dans l'onglet Réseau de DevTools.
C'est aussi là que sont indiquées les requêtes réseau de votre site Web. Les requêtes effectuées à l'aide de l'API Maps JavaScript sont quant à elles incluses dans le chemin maps/api/js.
Vous pouvez vérifier ici si les requêtes utilisent le paramètre key.
Lorsque vous consultez l'onglet Réseau, il peut être utile de filtrer votre trafic réseau selon maps/api/js.
Non, je n'utilise pas de clé API.
Pour obtenir une clé API, cliquez sur le bouton ci-dessous. Si la configuration étape par étape ne s'affiche pas, suivez les instructions complètes disponibles dans la section Premiers pas avec Google Maps Platform.
Commencer
Oui, j'utilise une clé API.
Parfait ! Vérifions à présent qu'un compte de facturation est associé à votre projet.
Un compte de facturation est-il associé à votre projet ?
Je ne sais pas. Comment vérifier si un compte de facturation est associé à mon projet ?
Accédez à la
page Facturation de la console Google Cloud, puis sélectionnez le projet dans lequel votre clé API a été créée.
Pour confirmer que la clé est associée au projet, procédez comme suit :
Accédez à la section Identifiants (depuis la barre latérale de gauche, sous Google Maps Platform > Identifiants).
Vérifiez que la clé API que vous utilisez actuellement sur votre site Web est répertoriée.
Si ce n'est pas le cas, sélectionnez un autre projet, puis vérifiez les identifiants.
Si vous ne parvenez pas à trouver le projet correspondant à votre clé API, cela signifie que vous n'y avez peut-être plus accès.
Demandez de l'aide aux autres membres de votre organisation. Si vous ne retrouvez pas le projet d'origine :
Créez un projet. Pour ce faire, sélectionnez Nouveau projet dans la liste de projets, ou Créer un projet sur la page Resource Manager.
Créez une clé API. Pour ce faire, accédez à la page Identifiants.
Cliquez ensuite sur Créer des identifiants, puis sélectionnez Clé API.
Une fois que vous avez localisé votre projet dans la console Cloud, vérifiez si un compte de facturation lui est associé. Pour ce faire, accédez à la section Facturation dans le menu latéral de gauche.
Non, aucun compte de facturation n'est associé à mon projet.
Une limite quotidienne que vous avez définie a-t-elle été dépassée dans l'API ?
Si vous avez vous-même défini une limite quotidienne pour l'une de vos API, ce qui est courant pour éviter toute augmentation inattendue, vous pouvez résoudre ce problème en augmentant votre limite quotidienne.
Sélectionnez une API dans la liste, puis cliquez sur l'onglet Quotas.
Votre clé API comporte-t-elle une restriction d'adresse IP ?
Les clés API comportant une restriction d'adresse IP ne peuvent être utilisées qu'avec les services Web destinés à être utilisés côté serveur (l'API Geocoding et d'autres API Web Service, par exemple).
La plupart de ces services Web disposent d'équivalents dans l'API Maps JavaScript (voir le service Geocoding, par exemple).
Pour utiliser les services côté client de l'API Maps JavaScript, vous devez créer une clé API distincte qui peut être sécurisée à l'aide d'une restriction de référent HTTP (voir la section Obtenir, ajouter et restreindre une clé API).
Si votre code ne fonctionne pas :
Pour vous aider à configurer votre code Maps, Brendan Kenny et Mano Marks vous présentent dans cette vidéo quelques-unes des erreurs les plus courantes et la façon de les corriger.
Vérifiez qu'il ne contient pas de fautes de frappe. Rappelez-vous que le langage JavaScript est sensible à la casse.
Vérifiez les bases. Certains des problèmes les plus courants surviennent en effet lors de la création initiale de la carte. Par exemple :
Vérifiez que vous avez spécifié les propriétés zoom et center dans les options de votre carte.
Assurez-vous d'avoir déclaré un élément div dans lequel la carte s'affichera à l'écran.
Assurez-vous d'avoir défini une hauteur dans l'élément div pour la carte. Par défaut, les éléments div sont créés avec une hauteur de 0 et sont donc invisibles.
Utilisez un débogueur JavaScript pour identifier les problèmes, par exemple celui disponible dans les outils pour les développeurs Chrome. Commencez par rechercher d'éventuelles erreurs dans la console JavaScript.
Posez vos questions sur Stack Overflow. Pour savoir comment poser des questions de qualité, consultez la page d'assistance.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eTo use the Google Maps JavaScript API, you must include an API key and enable billing for your project.\u003c/p\u003e\n"],["\u003cp\u003eIf you see a darkened map or a negative Street View image watermarked with "for development purposes only", you might have an issue with your API key or billing.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting steps involve verifying your API key implementation, checking billing account attachment, ensuring billing method validity, and reviewing daily usage limits and IP restrictions.\u003c/p\u003e\n"],["\u003cp\u003eThis page offers solutions to common billing and API errors, and links to resources for further assistance.\u003c/p\u003e\n"]]],["Using the Maps JavaScript API requires a valid API key and enabled billing. Issues like a darkened map typically stem from these. Verify API key usage via browser checks, source code, or network traffic. Ensure the project linked to your API key has an active billing account. Check for invalid payment methods or exceeded API daily limits. If restricted by IP address, create a key with HTTP referrers. Troubleshoot by checking for typos, verifying map element properties, or using a JavaScript debugger.\n"],null,["# Troubleshooting\n\n| **Reminder:** To use the Maps JavaScript API:\n|\n| - All Maps JavaScript API requests must include an API key; we no longer support keyless access.\n| - You must [enable billing](https://console.cloud.google.com/project/_/billing/enable?utm_source=Docs_BillingNudge) on each of your projects.\n\n### API Key and Billing Errors\n\n\nUnder certain circumstances, a darkened map, or 'negative' Street View image,\nwatermarked with the text \"for development purposes only\", may be displayed.\nThis behavior typically indicates issues with either an API key or billing.\nIn order to use Google Maps Platform products, billing must be enabled on your account,\nand all requests must include a valid API key. The following flow will help troubleshoot this:\n\n#### Are you using an API key?\n\n#### I'm not sure. How can I check if I am using an API key?\n\nAn API key is passed as the `key` parameter in the URL that is used to load the\nMaps JavaScript API. Here are a few options to check if you are using an API key:\n\n- Use the [Google Maps Platform API Checker](https://chrome.google.com/webstore/detail/google-maps-platform-api/mlikepnkghhlnkgeejmlkfeheihlehne) Chrome extension. This allows you to determine if your website is properly implementing Google's licensed Maps APIs.\n- If you are using a library or plugin to load the Maps JavaScript API, check the settings for that library and look for an API key option.\n- Check [errors in your browser](/maps/documentation/javascript/error-messages#checking-errors). If you see the following messages, you are not using your API key correctly:\n - Google Maps JavaScript API warning: [NoApiKeys](/maps/documentation/javascript/error-messages#no-api-keys)\n - Google Maps JavaScript API error: [MissingKeyMapError](/maps/documentation/javascript/error-messages#missing-key-map-error)\n\n#### For web developers:\n\n- If you have access to the source code of your application, look for the `\u003cscript\u003e` tag which is used to load the Maps JavaScript API. When loading the Maps JavaScript API, substitute `YOUR_API_KEY` in the code below with your API key. \n\n ```html\n \u003cscript async defer\n src=\"https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap\"\u003e\n \u003c/script\u003e\n ```\n- Check the network traffic generated by your website in the browser. In Chrome, this can be viewed using the [DevTools](/web/tools/chrome-devtools) **Network** tab. Here you will see the network requests made by your website. Requests made using the Maps JavaScript API will be under the path `maps/api/js`. Here you can confirm if the requests are using the `key` parameter. It may be helpful to [filter your network traffic](/web/tools/chrome-devtools/console#filtering_the_console_output) by `maps/api/js` when viewing the **Network** tab.\n\n#### No, I am not using an API key.\n\nTo get an API key, click the button below. If you do not see a guided setup, follow the\nfull instructions at [Get Started with Google Maps\nPlatform](/maps/get-started#procedures).\n\n\n[Get Started](/maps/get-started)\n\n#### Yes, I am using an API key.\n\nGreat! Let's move on and check if a billing account is attached to your project.\n\n#### Is a billing account attached to your project?\n\n#### I'm not sure. How can I check if billing account is attached to my project?\n\nGo to the [Billing page](https://console.cloud.google.com/project/_/billing/enable?utm_source=Docs_BillingNudge) in the Google Cloud console and select the project under which your API key was created.\nTo confirm the key is associated with the project:\n\n1. Go to the **Credentials** section, which can be accessed from the left side bar under **Google Maps Platform \\\u003e Credentials**.\n2. Check that the API key you currently use on your website is listed. If that's not the case, switch to a different project, and check the credentials there.\n3. If you cannot locate the project for your API key, you may have lost access to this project. Ask others in your organization for help. If the original project cannot be located, you should:\n 1. Create a new project. This can be done by selecting **New Project** from the projects list, or by selecting **Create Project** via the [Resource Manager page](https://console.cloud.google.com/cloud-resource-manager).\n 2. Create a new API key. This can be done on the **Credentials** page. Once there click **Create credentials** and then select **API key**.\n\n\nOnce you have located your project in the Cloud console,\ncheck if a billing account is attached by navigating to the [Billing](https://console.cloud.google.com/project/_/billing) section in the left side menu.\n\n#### No, a billing account is not attached to my project.\n\nGo to the [Enable Billing](https://console.cloud.google.com/project/_/billing/enable?utm_source=Docs_BillingNudge) page in the Cloud console\nand add a billing account to your project. For additional information, see\n[Get Started with Google Maps Platform](/maps/get-started).\n\n#### Yes, a billing account is attached to my project.\n\nGreat! Let's make sure the provided billing method is valid.\n\n#### Is the provided billing method no longer valid (for example an expired credit card)?\n\nYou [can add, remove, or update a payment method](https://cloud.google.com/billing/docs/how-to/payment-methods) in the Cloud console.\n\n#### Is there an exceeded self-imposed daily limit on the API?\n\nIf you have set a daily limit on any of your APIs, which is common to prevent unexpected increases,\nyou can resolve this by [increasing your daily limit](/maps/faq#usage_cap).\n\nYou can check your daily limits by going to the\n[APIs \\& Services Dashboard](https://console.cloud.google.com/project/_/apiui/apis/enabled?utm_source=Docs_EnabledAPIsView) in the\nCloud console. Once there:\n\n1. Select a project if prompted.\n2. Select an API from the list, then click the **Quotas** tab.\n\n#### Does your API key have an IP addresses restriction?\n\nAPI keys with an **IP addresses** restriction can only be used with web services that are\nintended for use from the server side (such as the\n[Geocoding API](/maps/documentation/geocoding/start)\nand other [Web Service APIs](/maps/apis-by-platform)).\nMost of these web services have equivalent services within the Maps JavaScript API (for example, see the\n[Geocoding Service](/maps/documentation/javascript/geocoding)).\nTo use the Maps JavaScript API client side services, you will need to create a separate API key which\ncan be secured with an **HTTP referrers** restriction (see\n[Get, add, and restrict an API key](/maps/get-started#api-key)).\n\n### If your code isn't working:\n\nTo help you get your maps code up and running, Brendan Kenny and Mano Marks point out\nsome common mistakes and how to fix them in this video. \n\n- Look for typos. Remember that JavaScript is a case-sensitive language.\n- Check the basics - some of the most common problems occur with the initial map creation. Such as:\n - Confirm that you've specified the `zoom` and `center` properties in your map options.\n - Ensure that you have declared a div element in which the map will appear on the screen.\n - Ensure that the div element for the map has a height. By default, div elements are created with a height of 0, and are therefore invisible.\n\n Refer to our examples for a [reference\n implementation](/maps/documentation/javascript/examples/map-simple).\n- Use a JavaScript debugger to help identify problems, like the one available in the [Chrome\n Developer Tools](/chrome-developer-tools/docs/javascript-debugging). Start by looking in the JavaScript console for errors.\n- Post questions to [Stack\n Overflow](https://stackoverflow.com/questions/ask?tags=google-maps-api-3,google-maps). Guidelines on how to post great questions are available on the [Support](/maps/support) page."]]
