قائمة تحقق الإطلاق التجريبي

مكان إدارة معرِّف العميل في Google Cloud Console

تتوفر وظيفة إدارة معرِّف العميل للخطة المميزة في Cloud Console أسفل صفحة بيانات الاعتماد في "منصة خرائط Google" ضمن قسم معرّف العميل.

يمكن الوصول إلى مزيد من مهام إدارة معرِّف العميل، بما في ذلك إدارة تفويض عنوان URL وتوقيع سر معرِّف العميل، في صفحة معرِّف العميل المنفصلة، من خلال النقر على رمز تعديل في أقصى يسار قسم معرِّف العميل.

ملاحظة مهمة: لم تعد الخطة المميّزة في "منصة خرائط Google" متاحة للاشتراك أو للعملاء الجدد.

التأكد من أن فريقك لديه إمكانية الوصول إلى الموارد اللازمة

استخدام Google Cloud Console

سبب الأهمية: تمنحك Google Cloud Console إمكانية الوصول إلى معلومات مثل تقارير الاستخدام وخلاصات الأخبار ومراجع المطوّرين. والأهم من ذلك، أنّ Cloud Console تسمح لك بإرسال طلبات الحصول على الدعم إلى فريق دعم "منصة خرائط Google" في حال واجهتك أي مشاكل فنية أثناء عملية التطوير أو الإطلاق.

قبل الإطلاق، يُرجى تفعيل إمكانية وصول جميع المطوّرين المسؤولين عن صيانة تطبيقك إلى Cloud Console. إذا كنت تواجه مشاكل فنية، سيسمح الوصول إلى Cloud Console لأعضاء فريقك بالتواصل مع فريق الدعم وسيتيح أيضًا لفريق الدعم لدينا التواصل مع الجهات المعنية المناسبة في مؤسستك. على سبيل المثال، قد يحتاج فريق الدعم إلى التواصل مع مؤسستك إذا اكتشفنا سلوكًا أو زيارات غير طبيعية قد تؤدي إلى تعطُّل تطبيقك. ومع ذلك، فإنّ ضمان إمكانية التواصل مع المطوّرين المعنيّين قد يمثل الفرق بين حدوث انقطاع في الخدمة بشكل غير متوقع ومنع حدوث انقطاع فيه.

الاشتراك في مجموعات الإشعارات عبر البريد الإلكتروني

سبب الأهمية: للبقاء على اطّلاع على آخر التطورات والتغييرات على مستوى واجهات API للخرائط، ننصحك بالاشتراك في مجموعة واحدة أو أكثر من مجموعات البريد الإلكتروني التالية:

• google-maps-platform-notifications - تعديلات فنية حول واجهات برمجة تطبيقات "منصة خرائط Google" وخدمات الويب، وإشعارات بشأن انقطاع الخدمة، وإشعارات ميزات المنصة (من 3 إلى 5 رسائل تقريبًا في الشهر).
• google-maps-js-api-v3-notify - إصدارات جديدة من Google Maps JavaScript API (حوالي 4 رسائل سنويًا).

تحسين تطبيقك

ضبط جدار حماية للسماح بالوصول إلى خدمات "منصة خرائط Google"

سبب أهمّيتها: تستخدم خدمات "منصة خرائط Google" مجموعة متنوعة من النطاقات، لا ينتمي بعضها إلى النطاق *google.com. إذا كان الجدار الناري مقيدًا، من المهم السماح بالوصول إلى النطاقات التي تستخدمها كل خدمة من خدمات API للخرائط. وإذا كان جدار الحماية لا يسمح بالوصول إلى هذه النطاقات، لن تنجح طلبات البيانات من واجهة برمجة التطبيقات، ما قد يؤدي إلى إيقاف تطبيقاتك. يمكنك الاطّلاع على قائمة كاملة بالنطاقات التي تستخدمها واجهات API للخرائط.

لا ننصح بإدارة قيود جدار الحماية حسب عنوان IP، لأنّ عناوين IP المرتبطة بهذه النطاقات ليست ثابتة.

ملاحظة: تستخدم خدمات "منصة خرائط Google" المنفذ 80 (http) و443 (https) لحركة البيانات الواردة والصادرة. وتتطلّب هذه الخدمات أيضًا طلبات GET وPOST وPUT وDELETE وHEAD. يمكنك ضبط جدار الحماية للسماح بالزيارات عبر هذه المنافذ والسماح بالطلبات بناءً على واجهة برمجة التطبيقات وحالة الاستخدام.

تفويض نطاقات طبقة المقابس الآمنة (SSL) للاستخدام مع Maps JavaScript API

سبب الأهمية: عند استخدام Maps JavaScript API مع نطاق طبقة المقابس الآمنة (SSL)، من الضروري أن يتم تفويض نطاقات HTTPS بشكل صريح لضمان عدم رفض طلباتك. يُرجى العِلم أنّ تفويض http://yourdomain.com لا يفعِّل تلقائيًا مكافئ طبقة المقابس الآمنة https://yourdomain.com. راجِع قائمة النطاقات المُصرّح بها في Cloud Console من خلال الانتقال للأسفل إلى قسم Client-ID. لتحديد وحلّ الأخطاء المرتبطة باستخدام واجهات برمجة التطبيقات من جهة العميل مع نطاق طبقة المقابس الآمنة (SSL)، تحقَّق مما إذا تم تحميل أي عناصر من صفحتك عبر HTTP. اطّلِع على دليل تحديد وحلّ المشاكل المتعلّقة بالتفويض.

