الخطوات الأولى

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

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

قبل استخدام فئة المكان، تحتاج إلى:

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

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

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

تفعيل Places API (ميزة جديدة)

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

لتحميل مكتبة الأماكن، حمّل أولاً واجهة برمجة تطبيقات JavaScript للخرائط عن طريق إضافة برنامج الإقلاع المضمّن في رمز التطبيق، كما هو موضّح في المقتطف التالي:

<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");
  

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

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