سيتوفّر تصميم الخريطة الجديد قريبًا على "منصة خرائط Google". يتضمن هذا التحديث على تصميم الخريطة لوحة ألوان تلقائية جديدة وتحسينات على تجارب الخرائط وسهولة الاستخدام. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. للمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل الميزة في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد في "منصة خرائط Google".
إذا لم تكن "خدمات Google Play" مثبّتة على الجهاز، سيُطلب من المستخدم تثبيته،
ولن يتم تشغيل طريقة onMapReady(GoogleMap) إلا عندما يكون المستخدم قد
ثبّتها وعاد إليها.
يتم استدعاء هذا الإجراء عندما تكون الخريطة جاهزة للاستخدام.
لاحظ أن هذا لا يضمن أن الخريطة قد خضعت لعملية التخطيط. لذلك، قد لا يتم تحديد حجم الخريطة بحلول وقت استدعاء طريقة معاودة الاتصال. إذا كنت بحاجة إلى معرفة الأبعاد أو استدعاء طريقة في واجهة برمجة التطبيقات تحتاج إلى معرفة الأبعاد، احصل على View للخريطة وسجِّل ViewTreeObserver.OnGlobalLayoutListener أيضًا.
لا تنفذ سلسلة من المستمعين OnMapReadyCallback وOnGlobalLayoutListener، ولكن يمكنك بدلاً من ذلك تسجيل عمليتَي معاودة الاتصال والانتظار عليهما بشكل مستقل، لأنّه يمكن تنشيط عمليات معاودة الاتصال بأي ترتيب.
على سبيل المثال، إذا كنت تريد تعديل كاميرا الخريطة باستخدام LatLngBounds بدون أبعاد، عليك الانتظار حتى يكتمل كل من OnMapReadyCallback وOnGlobalLayoutListener. وبخلاف ذلك،
هناك شرط سباق يمكن أن يؤدي إلى تشغيل IllegalStateException.
المَعلمات
googleMap
مثيل غير فارغ من GoogleMap مرتبط بالسمة MapFragment أو MapView التي تحدّد معاودة الاتصال.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["`OnMapReadyCallback` is triggered when the Google Map is fully loaded and ready for interaction within a `MapFragment` or `MapView`."],["It provides a non-null `GoogleMap` object in the `onMapReady` method, enabling developers to manipulate the map."],["If Google Play services is not available, users are prompted to install it before the callback is triggered."],["The map's layout and dimensions might not be immediately available in `onMapReady`, requiring the use of `ViewTreeObserver.OnGlobalLayoutListener` for size-dependent operations."],["Avoid chaining `OnMapReadyCallback` and `OnGlobalLayoutListener`, handle them independently to prevent race conditions and potential `IllegalStateException`."]]],[]]
