شروع کنید

این صفحه به شما نشان می دهد که چگونه یک کلید API دریافت کنید، API های مورد نیاز را فعال کنید و کتابخانه Places را بارگیری کنید تا بتوانید با کلاس Place کار کنید.

یک کلید API دریافت کنید و API های مورد نیاز را فعال کنید

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

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

برای کسب اطلاعات بیشتر، به تنظیم پروژه Google Cloud خود مراجعه کنید.

یک کلید API دریافت کنید

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

کتابخانه مکان ها را بارگیری کنید

برای بارگیری کتابخانه Places، ابتدا 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 مراجعه کنید.

مراحل بعدی

،

این صفحه به شما نشان می دهد که چگونه یک کلید API دریافت کنید، API های مورد نیاز را فعال کنید و کتابخانه Places را بارگیری کنید تا بتوانید با کلاس Place کار کنید.

یک کلید API دریافت کنید و API های مورد نیاز را فعال کنید

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

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

برای کسب اطلاعات بیشتر، به تنظیم پروژه Google Cloud خود مراجعه کنید.

یک کلید API دریافت کنید

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

کتابخانه مکان ها را بارگیری کنید

برای بارگیری کتابخانه Places، ابتدا 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 مراجعه کنید.

مراحل بعدی