نقل البيانات: وحدة "خرائط 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> (إجراء يُنصح به)

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

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