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

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

بالنسبة إلى معظم التطبيقات، ننصح باستخدام القناة الأسبوعية. هذا هو الإصدار الأحدث والأكثر حداثة، ويحتوي على أحدث إصلاحات الأخطاء وتحسينات الأداء. يمكنك تحديد القناة الأسبوعية من خلال تحميل واجهة برمجة التطبيقات 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.59. يتم تحديث هذا الإصدار أسبوعيًا لإضافة ميزات جديدة وإصلاح الأخطاء وتحسين الأداء.

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

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

قد تستفيد بعض التطبيقات من تحديثات أقلّ ولكن أكبر حجمًا، لأنّ ذلك يمنح مزيدًا من إمكانية التوقّع. يجب أن تستخدم هذه التطبيقات القناة الربع سنوية. استخدِم هذا النهج إذا كنت تريد أن تصل إصلاحات الأخطاء وتحسينات الأداء في الوقت المتوقّع (اطّلِع على التحديثات ربع السنوية). يمكنك تحديد القناة ربع السنوية من خلال تحميل واجهة برمجة التطبيقات 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.58 متوفّر في القناة الربع سنوية. خلال هذا الربع، لا يحصل هذا الإصدار على ميزات جديدة أو إصلاحات للأخطاء أو تحسينات في الأداء. يجوز لنا من حين لآخر إدخال إصلاحات للأخطاء الأمنية في هذا الإصدار.

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

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

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

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

يمكنك تحديد القناة التجريبية من خلال تحميل Google 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.58,
  });
  </script>

يمكنك حاليًا تحديد v=3.59 أو v=3.58 أو v=3.57 أو v=3.56.

• يتلقّى الإصدار 3.59 تحديثات أسبوعية تتضمّن ميزات جديدة وإصلاحات للأخطاء و تحسينات في الأداء.
• لا يتلقّى الإصدار 3.58 تحديثات أسبوعية.
• لا يتلقّى الإصدار 3.57 تحديثات أسبوعية.
• لا يتلقّى الإصدار 3.56 تحديثات أسبوعية.
• يجوز لنا من حين لآخر إدخال إصلاحات لأخطاء الأمان في أي إصدار.
• قد نُجري تغييرات غير متوافقة مع الإصدارات السابقة عند إنشاء إصدار جديد.

بعد منتصف شباط (فبراير)، ستتمكّن من تحديد v=3.60 أو v=3.59 أو v=3.58 أو v=3.57.

• سيتلقّى الإصدار 3.60 تحديثات أسبوعية تتضمّن ميزات جديدة وإصلاحات للأخطاء و تحسينات في الأداء.
• لن يتلقّى الإصدار 3.59 تحديثات أسبوعية بعد الآن.
• لن يتلقّى الإصدار 3.58 تحديثات أسبوعية بعد الآن.
• لن يتلقّى الإصدار 3.57 تحديثات أسبوعية بعد الآن.
• يجوز لنا من حين لآخر إدخال إصلاحات لأخطاء الأمان في أي إصدار.
• لن يعود الإصدار 3.56 متاحًا. سيتم تجاهل أي محاولة لتحميل هذا الإصدار ، وستظهر لك قناتك التلقائية بدلاً منه.

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

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

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

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

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

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

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

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

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

يطرح فريق Maps JavaScript API إصدارًا جديدًا مرة واحدة كل ربع سنة. ويحدث ذلك في منتصف شباط (فبراير) وأيار (مايو) وأغسطس (آب) وتشرين الثاني (نوفمبر). سيكون التحديث التالي في منتصف شباط (فبراير). ستوفّر القناة الأسبوعية الجديدة الإصدار 3.60، وسيتم تحديث القنوات الأخرى في ذلك الوقت.