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

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

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

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

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

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

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

يوضح المثال التالي كيف يتم استخدام Google Loader حاليًا لتحميل واجهة برمجة تطبيقات JavaScript للخرائط (هناك كتلتان (<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 للخرائط في في الوقت نفسه ال��ي يتم فيه تحميل الصفحة لتطبيق التحميل المضمّن، استبدل أولاً علامة <script> تحمِّل www.google.com/jsapi ("before") مع علامة يتم عرض علامة <script> في المثال التالي:

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

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

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

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

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

يتيح لك التحميل الديناميكي التحكم في وقت تحميل واجهة برمجة تطبيقات JavaScript للخرائط. بالنسبة على سبيل المثال، يمكنك الانتظار لتحميل واجهة برمجة تطبيقات JavaScript للخرائط حتى ينقر المستخدم على زر أو ينفذ إجراءً آخر. لتنفيذ التحميل الديناميكي، أولاً، استبدل العلامة <script> التي تُحمّل www.google.com/jsapi ("before") مع رمز لإضافة العلامة <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);

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