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

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

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

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

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

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

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

بالنسبة إلى معظم الطلبات، ننصحك باستخدام القناة الأسبوعية. هذه هي يتضمّن أحدث إصدار ومحدّث ويحتوي على آخر إصلاحات الأخطاء وتحسينات في الأداء. يمكنك تحديد القناة الأسبوعية من خلال تحميل 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 متاحًا بعد الآن. أي محاولة لتحميل هذا الإصدار فسيتم تجاهلها وستحصل على قناتك الافتراضية بدلاً منها.

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

v=weekly v=ربع سنوي v=3.nn v=3.nn-1 أغسطس 2024 نوفمبر 2024 شباط (فبراير) 2025 أيار (مايو) 2025 v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

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

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

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

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

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

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

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

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

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

التحديث الأسبوعي للقنوات

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

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

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

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

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

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

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

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

وفي منتصف تشرين الثاني (نوفمبر)، يتم تمرير أرقام الإصدار لاستيعاب إصدار الإصدار الجديد.

الإصدار 3.59

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

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

الإصدار 3.58

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

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

الإصدار 3.57

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

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

الإصدار 3.56

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

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

الإصدار 3.55

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

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

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

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

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

<!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>

مستندات حول إصدارات واجهة برمجة التطبيقات

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

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