تحسين استخدام خدمة الويب

ملاحظة مهمة: لم يعُد "خطة Premium" من Google Maps Platform متاحة للاشتراك أو للعملاء الجدد.

نظرة عامة

إذا تجاوز تطبيقك حدود الاستخدام المسموح بها لخدمة ويب في Google Maps Platform، ستعرض الخدمة رسالة خطأ. إذا استمر تطبيقك في تجاوز حدود الاستخدام، قد يتم حظره من الوصول إلى خدمة الويب، وقد يتلقّى في بعض الحالات الردود "403 Forbidden".

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

قبل البدء

قبل تحسين استخدام خدمة الويب في تطبيقك، تأكَّد من أنّك تستخدم الخدمة الصحيحة لحالة الاستخدام وترخيص واجهات برمجة التطبيقات الصحيح في "خرائط Google".

التحقّق من صحة حالة الاستخدام

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

يُرجى العِلم أنّه في ما يتعلّق بخدمات الويب، ينطبق الحدّ الأقصى لعدد طلبات البحث في الدقيقة على ترخيص خطة Premium، بغض النظر عن عدد عناوين IP التي يتم إرسال الطلبات منها.

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

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

كيفية تحسين استخدام خدمة الويب

لاستخدام خدمات الويب بشكل أكثر كفاءة، يمكنك خفض معدّل الاستخدام من خلال إرسال الطلبات عند الضرورة فقط وتوزيع الاستخدام بالتساوي للحفاظ على معدّله ضمن الحدود المسموح بها.

نتائج ذاكرة التخزين المؤقت

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

يُرجى العِلم أنّ معرّف المكان، المستخدَم لتحديد مكان بشكلٍ فريد، معفى من قيود التخزين المؤقت. وبالتالي، يمكنك تخزين قيم أرقام تعريف الأماكن إلى أجل غير مسمى.

تقييد الطلبات

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

حتى مع الحدّ من عدد الطلبات، قد تستمر التطبيقات في تلقّي ردود برمز الحالة OVER_QUERY_LIMIT. اضبط تطبيقك على إدراج تأخير بسيط (20 ملي ثانية) وحاوِل مرة أخرى إذا تلقّى مثل هذا الرد.