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 la nouvelle version de Text Search)
Pour en savoir plus, consultez Configurer votre projet Google Cloud.
Obtenir une clé APIActiver 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");