Commencer

Développeurs situés dans l'Espace économique européen (EEE)

Cette page vous explique comment obtenir une clé API, activer les API requises et charger la bibliothèque Places, afin de pouvoir utiliser la classe Place.

Obtenir une clé API et activer les API requises

Avant d'utiliser la classe Place, vous devez :

  • créer un projet Cloud avec un compte de facturation ;
  • obtenir une clé API ;
  • activer les API suivantes :
    • API Maps JavaScript
    • API Places
    • API Places (nouvelle version) (obligatoire pour utiliser Text Search (New) et Place Autocomplete)

Pour en savoir plus, consultez Configurer votre projet Google Cloud.

Obtenir une clé API

Activer l'API Places (nouvelle version)

Charger la bibliothèque Places

Pour charger la bibliothèque Places, commencez par charger l'API Maps JavaScript en ajoutant le chargeur d'amorçage intégré au code de votre application, comme indiqué dans l'extrait de code suivant : 

<script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "weekly",
    // Use the 'v' parameter to indicate the version to use (weekly, beta, alpha, etc.).
    // Add other bootstrap parameters as needed, using camel case.
  });
</script>

Utilisez ensuite l'opérateur await pour appeler importLibrary() depuis une fonction async, comme indiqué ci-dessous :

  const {Place} = await google.maps.importLibrary("places");

Votre fonction peut également charger des bibliothèques sans déclarer de variable pour les classes nécessaires:

  async function initMap() {
    google.maps.importLibrary("places");
    ...
  }

  initMap();

Vous pouvez également charger les bibliothèques directement en HTML, comme indiqué ci-dessous:

  <script>
  google.maps.importLibrary("places");
  </script>

Pour en savoir plus sur le chargement de bibliothèques, consultez la section Charger l'API Maps JavaScript.

Étapes suivantes