شروع کنید

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

این صفحه به شما نشان می‌دهد که چگونه کلید میانای برنامه‌سازی کاربردی دریافت کنید، میاناهای برنامه‌سازی کاربردی موردنیاز را فعال کنید، و «کتابخانه جاها» را بار کنید، تا بتوانید با کلاس «جا» کار کنید.

دریافت کلید میانای برنامه‌سازی کاربردی و فعال کردن میاناهای برنامه‌سازی کاربردی موردنیاز

قبل‌از استفاده از کلاس Place، باید:

  • پروژه Cloud با حساب صورت‌حساب ایجاد کنید.
  • کلید میانای برنامه‌سازی کاربردی دریافت کنید.
  • میاناهای برنامه‌سازی کاربردی زیر را فعال کنید:
    • Maps JavaScript API
    • Places API
    • Places API (جدید) (برای استفاده از «جستجوی نوشتار» (جدید) و «تکمیل خودکار جا» الزامی است)

برای کسب اطلاعات بیشتر، راه‌اندازی پروژه Google Cloud را ببینید.

دریافت کلید میانای برنامه‌سازی کاربردی

فعال کردن Places API (جدید)

بار کردن «کتابخانه جاها»

برای بار کردن «کتابخانه جاها»، ابتدا Maps JavaScript API را با افزودن بارگذار خودراه‌انداز به‌خط به کد برنامه‌تان بار کنید، همان‌طور که در قطعه کد زیر نشان داده شده است: 

<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>

سپس، از اپراتور await برای فراخوانی importLibrary() از داخل تابع async استفاده کنید، همان‌طور که در اینجا نشان داده شده است:

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

تابع شما همچنین می‌تواند کتابخانه‌ها را بدون اعلام متغیر برای کلاس‌های موردنیاز بار کند:

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

  initMap();

یا می‌توانید کتابخانه‌ها را مستقیماً در HTML بار کنید، همان‌طور که در اینجا نشان داده شده است:

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

برای اطلاعات بیشتر درباره بار کردن کتابخانه‌ها، بار کردن Maps JavaScript API را ببینید.

مراحل بعدی