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