توضّح لك هذه الصفحة كيفية الحصول على مفتاح واجهة برمجة التطبيقات، وتفعيل واجهات برمجة التطبيقات المطلوبة، وتحميل "مكتبة الأماكن" لكي تتمكن من العمل مع الفئة "مكان".
الحصول على مفتاح واجهة برمجة التطبيقات وتفعيل واجهات برمجة التطبيقات المطلوبة
قبل استخدام فئة المكان، تحتاج إلى:
- أنشِئ مشروعًا على السحابة الإلكترونية باستخدام حساب فوترة.
- احصل على مفتاح واجهة برمجة التطبيقات.
- تفعيل واجهات برمجة التطبيقات التالية:
- Maps JavaScript API
- واجهة برمجة تطبيقات الأماكن
- Places API (جديدة) (مطلوبة لاستخدام البحث النصي (جديد))
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.
الحصول على مفتاح واجهة برمجة التطبيقاتتحميل مكتبة الأماكن
لتحميل مكتبة الأماكن، عليك أولاً تحميل واجهة برمجة تطبيقات 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");