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

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

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

قبل استخدام فئة 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");

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