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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

اختيار قناة الإصدار الأولي

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

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

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

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

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

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

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

يمكنك في الوقت الحالي تحديد v=3.53 أو v=3.52 أو v=3.51 أو v=3.50.

• يتلقّى الإصدار 3.53 تحديثات أسبوعية تشمل ميزات جديدة وإصلاحات للأخطاء وتحسينات في الأداء.
• لا يتلقى الإصدار 3.52 التحديثات الأسبوعية.
• لا يتلقى الإصدار 3.51 التحديثات الأسبوعية.
• لا يتلقى الإصدار 3.50 تحديثات أسبوعية.
• قد نعرض من حين لآخر إصلاح الأخطاء الأمنية في أي إصدار.
• قد نقدِّم تغييرات غير متوافقة مع الأنظمة القديمة عند إنشاء إصدار جديد.

بعد منتصف شهر تموز (يوليو)، ستتمكن من تحديد v=3.54 أو v=3.53 أو v=3.52 أو v=3.51.

• سيتلقّى الإصدار 3.54 تحديثات أسبوعية تشمل الميزات الجديدة وإصلاحات الأخطاء وتحسينات الأداء.
• لن يتلقّى الإصدار 3.53 التحديثات الأسبوعية بعد الآن.
• لن يتلقّى الإصدار 3.52 تحديثات أسبوعية بعد الآن.
• لن يتلقّى الإصدار 3.51 تحديثات أسبوعية بعد الآن.
• قد نعرض من حين لآخر إصلاح الأخطاء الأمنية في أي إصدار.
• لن يتوفّر الإصدار 3.50 بعد ذلك. وسيتم تجاهل أي محاولة لتحميل هذه النسخة، وستتلقّى قناتك التلقائية بدلاً من ذلك.

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

أثّر تحديث في طلبي

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

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

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

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

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

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

تعديلات ربع سنوية

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