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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

وبعد منتصف شهر شباط (فبراير)، سيكون بإمكانك تحديد v=3.52 أو v=3.51 أو v=3.50 أو v=3.49.

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

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

مَعَابِل زَينْ

أثّر تحديث على طلبي

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

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

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

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

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

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

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

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

الإشعار بشأن القناة أسبوعيًا

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

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

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

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

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

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

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

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

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

الإصدار 3.52

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

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

الإصدار 3.51

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

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

الإصدار 3.50

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

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

الإصدار 3.49

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

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

الإصدار 3.48

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

دعم الإصدار

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

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

ولتصحيح الأخطاء، استخدِم السمة google.maps.version للحصول على الإصدار الحالي من Maps 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>

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

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

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