OnخريطةReadyCallback

الواجهة المتاحة للجميع OnMapReadyCallback

واجهة معاودة الاتصال عندما تكون الخريطة جاهزة للاستخدام

بعد ضبط مثيل من هذه الواجهة على عنصر MapFragment أو MapView، يتم تشغيل الطريقة onMapReady(GoogleMap) عندما تكون الخريطة جاهزة للاستخدام مع تقديم مثيل GoogleMap غير خالٍ.

إذا لم تكن "خدمات Google Play" مثبّتة على الجهاز، سيُطلب من المستخدم تثبيته، ولن يتم تشغيل طريقة onMapReady(GoogleMap) إلا عندما يكون المستخدم قد ثبّتها وعاد إليها.

ملخّص الطريقة العلنية

فراغ تجريدي
onMapReady(GoogleMap googleMap)
يتم استدعاء هذا الإجراء عندما تكون الخريطة جاهزة للاستخدام.

الطرق العامة

إبطال تجريدي عام onMapReady (GoogleMap googleMap)

يتم استدعاء هذا الإجراء عندما تكون الخريطة جاهزة للاستخدام.

لاحظ أن هذا لا يضمن أن الخريطة قد خضعت لعملية التخطيط. لذلك، قد لا يتم تحديد حجم الخريطة بحلول وقت استدعاء طريقة معاودة الاتصال. إذا كنت بحاجة إلى معرفة الأبعاد أو استدعاء طريقة في واجهة برمجة التطبيقات تحتاج إلى معرفة الأبعاد، احصل على View للخريطة وسجِّل ViewTreeObserver.OnGlobalLayoutListener أيضًا.

لا تنفذ سلسلة من المستمعين OnMapReadyCallback وOnGlobalLayoutListener، ولكن يمكنك بدلاً من ذلك تسجيل عمليتَي معاودة الاتصال والانتظار عليهما بشكل مستقل، لأنّه يمكن تنشيط عمليات معاودة الاتصال بأي ترتيب.

على سبيل المثال، إذا كنت تريد تعديل كاميرا الخريطة باستخدام LatLngBounds بدون أبعاد، عليك الانتظار حتى يكتمل كل من OnMapReadyCallback وOnGlobalLayoutListener. وبخلاف ذلك، هناك شرط سباق يمكن أن يؤدي إلى تشغيل IllegalStateException.

المَعلمات
googleMap مثيل غير فارغ من GoogleMap مرتبط بالسمة MapFragment أو MapView التي تحدّد معاودة الاتصال.