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

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

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

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

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

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

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

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

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

تستند هذه القناة إلى قناة 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>

اختيار قناة الإصدار الأولي

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

تستند هذه القناة إلى قناة 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>

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

لا تحدِّد إصدارًا برقم إلا إذا كنت تختبر تطبيقك وتحدّثه بانتظام. ويعود السبب في ذلك إلى أنّه يتم في النهاية حذف الإصدارات المرقّمة عند إنشاء إصدارات جديدة كل ربع سنة. يمكنك تحديد رقم الإصدار من خلال تحميل 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: 3.65,
  });
  </script>

يمكنك حاليًا تحديد v=3.66 أو v=3.65 أو v=3.64 أو v=3.63.

• يتلقّى الإصدار 3.66 تحديثات أسبوعية تتضمّن ميزات جديدة وإصلاحات للأخطاء وتحسينات في الأداء.
• لا يتلقّى الإصدار 3.65 تحديثات أسبوعية.
• لا يتلقّى الإصدار 3.64 تحديثات أسبوعية.
• لا يتلقّى الإصدار 3.63 تحديثات أسبوعية.
• قد نُجري، من حين لآخر، إصلاحات لأخطاء الأمان في أي إصدار.
• قد نُجري تغييرات غير متوافقة مع الأنظمة القديمة عند إنشاء إصدار جديد.

بعد منتصف نوفمبر، سيكون بإمكانك تحديد v=3.67 أو v=3.66 أو v=3.65 أو v=3.64.

• سيتلقّى الإصدار 3.67 تحديثات أسبوعية تتضمّن ميزات جديدة وإصلاحات للأخطاء وتحسينات في الأداء.
• لن يتلقّى الإصدار 3.66 تحديثات أسبوعية بعد الآن.
• لن يتلقّى الإصدار 3.65 تحديثات أسبوعية بعد الآن.
• لن يتلقّى الإصدار 3.64 تحديثات أسبوعية بعد الآن.
• قد نُجري من حين لآخر إصلاحات لأخطاء الأمان في أي إصدار.
• لن يتوفّر الإصدار 3.63 بعد ذلك. سيتم تجاهل أي محاولة لتحميل هذا الإصدار، وستتلقّى قناتك التلقائية بدلاً من ذلك.

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

تأثّر تطبيقي بتحديث معيّن

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

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

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

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

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

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

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

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