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