Suivez ces étapes pour configurer les repères avancés.
Obtenir une clé API et activer l'API Maps JavaScript
Avant d'utiliser les repères avancés, vous devez disposer d'un projet Cloud avec un compte de facturation, et l'API Maps JavaScript doit être activée. Pour en savoir plus, consultez Configurer votre projet Google Cloud.
Pour créer un ID de carte, suivez les étapes décrites dans Personnalisation dans Cloud.
Définissez le type de carte sur JavaScript, puis sélectionnez l'option Vecteur ou Trame.
Modifier le code d'initialisation de la carte
Vous aurez besoin de l'ID de carte que vous venez de créer. Il se trouve sur votre page Gestion des cartes.
Indiquez un ID de carte lorsque vous instanciez la carte à l'aide de la propriété mapId.
Il peut s'agir d'un ID de carte que vous fournissez, ou de DEMO_MAP_ID.
Vérifier les fonctionnalités de la carte (facultatif)
Les repères avancés nécessitent un ID de carte. Si l'ID de carte est manquant, les repères avancés ne seront pas chargés. Pour résoudre ce problème, vous pouvez ajouter un écouteur mapcapabilities_changed pour vous abonner aux modifications des fonctionnalités de la carte. Utiliser des fonctionnalités de la carte est facultatif et n'est recommandé que pour les tests, le dépannage ou une exécution de secours.
// Optional: subscribe to map capability changes.map.addListener('mapcapabilities_changed',()=>{constmapCapabilities=map.getMapCapabilities();if(!mapCapabilities.isAdvancedMarkersAvailable){// Advanced markers are *not* available, add a fallback.}});
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/17 (UTC).
[null,null,["Dernière mise à jour le 2025/08/17 (UTC)."],[[["\u003cp\u003eGet started with advanced markers by obtaining an API key, enabling the Maps JavaScript API, and creating a map ID.\u003c/p\u003e\n"],["\u003cp\u003eUpdate your map initialization code to include loading the advanced markers library and providing a map ID when instantiating the map.\u003c/p\u003e\n"],["\u003cp\u003eFor testing purposes, use \u003ccode\u003eDEMO_MAP_ID\u003c/code\u003e as the map ID or utilize the provided example code, but replace the example map IDs for production.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, check map capabilities to ensure advanced markers are available or to implement a fallback if they are not supported.\u003c/p\u003e\n"]]],["To use advanced markers, you need a Cloud project with a billing account and the Maps JavaScript API enabled. First, obtain an API key and create a map ID, selecting JavaScript as the map type with either Vector or Raster options, or using `DEMO_MAP_ID` for testing. Update your map initialization code by loading the Maps JavaScript API and the advanced markers library. Instantiate the map with the created or demo map ID. Optionally, use a listener to check map capabilities.\n"],null,["Select platform: [Android](/maps/documentation/android-sdk/advanced-markers/start \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/advanced-markers/overview \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/advanced-markers/start \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\nFollow these steps to get set up with advanced markers.\n\nGet an API key and enable the Maps JavaScript API\n\nBefore using advanced markers, you need a Cloud\nproject with a billing account, and the Maps JavaScript API\nenabled. To learn more, see [Set up your Google Cloud project](/maps/documentation/javascript/cloud-setup).\n\n[Get an API key](/maps/documentation/javascript/get-api-key)\n\nCreate a map ID\n\nTo create a new [map ID](/maps/documentation/get-map-id), follow the steps in\n[Cloud customization](/maps/documentation/javascript/maps-customization-overview).\nSet the Map type to **JavaScript** , and select either the **Vector** or\n**Raster** option.\n| **Important:** For testing, you can skip the step of creating and configuring a map ID, by using `mapId: 'DEMO_MAP_ID'` in your app code.\n\nUpdate your map initialization code\n\nThis requires the map ID you just created. It can be found on your [Maps\nManagement](https://console.cloud.google.com/google/maps-apis/studio/maps) page.\n\n1. [Load the Maps JavaScript API](/maps/documentation/javascript/load-maps-js-api).\n\n2. Load the advanced markers library from within an `async`\n function when needed:\n\n ```javascript\n const { AdvancedMarkerElement } = await google.maps.importLibrary(\"marker\") as google.maps.MarkerLibrary;\n ```\n3. Provide a map ID when you instantiate the map using the `mapId` property.\n This can be a map ID that you provide, or `DEMO_MAP_ID`.\n\n ```javascript\n const map = new\n google.maps.Map(document.getElementById('map'), {\n center: {lat: -34.397, lng: 150.644},\n zoom: 8,\n mapId: 'YOUR_MAP_ID'\n });\n ```\n\n| **Caution:** The example maps for advanced markers use map IDs that are linked to a reduced-POI map style. If you re-use example code, we recommend replacing these map IDs with `DEMO_MAP_ID`, or with your own map ID.\n\nCheck map capabilities (optional)\n\nAdvanced markers requires a map ID. If the map ID is missing,\nadvanced markers cannot load. As a troubleshooting step,\nyou can add a `mapcapabilities_changed` listener to subscribe to map capability\nchanges. Using Map Capabilities is optional, and recommended only for testing\nand troubleshooting purposes, or for runtime fallback purposes. \n\n```javascript\n// Optional: subscribe to map capability changes.\nmap.addListener('mapcapabilities_changed', () =\u003e {\n const mapCapabilities = map.getMapCapabilities();\n\n if (!mapCapabilities.isAdvancedMarkersAvailable) {\n // Advanced markers are *not* available, add a fallback.\n }\n});\n```\n\nNext steps\n\n[Create a default advanced marker](/maps/documentation/javascript/advanced-markers/add-marker)"]]
