حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

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

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

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

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

يتم تحديد القناة الأسبوعية بالرمز v=weekly.
يتم تحديث هذه القناة مرة واحدة في الأسبوع، وهي الأحدث.
يتم تحديد القناة الربع سنوية باستخدام v=quarterly.
يتم تحديث هذه القناة مرة واحدة كل ربع سنة، وهي الأكثر قابلية للتوقّع.
يتم تحديد القناة التجريبية باستخدام v=beta.
تستند هذه القناة إلى قناة weekly، ويتم تعديلها مرة واحدة في الأسبوع. ويتضمّن تغييرات إضافية لاختبار الميزة قبل إطلاقها وجمع الملاحظات.
يتم تحديد قناة ألفا باستخدام v=alpha.
تستند هذه القناة إلى قناة beta، ويتم تعديلها مرة واحدة في الأسبوع. يتضمّن تجارب لجمع ملاحظات العملاء حول النماذج الأولية. وهي مخصّصة لأغراض التطوير فقط ويجب عدم استخدامها في مرحلة الإنتاج.
يتم تحديد رقم الإصدار باستخدام v=n.nn.
يمكنك اختيار v=3.64 أو v=3.63 أو v=3.62 أو v=3.61.
يتم تعديل أرقام الإصدارات مرة واحدة كل ربع سنة (راجِع التحديثات الربع سنوية).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بعد منتصف أيار (مايو)، سيصبح بإمكانك تحديد v=3.65 أو v=3.64 أو v=3.63 أو v=3.62.

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

إذا كنت تستخدم الإصدار v=3.62 أو v=3.61، ننصحك بالترقية إلى الإصدار v=3.64 أو v=3.63 قبل منتصف أيار (مايو). عند التبديل بين الإصدارات، تذكَّر أنّ الإصدارات الأحدث قد تزيل الميزات المتوقّفة نهائيًا، و/أو تتضمّن مشاكل عدم توافق مع الإصدارات السابقة.

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

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

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

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

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

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

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

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

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

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

آخر الأخبار المتعلّقة بقناتك

تشير القناة الأسبوعية حاليًا إلى الإصدار 3.64.

في منتصف شهر مايو، سيتم تعديل القناة الأسبوعية من الإصدار 3.64 إلى الإصدار 3.65. في هذه المرحلة، سيتضمّن الإصدار الجديد ميزات جديدة، وستتم إزالة الميزات المتوقّفة نهائيًا، و/أو سيتم تقديم تغييرات غير متوافقة مع الإصدارات السابقة. وقد تحتاج إلى اختبار هذه التغييرات عند تعديل القناة.

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

إشعار ربع سنوي بشأن القناة

تشير القناة الربع سنوية حاليًا إلى الإصدار 3.63.

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

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

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

في منتصف أيار (مايو)، سيتم إعادة ضبط أرقام الإصدارات لاستيعاب طرح إصدار جديد.

الإصدار 3.65

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

الإصدار 3.64

يتضمّن هذا الإصدار ميزات جديدة ويزيل ميزات تم إيقافها و/أو يقدّم تغييرات غير متوافقة مع الإصدار 3.63. عليك اختبار تطبيقك عند التبديل بين أرقام الإصدارات.

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

الإصدار 3.63

يتضمّن هذا الإصدار ميزات جديدة ويزيل ميزات تم إيقافها و/أو يقدّم تغييرات غير متوافقة مع الإصدار 3.62. عليك اختبار تطبيقك عند التبديل بين أرقام الإصدارات.

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

الإصدار 3.62

يتضمّن هذا الإصدار ميزات جديدة ويزيل ميزات تم إيقافها و/أو يقدّم تغييرات غير متوافقة مع الإصدار 3.61. عليك اختبار تطبيقك عند التبديل بين أرقام الإصدارات.

الإصدار 3.61

بعد منتصف مايو، سيتم حذف هذا الإصدار ولن يعود بإمكانك استخدامه. سيتم تجاهل أي محاولة لتحميل هذا الإصدار، وسيتم عرض القناة التلقائية بدلاً من ذلك.

الإصدارات المتوافقة

في أي ربع سنة، تتوفّر أربع إصدارات. تتوفّر جميع هذه الإصدارات الأربعة.

عمليات التحقّق من الإصدار

لإجراء عملية تصحيح الأخطاء، استخدِم السمة 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.64 (القناة الأسبوعية)
مرجع واجهة برمجة التطبيقات الإصدار 3.63 (القناة الفصلية)
مرجع واجهة برمجة التطبيقات الإصدار 3.62
مرجع واجهة برمجة التطبيقات الإصدار 3.61
تم حذف الإصدارات من 3.0 إلى 3.60.

تحديد الإصدار تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

آخر الأخبار المتعلّقة بقناتك

إشعار ربع سنوي بشأن القناة

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

الإصدار 3.65

الإصدار 3.64

الإصدار 3.63

الإصدار 3.62

الإصدار 3.61

الإصدارات المتوافقة

عمليات التحقّق من الإصدار

مستندات عن إصدارات واجهة برمجة التطبيقات

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