تحديد الإصدارات

اختيار القناة الأسبوعية

بالنسبة إلى معظم الطلبات، ننصحك باستخدام القناة الأسبوعية. هذه هي يتضمّن أحدث إصدار ومحدّث ويحتوي على آخر إصلاحات الأخطاء وتحسينات في الأداء. يمكنك تحديد القناة الأسبوعية من خلال تحميل Maps JavaScript API باستخدام ما يلي علامة البرنامج النصي:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

حاليًا، القناة الأسبوعية هي الإصدار 3.58. يتم تحديث هذا الإصدار أسبوعيًا بميزات جديدة وإصلاحات للأخطاء وتحسينات في الأداء.

وفي منتصف تشرين الثاني (نوفمبر)، سيتم تحديث القناة الأسبوعية إلى الإصدار 3.59. وفي ذلك الوقت، قد لا وإزالة الميزات المتوقّفة نهائيًا، و/أو إدخال حالات عدم التوافق مع الأنظمة القديمة.

اختيار القناة الربع سنوية

وقد تستفيد بعض التطبيقات من الحصول على تحديثات أقل ولكن أكبر، وإمكانية التنبؤ. يجب أن تستخدم هذه التطبيقات القناة ربع السنوية. استخدام هذه الطريقة إذا كنت تريد تلقّي إصلاحات للأخطاء وتحسينات على الأداء في الوقت المتوقّع (اطّلِع على التحديثات الربع سنوية). يمكنك تحديد القناة الربع سنوية عن طريق تحميل Maps JavaScript API مع ما يلي علامة البرنامج النصي:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

وفي الوقت الحالي، الإصدار 3.57 هو القناة ربع السنوية. خلال ربع السنة، لا يتلقّى هذا الإصدار ميزات جديدة أو إصلاحات للأخطاء أو تحسينات في الأداء. قد نعمل من حين لآخر على توفير إصلاحات لأخطاء الأمان في هذا الإصدار.

وفي منتصف تشرين الثاني (نوفمبر)، سيتم تحديث القناة الربع سنوية إلى الإصدار 3.58. في ذلك الوقت، سيتضمن الإصدار الجديد ميزات جديدة، وسيزيل الميزات المتوقّفة، و/أو نتج عنها حالات عدم توافق مع الإصدارات السابقة من الأشهر الثلاثة الماضية.

اختيار القناة التجريبية

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

تعتمد هذه القناة على قناة "weekly"، ويتم تعديلها مرة واحدة في الأسبوع.

يمكنك تحديد القناة التجريبية من خلال تحميل Maps JavaScript API باستخدام النص البرمجي التالي العلامة:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

اختيار قناة ألفا

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

تعتمد هذه القناة على قناة "beta"، ويتم تعديلها مرة واحدة في الأسبوع.

يمكنك تحديد القناة الأولية عن طريق تحميل Maps JavaScript API باستخدام النص البرمجي التالي العلامة:

  <script async
      src="https://maps.googleapis.com/maps/api/js?v=alpha
          &key=YOUR_API_KEY&callback=initMap">
  </script>
  

اختيار رقم الإصدار

يُرجى تحديد إصدار حسب الرقم فقط في حال اختبار التطبيق وتحديثه بانتظام. يرجع ذلك إلى أنه يتم حذف النُسخ المرقّمة في النهاية عند إنشاء نُسخ جديدة كل ربع سنة. يمكنك تحديد رقم الإصدار من خلال تحميل Maps JavaScript API مع علامة النص البرمجي التالية:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.57
        &key=YOUR_API_KEY&callback=initMap">
</script>

في الوقت الحالي، يمكنك تحديد v=3.58, v=3.57, v=3.56، أو v=3.55

• يتلقّى الإصدار 3.58 تحديثات أسبوعية تتضمّن ميزات جديدة وإصلاحات للأخطاء تحسينات في الأداء.
• لا يتلقّى الإصدار 3.57 تحديثات أسبوعية.
• لا يتلقّى الإصدار 3.56 تحديثات أسبوعية.
• لا يتلقّى الإصدار 3.55 تحديثات أسبوعية.
• قد نعمل على إجراء إصلاحات لأخطاء الأمان من حين لآخر. في أي إصدار.
• قد نقدم تغييرات غير متوافقة مع الإصدارات القديمة عند إنشاء إصدار جديد.

بعد منتصف تشرين الثاني (نوفمبر)، ستتمكن من تحديد v=3.59, v=3.58, v=3.57، أو v=3.56

• سيحصل الإصدار 3.59 على تحديثات أسبوعية تتضمّن ميزات جديدة وإصلاحات للأخطاء تحسينات في الأداء.
• لن يتلقّى الإصدار 3.58 تحديثات أسبوعية بعد الآن.
• لن يتلقّى الإصدار 3.57 تحديثات أسبوعية بعد الآن.
• لن يتلقّى الإصدار 3.56 تحديثات أسبوعية بعد الآن.
• قد نعمل على إجراء إصلاحات لأخطاء الأمان من حين لآخر. في أي إصدار.
• لن يكون الإصدار 3.55 متاحًا بعد الآن. أي محاولة لتحميل هذا الإصدار فسيتم تجاهلها وستحصل على قناتك الافتراضية بدلاً منها.

يوضّح المخطّط أدناه الإصدارات التي ستكون متاحة في كل قناة. خلال العام المقبل.

أثّر تحديث في تطبيقي.

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

كحل بديل مؤقت، يمكنك إعادة ضبط التطبيق لاستخدام إصدار أقدم.

1. افتح وحدة التحكم في أدوات مطوّري البرامج في المتصفح، وانظر إلى قيمة google.maps.version
2. تعديل علامة النص البرمجي التي تحمِّل واجهة برمجة التطبيقات طلب رقم إصدار أقدم.
   على سبيل المثال، إذا كانت قيمة google.maps.version هي "3.58.2"، استخدِم v=3.57 في علامة النص البرمجي.
   سيعمل هذا الحل المؤقت لفترة محدودة فقط.

وعند توفُّر الحل المؤقت، سيكون لديك الوقت (عادةً من 3 إلى 6 أشهر) لتنفيذ ما يلي: تحديث تطبيقك، حتى لا يستخدم ميزات وحسابات غير مُوثَّقة أو موقوفة لإصلاح الأخطاء أو إصلاح الأخطاء.

عليك بعد ذلك العودة إلى علامة النص البرمجي الأصلية لتحميل واجهة برمجة التطبيقات.

يمكنك أيضًا إنشاء حالة الدعم أو يُرجى الإبلاغ عن مشكلة.

إشعارات ربع سنوية

يطرح فريق واجهة برمجة تطبيقات JavaScript للخرائط إصدارًا جديدًا كل ربع سنة. ويحدث ذلك في منتصف شهر شباط (فبراير) ومنتصف أيار (مايو) ومنتصف شهر آب (أغسطس) ومنتصف شهر تشرين الثاني (نوفمبر). وسيكون التحديث التالي في منتصف تشرين الثاني (نوفمبر). ستوفر القناة الأسبوعية الجديدة الإصدار 3.59، وسيتم حينها تحديث القنوات الأخرى.