إذا كنت تطوّر مكوّنًا إضافيًا من "منصة خرائط Google" لمنصات مثل WordPress وShopify وMagento وغيرها، يوضّح هذا الموضوع كيفية إعداد مكوّنات إضافية بسرعة لمستخدمي "منصة خرائط Google" وإنشاء مفتاح واجهة برمجة تطبيقات.
يرتبط مفتاح واجهة برمجة التطبيقات، الذي يحتاجه المكون الإضافي لإرساله مع كل طلب إلى منصة خرائط Google، بحساب Google للمستخدم ومعلومات الفوترة ويتيح الوصول إلى ميزات بناء الخرائط في المكون الإضافي.
لمساعدة مستخدمي المكوّنات الإضافية في إنشاء مفتاح واجهة برمجة تطبيقات بسرعة، قدِّم رابطًا أو زرًا يشغِّل أداة البدء السريع، وهي نافذة منبثقة ملائمة توجِّه المستخدمين خلال بضع خطوات بسيطة. تحتفظ أداة البدء السريع أيضًا بمستخدمي المكوّنات الإضافية في منصتك بدلاً من إرسالها إلى Google Cloud Console لتنفيذ هذه المهام في نوافذ متعددة.
تشغيل أداة البدء السريع
أداة البدء السريع هي مجرد صفحة ويب يمكنك التحكّم في حجم نافذتها من خلال استدعاء JavaScript window.open. مثلاً:
<script>
function openPopupWindow() {
var winWidth=570;
var winHeight=700;
var left = (screen.width-winWidth)/2;
var top = (screen.height-winHeight)/2;
window.open('https://console.cloud.google.com/google/maps-hosted', 'Quick Start Widget',
'resizable=yes,width='+winWidth+',height='+winHeight+',left='+left+',top='+top);
return false;
}
</script>
<!-- CTA to generate Google Maps API Key -->
<button type="button" onClick="openPopupWindow()" style="color: white; background-color: #1a73e8" href="#">
Get an API Key
</button>
قصص نجاح:
عندما ينقر أحد المستخدمين على الزر، يتم فتح أداة البدء السريع في نافذة منبثقة، وتُنفِّذ ما يلي أثناء انتقال المستخدم عبر الأداة:
- ينشئ حسابًا ومشروعًا على Google، إذا لم يكن لدى المستخدم ذلك بالفعل.
- تفعِّل واجهات برمجة التطبيقات في Google Maps Platform API.
- تنشئ مفتاح واجهة برمجة التطبيقات للمستخدمين لنسخه ولصقه في إعداد المكوّن الإضافي.
إذا كان لدى مستخدم المكوّن الإضافي حساب ومشروع على Google من قبل، ستنقله الأداة إلى صفحة "بيانات الاعتماد" في Google Cloud Console حيث يمكنه الحصول على مفتاح واجهة برمجة تطبيقات حالي أو إنشاء مفتاح جديد.
يمكنك توجيه مستخدمي المكوّن الإضافي إلى موضوع لمحة عن أداة البدء السريع للحصول على مزيد من المعلومات.
الأسئلة الشائعة
هل يتعيّن عليّ الدفع مقابل استخدام أداة البدء السريع؟
لا، أداة البدء السريع مجانية ومتاحة لجميع المطورين لتبسيط عملية إعداد "منصة خرائط Google".
هل يمكن استخدام أداة البدء السريع على WordPress وShopify فقط؟
يمكن استخدام أداة البدء السريع على أي موقع إلكتروني تابع لجهة خارجية، وليس فقط في أدوات إنشاء المواقع الإلكترونية أو مواقع التجارة الإلكترونية.
هل يمكن للمنصة التابعة لجهة خارجية الاطّلاع على معلومات الفوترة التي يُدخلها المستخدم؟
بعد المصادقة باستخدام Google، لن يتمكن أحد سوى المستخدمين من الوصول إلى معلومات الفوترة والمعلومات الأخرى. لا يمكن لمطوّري البرامج والمكوّنات الإضافية التابعة لجهات خارجية الوصول إلى هذه المعلومات.
هل يمكنني استخدام مشروعي الحالي ومفتاح واجهة برمجة التطبيقات؟
إذا كان لديك حساب حالي على "منصة خرائط Google"، سيعيدك تطبيق Quick Start مصغّر إلى Google Cloud Console حيث يمكنك استخدام مفتاح واجهة برمجة تطبيقات حالي أو إنشاء مفتاح جديد.
كيف يحمي مستخدمو المكوّنات الإضافية مفاتيح واجهة برمجة التطبيقات؟
يوفّر موضوع أفضل ممارسات أمان واجهة برمجة التطبيقات إرشادات حول تأمين مفتاح واجهة برمجة التطبيقات. بعد استخدام أداة البدء السريع، يتلقّى المستخدمون أيضًا رسالة إلكترونية تتضمّن تعليمات ورابطًا إلى Google Cloud Console لتأمين مفتاح واجهة برمجة التطبيقات.