نقل البيانات: وحدة "خرائط Google" في google.load

في 13 تشرين الأول (أكتوبر) 2021، سنوقف الخدمة التي توفّر google.load ملفّ برمجي "خرائط Google". وهذا يعني أنّه بعد 13 تشرين الأول (أكتوبر) 2021، إذا حاولت استخدام وحدة "الخرائط" في google.load، ستظهر لك رسالة خطأ (وحدة "الخرائط" غير متوافقة)، و لن يتم تحميل أي خريطة. لمساعدتك في تجنّب حدوث أي مشاكل، عليك التبديل إلى أحد البدائل.

ما هو الإجراء الواجب اتّخاذه؟

أولاً، أزِل علامة <script> التي تحمِّل أداة تحميل google.load، ثمّ أزِل طلبات google.load. إذا كنت تستخدِم Google Loader لأجل أشياء أخرى، لا بأس بترك علامة أداة التحميل <script> في مكانها.

بعد ذلك، نفِّذ طريقة جديدة لتحميل Maps JavaScript API (اختَر أحد الخيارات التالية):

• التحميل المضمّن باستخدام علامة <script>
• التحميل الديناميكي من ملف JavaScript آخر

مثال حالي على استخدام Google Loader

يوضّح المثال التالي كيفية استخدام Google Loader حاليًا لتحميل واجهة برمجة التطبيقات Maps JavaScript API (تتوفّر كتلتان <script>):

قبل

<script type='text/javascript' src='https://www.google.com/jsapi'></script>
<script type='text/javascript'>
google.load("maps", "3.exp", {
    "callback": initMap,
    "key": "YOUR_KEY",
    "libraries": "places,visualization"
});
function initMap() {
  // Google Maps JS API is loaded and available
}
</script>

التحميل المضمّن باستخدام علامة <script> (إجراء يُنصح به)

عند استخدام هذا النهج، يتم تحميل واجهة برمجة التطبيقات JavaScript API في "خرائط Google" في الوقت نفسه الذي يتم فيه تحميل الصفحة. لتنفيذ التحميل المضمّن، استبدِل أولاً علامة <script> التي تحمّل www.google.com/jsapi ("قبل") بعلامة <script> الموضّحة في المثال التالي:

<script async src="https://maps.googleapis.com/maps/api/js?libraries=places,visualization&key=YOUR_API_KEY&v=weekly&callback=initMap">
</script>

بعد ذلك، عليك إزالة طلب الوظيفة google.load في رمز JavaScript، لأنّه لم يعُد مطلوبًا. يعرض المثال التالي دالة initMap() فارغة، والتي يتمّ استدعاؤها عند تحميل مكتبة "خرائط Google" بنجاح:

<script type='text/javascript'>
function initMap() {
  // Google Maps JS API is loaded and available
}
</script>

الاطّلاع على المستندات

التحميل الديناميكي من ملف JavaScript آخر

يتيح لك التحميل الديناميكي التحكّم في وقت تحميل واجهة برمجة التطبيقات JavaScript لـ "خرائط Google". على سبيل المثال، يمكنك الانتظار لتحميل واجهة برمجة التطبيقات Maps JavaScript API إلى أن ينقر العميل على زر أو ينفّذ إجراءً آخر. لتنفيذ التحميل الديناميكي، استبدِل أولاً علامة <script> التي تحمّل www.google.com/jsapi ("قبل") برمز لإضافة علامة <script> آليًا، كما هو موضّح في المثال التالي:

var script = document.createElement('script');
script.src =
'https://maps.googleapis.com/maps/api/js?libraries=places,visualization&key=YOUR_API_KEY&v=weekly&callback=initMap';
script.async=true;

بعد ذلك، اربط دالة ردّ الاتصال بعنصر النافذة على النحو التالي:

window.initMap = function() {
  // Google Maps JS API is loaded and available
};

أخيرًا، أضِف علامة <script> إلى عنوان الصفحة على النحو التالي:

document.head.appendChild(script);

الاطّلاع على المستندات