ملاحظة: في حال إيقاف معرِّف العميل مؤقتًا وتركه تنتهي صلاحيته، لن يظهر قسم معرِّف العميل بعد ذلك في صفحة بيانات الاعتماد على Cloud Console.

اختيار إصدار واجهة برمجة التطبيقات المناسب

سبب الأهمية: قبل تطوير تطبيقك، من المهم معرفة إصدارات واجهات برمجة التطبيقات التي تم إيقافها نهائيًا. إنّ اختيار التطوير باستخدام إصدارات غير متوقّفة من واجهات برمجة التطبيقات سيوفّر لك وقت التطوير والتكلفة إلى الأسفل عندما تصبح الإصدارات المتوقّفة غير متوفّرة.

وعلى وجه الخصوص، من المهم فهم مخطط تحديد الإصدارات الذي تستخدمه واجهة برمجة تطبيقات JavaScript للخرائط لكي تتجنّب استخدام إصدار غير ملائم من واجهة برمجة التطبيقات في بيئتك عن طريق الخطأ.

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

اطّلِع على دليل إصدارات JavaScript API للخرائط.

الاختيار بين التصميم من جهة العميل والتصميم من جهة الخادم

سبب الأهمية: إنّ اختيار منهج من جهة العميل أو من جهة الخادم هو قرار بنيويًا وضروريًا للغاية لضمان ثبات تطبيقك وقابلية توسّعه. بشكل عام، يجب استخدام أسلوب من جهة الخادم لمرحلة ما قبل معالجة السجلات وبعدها بلا اتصال بالإنترنت (أي خارج تطبيقك). بدلاً من ذلك، يجب استخدام منهج من جهة العميل لأجزاء التطبيقات التي تتفاعل مع المستخدمين (أي معالجة الطلبات التي يرسلها المستخدمون في الوقت الفعلي).

إن نشر نهج من جهة الخادم حيث يجب استخدام نهج من جهة العميل هو السبب الرئيسي لتجاوز الحصص، وبالتالي تعطُّل التطبيقات. وننصحك بشدة بالرجوع إلى استراتيجيات الترميز الجغرافي قبل تصميم أو إطلاق تطبيقات تعتمد على طلبات من جهة الخادم.

تحسين استخدام الحصة

سبب الأهمية: يساعدك فهم الطريقة التي يستهلك بها تطبيقك الحصة، والتي تُعرف باسم أرصدة واجهات برمجة تطبيقات الخرائط، في خفض المبلغ الذي تدفعه. على سبيل المثال، إذا كنت تستخدم Maps JavaScript API، يستهلك تطبيقك أرصدة واجهات برمجة التطبيقات للخرائط لكل تحميل للخريطة. راجِع دليل معدلات استخدام الخطة المميّزة وحدودها.

إدارة استخدام حصة خدمات الويب

قبل إطلاق الخدمة، من الضروري فهم الأخطاء المختلفة المتعلقة بالحصة (مثل OVER_QUERY_LIMIT وUser Rate Limit Exceeded) وإعداد المنطق المناسب في تطبيقك لتتمكن من الاستجابة لمثل هذه الأخطاء عند تجاوز حصتك. يُرجى البدء بقراءة الأسئلة الشائعة حول حدود الاستخدام. للحصول على معلومات عن رموز الحالة التي تعرضها كل واجهة برمجة تطبيقات، يمكنك الرجوع إلى دليل المطوّر. على سبيل المثال، يمكنك الاطّلاع على دليل رموز الحالة في Directions API. سيؤدي فهم هذه المفاهيم وتطبيقها إلى الحدّ بشكل كبير من احتمالات تجاوز تطبيقك للحصة المسموح بها، و/أو حظره من قِبل Google، و/أو تعطله.

إجراء اختبار تحميل على تطبيقك

سبب الأهمية: استخدِم اختبار تحميل تطبيقك لضمان قدرته على التعامل مع الأعداد الكبيرة من الطلبات بدون تجاوز حصصك في واجهات API للخرائط.

على الرغم من أنّ "منصة خرائط Google" يمكنها التعامل مع أعداد كبيرة جدًا من الزيارات، سيؤدي إجراء اختبار في خدمات Google المباشرة إلى تجاوز تطبيقك الحصة المسموح بها وربما حظره من قِبل Google. كما تقع على عاتقك مسؤولية رسوم الاستخدام الناتجة عن اختبار التحميل.

بدلاً من ذلك، من المفترض أن يضمن اختبار التحميل قدرة تطبيقك على التعامل مع أعداد كبيرة من الطلبات بدون تجاوز حصصك في واجهات API للخرائط أو أن يتم حظر تطبيقك من قِبل Google. ولتحقيق ذلك بأمان، يمكنك إجراء اختبار تحميل باستخدام واجهة برمجة تطبيقات وهمية (مزيّفة)، وهي خدمة يمكنها استيعاب عدد كبير من الطلبات، والردّ على الطلبات بردود صالحة بدون تضمين "منصة خرائط Google". مثال: إذا كانت حصتك من واجهة برمجة التطبيقات للترميز الجغرافي هي 20 طلب بحث في الثانية، من المفترض أن يضمن اختبار التحميل أن يتمكّن تطبيقك من معالجة 600 طلب في الثانية بدون إرسال أكثر من 20 طلب بحث في الثانية إلى واجهة برمجة التطبيقات للترميز الجغرافي.

إذا كنت تخطّط لإجراء اختبار مهم بشكل كبير، يُرجى التواصل مع فريق دعم Google للحصول على إرشادات والتأكّد من أنّ Google على عِلم بالاختبار الذي تخطط له.