OnMapsReadyCallback

ממשק ציבורי OnMapReadyCallback

ממשק קריאה חוזרת (callback) שבו המפה מוכנה לשימוש.

ברגע שמוגדר מופע של הממשק הזה באובייקט MapFragment או MapView, השיטה onMapReady(GoogleMap) מופעלת כשהמפה מוכנה לשימוש ומספקת מופע GoogleMap שאינו אפס.

אם שירותי Google Play לא מותקנים במכשיר, המשתמש יתבקש להתקין אותו, וה-method onMapReady(GoogleMap) תופעל רק כשהמשתמש יתקין אותו ויחזור לאפליקציה.

סיכום אמצעי תשלום ציבורי

מופשט וריק
onMapReady(GoogleMap googleMap)
תתקבל שיחה כשהמפה מוכנה לשימוש.

שיטות ציבוריות

ציבורי מופשט בטל onMapReady (GoogleMap googleMap)

תתקבל שיחה כשהמפה מוכנה לשימוש.

חשוב לשים לב שהפעולה הזו לא מבטיחה שהמפה עברה פריסה. לכן, ייתכן שגודל המפה לא נקבע לפי הקריאה החוזרת (callback). אם צריך להכיר את המאפיינים או לקרוא לשיטה ב-API שאמורה לדעת מהם המאפיינים, אפשר לקבל את השדה View של המפה ולרשום ViewTreeObserver.OnGlobalLayoutListener גם כן.

אין לשרשר את המאזינים OnMapReadyCallback ו-OnGlobalLayoutListener לשרשראות. במקום זאת, יש לרשום ולחכות לשתי הקריאות החוזרות (callback) בנפרד, כי ניתן להפעיל את הקריאות החוזרות בכל סדר שהוא.

לדוגמה, אם רוצים לעדכן את המצלמה של המפה באמצעות LatLngBounds ללא מימדים, צריך להמתין עד לסיום של OnMapReadyCallback ושל OnGlobalLayoutListener. אחרת, יש תנאי ריצה שעלול לגרום לIllegalStateException.

פרמטרים
googleMap מופע שאינו null של 'מפת Google' המשויך ל-MapFragment או ל-MapView שמגדיר את הקריאה החוזרת (callback).