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

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

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

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

• يتم تحديد القناة الأسبوعية باستخدام v=weekly.
  يتم تحديث هذه القناة مرة واحدة في الأسبوع، وتعد الأحدث.
• يتم تحديد القناة الربع سنوية باستخدام v=quarterly.
  يتم تعديل هذه القناة مرّة واحدة كل ربع سنة، وهي الأكثر توقعًا.
• يتم تحديد القناة التجريبية باستخدام v=beta.
  تستند هذه القناة إلى قناة weekly، ويتم تحديثها مرة واحدة في الأسبوع. ويشمل ذلك تغييرات إضافية للاختبار المبكر والتعليقات.
• قناة ألفا محددة بـ v=alpha.
  تستند هذه القناة إلى قناة beta، ويتم تحديثها مرة واحدة في الأسبوع. ويشمل ذلك تجارب لتعليقات العملاء على النماذج الأولية.
• يتم تحديد رقم الإصدار باستخدام v=n.nn.
  يمكنك اختيار v=3.52 أو v=3.51 أو v=3.50 أو v=3.49.
  يتم تحديث أرقام الإصدار مرة كل ربع سنة (راجع التحديثات ربع السنوية).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الإصدار 3.53

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

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

الإصدار 3.52

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

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

الإصدار 3.51

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

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

الإصدار 3.50

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

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

الإصدار 3.49

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

دعم الإصدار

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

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

لتصحيح الأخطاء، استخدِم الخاصية 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>

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

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

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

• الإصدار 3.52 مرجع واجهة برمجة التطبيقات (قناة أسبوعية)
• الإصدار 3.51 مرجع واجهة برمجة التطبيقات (قناة ربع سنوية)
• الإصدار 3.50 مرجع واجهة برمجة التطبيقات
• الإصدار 3.49 مرجع واجهة برمجة التطبيقات
• تم حذف الإصدارات من 3.0 إلى 3.48.