البدء

توضّح لك هذه الصفحة كيفية الحصول على مفتاح واجهة برمجة التطبيقات وتفعيل واجهات برمجة التطبيقات المطلوبة وتحميل "مكتبة الأماكن"، حتى تتمكّن من العمل مع فئة "المكان".

الحصول على مفتاح واجهة برمجة التطبيقات وتفعيل واجهات برمجة التطبيقات المطلوبة

قبل استخدام فئة Place، عليك إجراء ما يلي:

• أنشئ مشروعًا على Cloud باستخدام حساب فوترة.
• الحصول على مفتاح واجهة برمجة التطبيقات
• فعِّل واجهات برمجة التطبيقات التالية:
  
  • Maps JavaScript API
  • واجهة برمجة تطبيقات الأماكن
  • ‫Places API (الإصدار الجديد) (مطلوب لاستخدام ميزة "البحث النصي" (الإصدار الجديد) وميزة "الإكمال التلقائي للأماكن")

لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروعك على Google Cloud.

تفعيل Places API (الإصدار الجديد)

تحميل "مكتبة الأماكن"

لتحميل Places Library، عليك أولاً تحميل Maps JavaScript API، وذلك عن طريق إضافة مُحمِّل bootstrap مضمّن إلى رمز تطبيقك، كما هو موضّح في المقتطف التالي:

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

الخطوات التالية

• البحث عن أماكن
• الحصول على تفاصيل المكان
• استخدام ميزة "الإكمال التلقائي للأماكن"