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