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