إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية التفعيل في وقت سابق، يُرجى الاطّلاع على نمط خريطة جديد لـ "منصة خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

يتم تحديد القناة الأسبوعية باستخدام 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>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>

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

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

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

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

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

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

ننصحك في أوائل تشرين الثاني (نوفمبر) باختبار تطبيقك باستخدام v=3.58.

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

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

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

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </script>

اختيار قناة الشفافية

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

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

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </script>

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

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.57,
  });
  </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=3.56 أو v=3.55، ننصحك بالترقية إلى v=3.58 أو v=3.57 قبل منتصف تشرين الثاني (نوفمبر). عند التبديل بين الإصدارات، تذكَّر أنّ الإصدارات الأحدث قد تزيل الميزات المتوقّفة نهائيًا، و/أو قد تؤدي إلى عدم التوافق مع الإصدارات القديمة.

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

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

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

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

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

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

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

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

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

يطرح فريق Maps JavaScript API إصدارًا جديدًا مرة واحدة كل ربع سنة. ويحدث ذلك في منتصف شهر شباط (فبراير) ومنتصف أيار (مايو) ومنتصف شهر آب (أغسطس) ومنتصف شهر تشرين الثاني (نوفمبر). سيكون التحديث التالي في منتصف تشرين الثاني (نوفمبر). ستوفّر القناة الأسبوعية الجديدة الإصدار 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 للحصول على الإصدار الحالي من واجهة برمجة التطبيقات 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.58 من واجهة برمجة التطبيقات المرجعي (قناة أسبوعية)
مرجع واجهة برمجة التطبيقات للإصدار 3.57 (القناة ربع السنوية)
مرجع واجهة برمجة التطبيقات للإصدار 3.56
مرجع واجهة برمجة التطبيقات للإصدار 3.55
تم حذف الإصدارات من 3.0 إلى 3.54.