مكان إدارة معرِّف العميل في Google Cloud Console
تتوفّر وظيفة إدارة معرّف العميل للخطة المميّزة في Cloud Console في أسفل بيانات اعتماد Google Maps Platform في قسم Client ID.
مهام إضافية لإدارة معرِّف العميل، بما في ذلك تفويض عنوان URL وسر توقيع معرِّف العميل إدارة المشروعات، يمكن الوصول إليها على صفحة رقم تعريف العميل، بالنقر على رمز التعديل في أقصى يسار قسم معرِّف العميل.
ملاحظة مهمّة: لم تعُد الخطة المميّزة في "منصة خرائط Google" متاحة من أجل الاشتراك أو جذب عملاء جدد.
ضمان وصول فريقك إلى الموارد الضرورية
استخدام Google Cloud Console
سبب الأهمية: تمنحك Google Cloud Console إمكانية الوصول إلى معلومات مثل تقارير الاستخدام وخلاصات الأخبار وموارد المطوّرين. والأهم من ذلك، تتيح لك Cloud Console يتيح لك تقديم طلبات الحصول على الدعم باستخدام "منصة خرائط Google" فريق الدعم في حال مواجهة أي مشاكل فنية أثناء التطوير أو الإطلاق.
يجب تفعيل إمكانية الوصول إلى Cloud Console قبل الإطلاق لجميع المطورين المسؤولين عن صيانة التطبيق. في حال حذف كنت تواجه مشكلات فنية، سيتيح الوصول إلى Cloud Console أعضاء فريقك للاتصال بالدعم أيضًا السماح لفريق الدعم بالتواصل مع الأطراف المعنية المناسبين في التنظيم. مثلاً، قد يحتاج فريق الدعم إلى التواصل مع إذا اكتشفنا حركة مرور أو سلوك غير طبيعي يمكن أن ينتهي تقسيم تطبيقك. ضمان إمكانية التواصل مع الجهة المعنية هو الفرق بين حدوث انقطاع غير متوقع في الخدمة ومنع انقطاع الخدمة.
الاشتراك في مجموعات الإشعارات عبر البريد الإلكتروني
سبب الأهمية: لضمان الاطّلاع على آخر التطورات والتغييرات عبر واجهات برمجة تطبيقات الخرائط، فإننا نوصي بالاشتراك في واحد أو أكثر لمجموعات البريد الإلكتروني التالية:
- google-maps-platform-notifications - آخر الأخبار الفنية عن واجهات برمجة التطبيقات في "منصة خرائط Google" وخدمات الويب وإشعارات انقطاع الخدمة والإشعارات عن ميزات المنصة (حوالي 3 إلى 5 رسائل في الشهر)
- google-maps-js-api-v3-notify - إصدارات جديدة من واجهة برمجة تطبيقات JavaScript لخرائط Google (حوالي 4 رسائل سنويًا).
تحسين تطبيقك
ضبط جدار حماية للسماح بالوصول إلى "منصة خرائط Google" خدمات
سبب أهميتها: تستخدم خدمات "منصة خرائط Google" مجموعة متنوعة
من النطاقات التي لا ينتمي بعضها إلى *google.com
مجالك. إذا كان لديك جدار حماية مقيّد، فمن المهم السماح بالوصول إلى
والنطاقات التي تستخدمها كل خدمة من خدمات واجهة برمجة تطبيقات الخرائط. إذا كان جدار الحماية لا يسمح بالوصول إلى هذه النطاقات،
ولن تنجح طلبات البيانات من واجهة برمجة التطبيقات، ما قد يؤدي إلى إيقاف تطبيقاتك. يمكنك الاطّلاع على
القائمة الكاملة للنطاقات التي يستخدمها
Maps API.
ولا ننصح بإدارة قيود جدار الحماية عن طريق عنوان IP، لأنّ عناوين IP المرتبطة بهذه النطاقات غير ثابتة.
ملاحظة: تستخدم خدمات "منصة خرائط Google" المنفذين 80 (http) و443 (https) من أجل حركة البيانات الواردة والصادرة. تتطلب هذه الخدمات أيضًا GET وPOST وPUT وDELETE و طلبات الرأس. ضبط جدار الحماية للسماح بالزيارات عبر هذه المنافذ والسماح اعتمادًا على واجهة برمجة التطبيقات وحالة الاستخدام.
تفويض نطاقات طبقة المقابس الآمنة للاستخدام مع واجهة برمجة تطبيقات JavaScript للخرائط
سبب الأهمية: عند استخدام واجهة برمجة تطبيقات JavaScript للخرائط
مع نطاق طبقة المقابس الآمنة، فمن الضروري أن يكون لديك
مفوَّض
نطاقات HTTPS لديك لضمان عدم رفض طلباتك. ملاحظة
أن تفويض http://yourdomain.com لا يؤدي تلقائيًا
لتفعيل مكافئ طبقة المقابس الآمنة (SSL)، https://yourdomain.com. التحقُّق من الإجابة
قائمة النطاقات المسموح بها في
Cloud Console من خلال التمرير لأسفل إلى
قسم معرّف العميل. لتحديد وحلّ الأخطاء المرتبطة باستخدام واجهات برمجة التطبيقات من جهة العميل
باستخدام نطاق طبقة المقابس الآمنة (SSL)، تأكّد من تحميل أيّ عناصر في صفحتك عبر HTTP. عرض
دليل تحديد وحلّ مشاكل المصادقة
اختيار إصدار واجهة برمجة التطبيقات المناسب
سبب أهميته: قبل تطوير تطبيقك، من المهم أن تعرف إصدارات واجهات برمجة التطبيقات التي تم إيقافها. الاختيار في التطوير مقابل إصدارات غير موقوفة من واجهات برمجة التطبيقات سيوفّر لك وقت التطوير والتكلفة طوال العملية بمجرد أن تصبح الإصدارات المتوقّفة نهائيًا غير متاح.
وعلى وجه الخصوص، من الأهمية بمكان فهم مخطط الإصدارات التي يستخدمها واجهة برمجة تطبيقات JavaScript للخرائط، وذلك حتى تتجنب استخدام إصدار غير ملائم من واجهة برمجة التطبيقات في بيئتك عن طريق الخطأ.
على سبيل المثال، قد يكون من المناسب استخدام ميزة تجريبية من واجهة برمجة التطبيقات في بيئة التطوير أو الاختبار، ولكننا عدم تشجيع استخدام الإصدار التجريبي في بيئة إنتاج. لا تسري اتفاقية مستوى الخدمة إلا على الإصدارات الثابتة من واجهة برمجة التطبيقات، لذا يجب استخدام إصدارات مستقرة في بيئة الإنتاج.
اطّلِع على دليل واجهة برمجة تطبيقات JavaScript للخرائط الإصدارات.
الاختيار بين التصميم من جهة العميل والخادم
سبب الأهمية: اختيار حساب من جهة العميل أو من جهة الخادم قرار معماري مهم وهو أمر بالغ الأهمية استقرار وقابلية تطوير التطبيق. بشكل عام، يُطلق على جانب الخادم للمعالجة السابقة واللاحقة للسجلات بلا اتصال بالإنترنت (أي خارج نطاق تطبيقك). بدلاً من ذلك، يمكن استخدام نهج جانب العميل أن يتم استخدامه لأجزاء التطبيقات التي تتفاعل مع المستخدمين لديك (أي معالجة الطلبات التي يرسلها المستخدمون في الوقت الفعلي).
نشر منهج من جانب الخادم حيث ينبغي للنهج من جانب العميل استخدامها بدلاً من ذلك هو السبب الرئيسي لتجاوز الحصص، وبالتالي التطبيقات المعطلة. ننصحك بشدة باستشارة الترميز الجغرافي الاستراتيجيات قبل تصميم أو إطلاق التطبيقات التي تعتمد على من جهة الخادم.
تحسين استخدام الحصة
سبب الأهمية: فهم طريقة استهلاك تطبيقك تساعدك، المعروفة باسم أرصدة واجهات برمجة تطبيقات الخرائط، على تقليل المبلغ الذي تدفعه. بالنسبة على سبيل المثال، إذا كنت تستخدم واجهة برمجة تطبيقات JavaScript للخرائط، التطبيق استخدام أرصدة واجهات برمجة تطبيقات الخرائط لكل تحميل الخريطة. اطّلِع على دليل الخطة المميّزة ومعدلات الاستخدام وحدوده القصوى.
إدارة استخدام حصة خدمات الويب
قبل إطلاق الخدمة، من الضروري أن تفهم
الأخطاء المختلفة المتعلقة بالحصص
(مثل OVER_QUERY_LIMIT، User Rate Limit
Exceeded)، وإعداد المنطق المناسب في تطبيقك حتى تتمكن
للاستجابة لهذه الأخطاء عند تجاوز حصتك. يُرجى البدء بالقراءة
الأسئلة الشائعة حول حدود الاستخدام.
للحصول على معلومات حول رموز الحالة التي تعرضها كل واجهة برمجة تطبيقات، يمكنك الرجوع إلى
دليل المطور لواجهة برمجة التطبيقات هذه. على سبيل المثال، راجع دليل
رموز حالة واجهة برمجة التطبيقات للاتجاهات
سيؤدي فهم هذه المفاهيم وتنفيذها إلى تقليل فرص
من تطبيقك يتجاوز حصته المسموح بها أو حظره بواسطة Google
و/أو الانقطاع.
إجراء اختبار لالتحميل على تطبيقك
سبب أهميته: يمكنك استخدام اختبار تحميل تطبيقك للتأكد من أنه بإمكانه معالجة أعداد كبيرة من الطلبات دون تجاوز حصصك واجهات برمجة التطبيقات للخرائط.
وعلى الرغم من أن "منصة خرائط Google" يمكن أن تتعامل مع أعداد كبيرة جدًا من الزيارات، إلا أن إجراء الاختبار مقارنةً بالبث المباشر سيؤدي ذلك إلى تجاوز تطبيقك للحصة المسموح بها، وربما حظره من قِبل Google وتتحمل أيضًا مسؤولية رسوم الاستخدام التي تكبدها اختبار التحميل.
فبدلاً من ذلك، يجب أن يتأكد تحميل اختبار التطبيق من قدرة التطبيق على التعامل مع أعداد كبيرة من الطلبات بدون تجاوز حصصك لواجهات برمجة تطبيقات الخرائط أو حظره من قِبل Google ولتحقيق ذلك بأمان، عليك إجراء اختبار حِمل على نموذج تجريبي (زائف) وواجهة برمجة التطبيقات (API) - وهي خدمة يمكنها استيعاب أعداد كبيرة من الطلبات - والرد على ذات ردود صالحة، بدون تضمين "منصة خرائط Google". مثال: إذا كانت حصتك من واجهة برمجة التطبيقات Geocoding API هي 3000 QPM (عدد الطلبات في الدقيقة)، تحميل اختبار يجب أن يتأكد التطبيق من قدرة التطبيق على التعامل مع حجم أكبر، مثل 90000 QPM بدون إرسال أكثر من 3000 وحدة QPM إلى واجهة برمجة تطبيقات Geocoding API.
إذا كنت تخطط لإجراء اختبار تحميل كبير، يُرجى التواصل مع فريق الدعم فريق الدعم في Google للحصول على الإرشادات وضمان معرفة Google للاختبار المخطط له.