يعمل فريق واجهة برمجة تطبيقات 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
.
يتم تحديث أرقام الإصدار مرة كل ربع سنة (راجع التحديثات ربع السنوية).
إذا لم تحدد قناة أو إصدارًا بشكل صريح، فستتلقى القناة الأسبوعية بشكل افتراضي. في حال نقل القناة من الخطة المميّزة ولم تحدد قناة أو إصدارًا بشكل صريح، ستتلقّى القناة الربع سنوية تلقائيًا. إذا حددت إصدارًا غير صالح، فستتلقى قناتك الافتراضية.
اختيار القناة الأسبوعية
بالنسبة إلى معظم التطبيقات، نقترح القناة الأسبوعية. وهذا الإصدار هو الأحدث وأحدث إصدار ويحتوي على أحدث إصلاحات الأخطاء وتحسينات الأداء. يمكنك تحديد القناة الأسبوعية عن طريق تحميل واجهة برمجة تطبيقات JavaScript للخرائط باستخدام علامة النص البرمجي التالية:
<script async
src="https://maps.googleapis.com/maps/api/js?v=weekly
&key=YOUR_API_KEY&callback=initMap">
</script>
في الوقت الحالي، الإصدار 3.52 من القناة الأسبوعية. يتم تحديث هذا الإصدار أسبوعيًا بميزات جديدة، وإصلاحات للأخطاء، وتحسينات في الأداء.
في منتصف أيار (مايو)، سيتم تحديث القناة الأسبوعية إلى الإصدار 3.53. في ذلك الوقت، قد يزيل الإصدار الجديد الميزات التي تم إيقافها و/أو قد يعرض عناصر غير متوافقة مع الإصدارات القديمة.
اختيار القناة الربع سنوية
قد تستفيد بعض التطبيقات من إجراء تعديلات أقل ولكن على نطاق أوسع لأنها توفّر إمكانية توقّع أكبر. ويجب أن تستخدم هذه التطبيقات القناة الربع سنوية. استخدِم هذه الطريقة إذا كنت تريد إصلاح الأخطاء وتحسين الأداء في الوقت المتوقّع (راجع التحديثات ربع السنوية). يمكنك تحديد القناة الربع سنوية من خلال تحميل واجهة برمجة تطبيقات JavaScript للخرائط باستخدام علامة النص البرمجي التالية:
<script async
src="https://maps.googleapis.com/maps/api/js?v=quarterly
&key=YOUR_API_KEY&callback=initMap">
</script>
وحاليًا، تكون القناة ربع السنوية الإصدار 3.51. خلال هذا الربع من السنة، لا يتلقى هذا الإصدار ميزات جديدة أو إصلاحات للأخطاء أو تحسينات في الأداء. قد نُدخل من وقت لآخر إصلاحات لأخطاء الأمان في هذا الإصدار.
في منتصف أيار (مايو)، سيتم تحديث القناة الربع سنوية إلى الإصدار 3.52. وفي ذلك الوقت، سيتضمن الإصدار الجديد ميزات جديدة و/أو يزيل الميزات التي تم إيقافها و/أو يعرض حالات عدم توافق معكوس من الأشهر الثلاثة السابقة.
اختيار القناة التجريبية
استخدم القناة التجريبية لتجربة الميزات والتغييرات الجديدة. الميزات التجريبية مكتملة ولكن قد تواجه بعض المشاكل المعلّقة (يُرجى استخدام أداة تتبّع المشاكل للإبلاغ عن المشاكل وتقديم التعليقات). لا تخضع القناة التجريبية لأي سياسة إيقاف أو اتفاقية مستوى الخدمة، وقد لا تكون بعض التغييرات متوافقة مع الإصدارات السابقة.
تستند هذه القناة إلى قناة weekly
، ويتم تحديثها مرة واحدة في الأسبوع.
يمكنك تحديد القناة التجريبية عن طريق تحميل واجهة برمجة تطبيقات JavaScript للخرائط باستخدام علامة النص البرمجي التالية:
<script async
src="https://maps.googleapis.com/maps/api/js?v=beta
&key=YOUR_API_KEY&callback=initMap">
</script>
اختيار قناة ألفا
استخدم قناة ألفا لتجربة ميزات وتغييرات تجريبية جديدة. يُرجى استخدام أداة تتبّع المشاكل للإبلاغ عن المشاكل وتقديم التعليقات. لا تخضع قناة الإصدار الأولي لأي سياسة إيقاف أو اتفاقية مستوى الخدمة، وقد لا تكون بعض التغييرات متوافقة مع الإصدارات السابقة.
تستند هذه القناة إلى قناة weekly
، ويتم تحديثها مرة واحدة في الأسبوع.
يمكنك تحديد قناة ألفا عن طريق تحميل واجهة برمجة تطبيقات JavaScript للخرائط باستخدام علامة النص البرمجي التالية:
<script async
src="https://maps.googleapis.com/maps/api/js?v=alpha
&key=YOUR_API_KEY&callback=initMap">
</script>
اختيار رقم إصدار
حدِّد الإصدار حسب الرقم فقط في حال اختبار تطبيقك وتحديثه بانتظام. ويرجع ذلك إلى حذف النُسخ المرقّمة في نهاية المطاف عند إنشاء نُسخ جديدة كل ربع سنة. يمكنك تحديد رقم الإصدار بتحميل واجهة برمجة تطبيقات JavaScript للخرائط باستخدام علامة النص البرمجي التالية:
<script async
src="https://maps.googleapis.com/maps/api/js?v=3.51
&key=YOUR_API_KEY&callback=initMap">
</script>
ويمكنك حاليًا تحديد السمة
v=3.52
أو
v=3.51
أو
v=3.50
أو
v=3.49
.
- يتلقى الإصدار 3.52 تحديثات أسبوعية تتضمن ميزات جديدة، وإصلاحات للأخطاء، وتحسينات في الأداء.
- لا يتلقى الإصدار 3.51 تحديثات أسبوعية.
- لا يتلقى الإصدار 3.50 تحديثات أسبوعية.
- لا يتلقى الإصدار 3.49 تحديثات أسبوعية.
- قد نُدخل من وقت إلى آخر إصلاحات لأخطاء الأمان في أي إصدار.
- قد نقدم تغييرات غير متوافقة مع الإصدارات القديمة عند إنشاء إصدار جديد.
وبعد منتصف أيار (مايو)، ستتمكن من تحديد
v=3.53
أو
v=3.52
أو
v=3.51
أو
v=3.50
.
- سيتلقى الإصدار 3.53 تحديثات أسبوعية تتضمن ميزات جديدة، وإصلاحات للأخطاء، وتحسينات في الأداء.
- لن يتلقى الإصدار 3.52 تحديثات أسبوعية بعد الآن.
- لن يتلقى الإصدار 3.51 تحديثات أسبوعية بعد الآن.
- لن يتلقى الإصدار 3.50 تحديثات أسبوعية بعد الآن.
- قد نُدخل من وقت إلى آخر إصلاحات لأخطاء الأمان في أي إصدار.
- لن يكون الإصدار 3.49 متاحًا بعد ذلك. وسيتم تجاهل أي محاولة لتحميل هذه النسخة، وسيتم بدلاً من ذلك استخدام قناتك التلقائية.
يوضّح الرسم البياني التالي الإصدارات التي ستكون متاحة في كل قناة خلال العام المقبل.
أثّر تحديث في طلبي
عند تحديث قنوات الإصدار، يمكن أن يؤثر ذلك في طلبك. وقد يحدث هذا بسبب اعتماد تطبيقك على ميزات غير موثقة أو موقوفة، أو بسبب خطأ أو إصلاح خطأ طرحناه.
وكحل مؤقت، يمكنك إعادة تهيئة تطبيقك لاستخدام إصدار أقدم.
- افتح وحدة التحكم في أدوات مطوّري البرامج في المتصفِّح، واطّلِع على قيمة
google.maps.version
. - عدِّل علامة النص البرمجي التي تحمِّل واجهة برمجة التطبيقات، واطلب رقم إصدار قديمًا.
على سبيل المثال، إذا كانgoogle.maps.version
هو "3.52.2"، استخدِمv=3.51
في علامة النص البرمجي.
سيعمل هذا الحل المؤقت لفترة محدودة فقط.
بعد تطبيق الحل المؤقت، سيكون لديك وقت (عادةً من 3 إلى 6 أشهر) لتحديث التطبيق، بحيث لا يَعُد يستخدم ميزات غير موثَّقة أو تم إيقافها ويهمّل التدقيق في الأخطاء أو إصلاح الأخطاء.
وعليك بعد ذلك العودة إلى علامة النص البرمجي الأصلية لتحميل واجهة برمجة التطبيقات.
ويمكنك أيضًا إنشاء تجربة دعم أو الإبلاغ عن مشكلة.
تحديثات ربع سنوية
يُصدر فريق واجهة برمجة تطبيقات جافا سكريبت للخرائط إصدارًا جديدًا مرة كل ربع سنة. ويحدث ذلك في منتصف شباط (فبراير) ومنتصف أيار (مايو) ومنتصف آب (أغسطس) ومنتصف تشرين الثاني (نوفمبر). سيتم إجراء التحديث التالي في منتصف مايو (أيار). ستقدم القناة الأسبوعية الجديدة الإصدار 3.53، وسيتم عندئذٍ تحديث القنوات الأخرى.
تعديل أسبوعي على القناة
تشير القناة الأسبوعية حاليًا إلى الإصدار 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.