يوضّح هذا الدليل العديد من الاستراتيجيات لتحسين استخدامك لواجهات برمجة التطبيقات في "خرائط Google" من حيث الأمان والأداء والاستهلاك.
الأمان
مراجعة أفضل ممارسات الأمان
مفاتيح واجهة برمجة التطبيقات هي بيانات اعتماد خاصة بالمشاريع وتستحق اتّخاذ الاحتياطات نفسها التي تتّخذها بشأن معرّفات المستخدمين وكلمات المرور. راجِع أفضل الممارسات المتعلّقة بأمان واجهات برمجة التطبيقات لحماية مفاتيحك من الاستخدام غير المقصود الذي قد يؤدي إلى استخدام غير مبرّر للحصة وفرض رسوم غير متوقّعة على حسابك.
استخدام مفاتيح واجهة برمجة التطبيقات للوصول إلى واجهات برمجة التطبيقات في "خرائط Google"
مفاتيح واجهة برمجة التطبيقات هي طريقة المصادقة المفضّلة للوصول إلى واجهات برمجة التطبيقات في "خرائط Google". على الرغم من أنّ استخدام معرّفات العملاء لا يزال متاحًا، تتيح مفاتيح واجهة برمجة التطبيقات عناصر تحكّم أكثر دقة في الأمان ويمكن ضبطها للعمل مع عناوين ويب وعناوين IP وحِزم تطوير البرامج (SDK) للأجهزة الجوّالة (Android وiOS) محدّدة. للحصول على معلومات حول إنشاء مفتاح واجهة برمجة تطبيقات وتأمينه، انتقِل إلى صفحة "استخدام مفتاح واجهة برمجة تطبيقات" لكل واجهة برمجة تطبيقات أو حزمة تطوير برامج. (على سبيل المثال، بالنسبة إلى Maps JavaScript API، انتقِل إلى صفحتها حول استخدام مفتاح API).
الأداء
استخدام خوارزمية الرقود الأسي الثنائي للتعامل مع الأخطاء
إذا واجهت تطبيقاتك أخطاءً بسبب محاولات مفرطة لاستدعاء واجهة برمجة تطبيقات خلال فترة زمنية قصيرة، مثل أخطاء الحصة، ننصحك باستخدام التراجع الأسي للسماح بمعالجة الطلبات. تكون استراتيجية "التمهّل بين عمليات إعادة المحاولة" مفيدة بشكل خاص للأخطاء التي تبدأ بالرقم 500.
على وجه التحديد، يمكنك تعديل وتيرة طلبات البحث. في الرمز، أضِف فترة انتظار تبلغ S ثانية بين طلبات البحث. إذا استمر ظهور خطأ الحصة بعد ذلك، ضاعِف فترة الانتظار ثم أرسِل طلب بحث آخر. واصِل تعديل فترة الانتظار إلى أن يعرض الاستعلام النتائج بدون حدوث خطأ.
إرسال طلبات تفاعل المستخدم عند الطلب
يجب إرسال الطلبات إلى واجهات برمجة التطبيقات التي تتضمّن تفاعلاً من المستخدم عند الطلب فقط.
وهذا يعني انتظار المستخدم النهائي لتنفيذ إجراء (مثل on-click)
لبدء طلب البيانات من واجهة برمجة التطبيقات، ثم استخدام النتائج لتحميل خريطة أو تحديد
وجهة أو عرض المعلومات المناسبة. يؤدي استخدام أسلوب عند الطلب إلى تجنُّب الطلبات غير الضرورية إلى واجهات برمجة التطبيقات، ما يقلّل من استهلاك واجهة برمجة التطبيقات.
تجنُّب عرض محتوى متراكب عند تحرُّك الخريطة
تجنَّب استخدام Draw() لعرض محتوى تراكب مخصّص على خريطة في الوقت نفسه الذي قد ينقل فيه المستخدم الخريطة. بما أنّ الخريطة تتم إعادة رسمها في كل مرة ينقل فيها المستخدم الخريطة، فإنّ وضع محتوى متراكب على الخريطة في الوقت نفسه قد يؤدي إلى تأخير أو تقطّع مرئي. لا تُضِف محتوى متراكبًا أو تزِله من خريطة إلا بعد أن يتوقف المستخدم عن تحريك الخريطة أو تكبيرها أو تصغيرها.
تجنُّب العمليات المكثّفة في طرق Draw
كقاعدة عامة، من الممارسات الجيدة تجنُّب العمليات غير المتعلقة بالرسم والتي تتطلّب أداءً عاليًا في طريقة Draw(). على سبيل المثال، تجنَّب ما يلي في رمز طريقة Draw():
- الاستعلامات التي تعرض كمية كبيرة من المحتوى
- تغييرات كثيرة على البيانات المعروضة
- التلاعب بالعديد من عناصر نموذج تمثيل المستندات (DOM)
يمكن أن تؤدي هذه العمليات إلى إبطاء الأداء وحدوث تأخير أو تقطُّع مرئي عند عرض الخريطة.
استخدام صور نقطية للعلامات
استخدِم صورًا نقطية، مثل الصور بتنسيق PNG .أو JPG.، عند إضافة علامات لتحديد موقع جغرافي على خريطة. تجنَّب استخدام صور Scalable Vector Graphics (SVG)، لأنّ عرض صور SVG قد يؤدي إلى حدوث تأخير عند إعادة رسم الخريطة.
تحسين العلامات
تعمل ميزة التحسين على تحسين الأداء من خلال عرض العديد من العلامات كعنصر ثابت واحد. ويكون ذلك مفيدًا في الحالات التي تتطلّب عددًا كبيرًا من العلامات. تحدّد Maps JavaScript API تلقائيًا ما إذا كان سيتم تحسين العلامة. عندما يكون هناك عدد كبير من العلامات، ستحاول واجهة برمجة التطبيقات JavaScript API في "خرائط Google" عرض العلامات مع تحسينها. لا يمكن تحسين جميع العلامات، ففي بعض الحالات، قد تحتاج Maps JavaScript API إلى عرض العلامات بدون تحسين. إيقاف العرض المحسّن لصور GIF أو PNG المتحركة، أو عندما يجب عرض كل علامة كعنصر DOM منفصل
إنشاء مجموعات لإدارة عرض العلامات
للمساعدة في إدارة عرض العلامات لتحديد المواقع الجغرافية على الخريطة، يمكنك إنشاء مجموعة علامات باستخدام مكتبة Marker Clusterer. تتضمّن مكتبة Marker Clusterer خيارات لما يلي:
- حجم الشبكة لتحديد عدد العلامات التي سيتم تجميعها معًا في مجموعة
- الحد الأقصى للتكبير، لتحديد الحد الأقصى لمستوى التكبير الذي سيتم عرض المجموعة فيه
- مسارات الصور، لصور الرسومات التي سيتم استخدامها كرموز علامات.
مشاهدة المحتوى
للحصول على معلومات حول إدارة تكاليف Google Maps Platform، بما في ذلك إنشاء الميزانيات وتعديل الحصص وتعيين التنبيهات، يُرجى الاطّلاع على إدارة التكاليف.