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

يُحدِّث فريق واجهة برمجة تطبيقات JavaScript للخرائط بشكلٍ منتظم ميزات جديدة وإصلاحات للأخطاء وتحسينات للأداء. وتوضّح هذه الصفحة إصدارات واجهة برمجة التطبيقات المتاحة للاستخدام في تطبيقاتك.

قنوات الإصدار وأرقام الإصدارات

في تطبيقك، يمكنك تحديد قنوات الإصدار أو أرقام الإصدارات:

  • يتم تحديد القناة الأسبوعية باستخدام v=weekly.
    يتم تحديث هذه القناة مرة واحدة في الأسبوع، وهي القناة الأحدث.
  • يتم تحديد القناة الربع سنوية من خلال v=quarterly.
    يتم تحديث هذه القناة مرة واحدة كل ربع سنة، وهي الأكثر قابلية للتوقّع.
  • يتم تحديد القناة التجريبية باستخدام v=beta.
    تستند هذه القناة إلى قناة "weekly"، ويتم تحديثها مرة واحدة في الأسبوع. ويتضمن تغييرات إضافية للاختبار والملاحظات الأوّلية.
  • ويتم تحديد قناة ألفا باستخدام v=alpha.
    تستند هذه القناة إلى قناة "beta"، ويتم تحديثها مرة واحدة في الأسبوع. ويتضمن تجارب لتقديم ملاحظات العملاء على النماذج الأولية. إنّها لأغراض التطوير فقط ويجب عدم استخدامها في الإنتاج.
  • يتم تحديد رقم الإصدار مع v=n.nn.
    يمكنك اختيار v=3.56 أو v=3.55 أو v=3.54 أو v=3.53.
    يتم تعديل أرقام الإصدارات مرة كل ربع سنة (راجِع التحديثات الربع سنوية).

إذا لم تحدّد قناة أو إصدارًا بشكل صريح، ستتلقّى القناة الأسبوعية تلقائيًا. إذا نقلت بياناتك من الخطة المميّزة ولم تحدّد قناة أو إصدارًا بشكل صريح، ستتلقّى القناة الربع سنوية تلقائيًا. وإذا حدّدت إصدارًا غير صالح، سيتم عرض قناتك التلقائية.

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

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

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

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

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

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

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

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

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

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

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

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

تستند هذه القناة إلى قناة 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.55
        &key=YOUR_API_KEY&callback=initMap">
</script>

في الوقت الحالي، يمكنك تحديد v=3.56 أو v=3.55 أو v=3.54 أو v=3.53.

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

بعد منتصف أيار (مايو)، ستتمكّن من تحديد v=3.57 أو v=3.56 أو v=3.55 أو v=3.54.

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

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

v3.53v3.54v3.54v3.55v3.55v3.55v3.56v3.56v3.56v3.56v3.57v3.57v3.57v3.58v3.58v3.59

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

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

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

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

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

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

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

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

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

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

تشير القناة الأسبوعية حاليًا إلى الإصدار 3.56.

في منتصف أيار (مايو)، سيتم تحديث القناة الأسبوعية من الإصدار 3.56 إلى الإصدار 3.57. في هذه المرحلة، سيتضمن الإصدار الجديد ميزات جديدة و/أو سيزيل الميزات المتوقّفة و/أو سيقدّم نقاطًا غير متوافقة مع الإصدارات السابقة. وقد تحتاج إلى إجراء اختبار للتأكّد من عدم وجود هذه التغييرات بعد إجراء تعديل على القناة.

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

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

وتشير القناة الربع سنوية حاليًا إلى الإصدار 3.55.

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

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

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

وفي منتصف أيار (مايو)، ستتم إضافة أرقام الإصدارات لاستيعاب طرح إصدار جديد.

الإصدار 3.57

سيتم إطلاق الإصدار الجديد 3.57 في منتصف أيار (مايو). بعد طرحه، سيتضمّن هذا الإصدار ميزات جديدة وسيزيل الميزات المتوقّفة نهائيًا و/أو سيقدِّم نقاطًا غير متوافقة مع الإصدارات السابقة مقارنةً بالإصدار 3.56. يجب اختبار تطبيقك عند التغيير بين أرقام الإصدارات.

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

الإصدار 3.56

يتضمّن هذا الإصدار ميزات جديدة ويزيل الميزات المتوقّفة نهائيًا و/أو يوفّر حالات عدم التوافق مع الأنظمة القديمة مقارنةً بالإصدار 3.55. يجب اختبار تطبيقك عند التغيير بين أرقام الإصدارات.

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

الإصدار 3.55

يتضمّن هذا الإصدار ميزات جديدة ويزيل الميزات المتوقّفة نهائيًا و/أو يوفّر حالات عدم التوافق مع الأنظمة القديمة مقارنةً بالإصدار 3.54. يجب اختبار تطبيقك عند التغيير بين أرقام الإصدارات.

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

الإصدار 3.54

يتضمّن هذا الإصدار ميزات جديدة ويزيل الميزات المتوقّفة نهائيًا و/أو يوفّر حالات عدم التوافق مع الأنظمة القديمة مقارنةً بالإصدار 3.53. يجب اختبار تطبيقك عند التغيير بين أرقام الإصدارات.

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

الإصدار 3.53

وبعد منتصف أيار (مايو)، سيتم حذف هذا الإصدار، ولن يمكن استخدامه بعد ذلك. وسيتم تجاهل أي محاولة لتحميل هذه النسخة، وستتمكّن من استخدام قناتك التلقائية بدلاً من ذلك.

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

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

عمليات التحقّق من الإصدارات

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

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

وثائق لإصدارات واجهة برمجة التطبيقات

يصف دليل المطوّر دائمًا الإصدار الأسبوعي.

بالإضافة إلى ذلك، هناك مرجع منفصل لكل إصدار: