מפה של Google

המחלקה הסופית הציבורית GoogleMaps מרחיבה את האובייקט

זוהי השיעור הראשי של ה-SDK של מפות Google ל-Android, והוא נקודת הכניסה לכל השיטות הקשורות למפה. לא ניתן ליצור אובייקט GoogleMap באופן ישיר. במקום זאת, צריך לקבל אובייקט משיטה getMapAsync() ב-MapFragment או ב-MapView שהוספת לאפליקציה.

הערה: בדומה לאובייקט View, אפשר לקרוא GoogleMap ולשנות אותם רק מתוך השרשור של ממשק המשתמש של Android. קריאה אל GoogleMap שיטות משרשור אחר תוביל לחריגה.

כדי לשנות את נקודת המבט של מפה, אפשר לשנות את מיקום המצלמה (במקום להזיז אותה). ניתן להשתמש במצלמה של המפה כדי להגדיר פרמטרים כמו מיקום, רמת הזום, זווית ההטיה והמיסב. מידע נוסף זמין בקטע מצלמה ותצוגה מפורטת.

מדריך למפתחים

כדי להתחיל, כדאי לקרוא את המדריך למפתחים שלמפות Google ל-Android.

סיכום הכיתה בתוך מערך

משופר GoogleMaps.CancelableCallback ממשק להתקשרות חזרה לדיווח על השלמת משימה או ביטולה. 
משופר Googleמיפוי.InfoWindowAdapter מספק צפיות לעיבוד מותאם אישית של חלונות מידע. 
משופר GoogleMaps.OnCameraChangeListener הממשק הזה הוצא משימוש. בוצעה החלפה ב-GoogleMap.OnCameraMoveStartedListener, ב-GoogleMap.OnCameraMoveListener וב-GoogleMap.OnCameraIdleListener. הסדר שבו תתבצע קריאה לשיטת onCameraChange שהוצאה משימוש יחול על השיטות שהוגדרו במאזינים החדשים לשינוי המצלמה.  
משופר GoogleMaps.OnCameraIdleListener ממשק קריאה חוזרת (callback) כאשר תנועת המצלמה הסתיימה. 
משופר GoogleMaps.OnCameraMoveCanceledListener ממשק לקריאה חוזרת (callback) כשהתנועה במצלמה הופסקה או כשהמצלמה מתחילה לנוע מסיבה חדשה. 
משופר GoogleMaps.OnCameraMoveListener ממשק לקריאה חוזרת (callback) כאשר המצלמה משנה את המיקום. 
משופר GoogleMaps.OnCameraMoveStartedListener ממשק לקריאה חוזרת (callback) כאשר תנועת המצלמה מתחילה. 
משופר GoogleMaps.OnClickClickListener ממשק לקריאה חוזרת (callback) כשלוחצים על מעגל. 
משופר GoogleMaps.OnGroundLayerClickListener ממשק לקריאה חוזרת (callback) כשלוחצים על שכבת-על של קרקע. 
משופר Googleמיפוי.OnIndoorStateChangeListener מאזינים כאשר המצב המקורה משתנה. 
משופר GoogleMaps.OnInfoWindowClickListener ממשק לקריאה חוזרת (callback) עבור אירועי קליק/הקשה בחלון מידע של סמן. 
משופר GoogleMaps.OnInfoWindowCloseListener ממשק לקריאה חוזרת (callback) לאירועים קרובים בחלון המידע של הסמן. 
משופר Googleמיפוי.OnInfoWindowLongClickListener ממשק קריאה חוזרת (callback) כאשר המשתמש לוחץ לחיצה ארוכה על חלון המידע של הסמן. 
משופר Googleמיפוי.OnMapsClickListener ממשק לקריאה חוזרת (callback) כשהמשתמש מקיש על המפה. 
משופר Googleמיפוי.OnMapsLoadedCallback ממשק לקריאה חוזרת (callback) בסיום העיבוד של המפה. 
משופר Googleמיפוי.OnMapsLongClickListener ממשק לקריאה חוזרת (callback) כשהמשתמש לוחץ לחיצה ארוכה על המפה. 
משופר GoogleMaps.OnMarkerClickListener מגדירה חתימות עבור שיטות שנקראות כאשר לוחצים על סמן או מקישים עליו. 
משופר GoogleMaps.OnMarkerDragListener ממשק לקריאה חוזרת (callback) עבור אירועי גרירה על סמנים. 
משופר Googleמיפוי.OnMyLocationButtonClickListener ממשק לקריאה חוזרת (callback) כשלוחצים על הלחצן 'המיקום שלי'.
משופר Googleמיפוי.OnMyLocationChangeListener הממשק הזה הוצא משימוש. במקומה, יש להשתמש ב-com.google.android.gms.location.FusedLocationProviderApi. FuseLocationProviderApi מספק איתור מיקום משופר ושימוש בחשמל, והוא בשימוש על ידי הנקודה הכחולה "המיקום שלי". כדאי לעיין במדריך בנושא מקום נוכחי, שמשתמש ב-FuseLocationProviderApi או במדריך למפתחים בנושא מיקום.  
משופר Googleמיפוי.OnMyLocationClickListener ממשק קריאה חוזרת (callback) כשלוחצים על הנקודה 'המיקום שלי' (שפירושה המיקום של המשתמש).
משופר Googleמיפוי.OnPoiClickListener האזנה להקשות על נקודות עניין. 
משופר Googleמיפוי.OnPolygonClickListener ממשק לקריאה חוזרת (callback) כשלוחצים על פוליגון. 
משופר Googleמיפוי.OnPolylineClickListener ממשק לקריאה חוזרת (callback) כשלוחצים על רב-קו. 
משופר GoogleMaps.SnapshotReadyCallback ממשק לקריאה חוזרת (callback) כדי להודיע לך מתי צולמה תמונת המצב. 

סיכום קבוע

int MAP_TYPE_HYBRID מפות לוויין עם שכבה שקופה של רחובות ראשיים.
int MAP_TYPE_NONE אין משבצות של מפה בסיסית.
int MAP_TYPE_NORMAL מפות בסיסיות.
int MAP_TYPE_SATELLITE מפות לוויין ללא תוויות.
int MAP_TYPE_TERRAIN מפות פני שטח.

סיכום השיטה הציבורית

עיגול
addעיגול(עיגול אפשרויות)
הוספת מעגל למפה הזו.
פני השטח
addGroundשכבת על (אפשרויות יבשת שכבת-על)
הוספת תמונה למפה הזו.
סמן
addMarker(אפשרויות Marker)
הוספת סמן למפה זו.
מצולע
addPolygon(אפשרויות פוליגון)
מוסיף פוליגון למפה זו.
פוליגון
addPolyline(אפשרויות PolylineOptions)
הוספת מצולע למפה הזו.
שכבת-על של משבצת
addTileLayer(אפשרויות שכבת-על של משבצות)
הוספת שכבת-על של אריח למפה הזו.
ביטול
animateCamera(עדכון ל-CameraUpdate)
אנימציה של תנועת המצלמה מהמיקום הנוכחי למיקום המוגדר בעדכון.
ביטול
animateCamera (עדכון של CameraUpdate, GoogleMaps.CancelableCallback לקריאה חוזרת)
אנימציה של תנועת המצלמה מהמיקום הנוכחי למיקום המוגדר בעדכון וקריאה חוזרת (callback) אופציונלית לאחר הסיום.
ביטול
animateCamera (עדכון של CameraUpdate, int durationMs, GoogleMaps.CancelableCallback לקריאה חוזרת)
העברת המפה בהתאם לעדכון עם אנימציה במהלך פרק הזמן שצוין, וקריאה חוזרת (callback) אופציונלית בסיום.
ביטול
clear()
מתבצעת הסרה של כל הסמנים, הפוליגונים, הפוליגונים, שכבות-העל וכו' מהמפה.
מיקום המצלמה
getCameraposition()
מקבלת את המיקום הנוכחי של המצלמה.
בניית בניינים
getTargetedBuilding()
מקבל את המבנה שמתמקד כרגע.
int
getMapsType()
מקבל את סוג המפה שמוצגת כעת.
מספר ממשי (float)
getMaxZoomLevel()
מחזירה את רמת ההגדלה המקסימלית של מיקום המצלמה הנוכחי.
מספר ממשי (float)
getMinZoomLevel()
מחזירה את רמת הזום המינימלית.
מיקום
getMyLocation()
השיטה הזו הוצאה משימוש. השתמשו ב-com.google.android.gms.location.FusedLocationProviderApi במקום זאת. FuseLocationProviderApi מספק איתור מיקום משופר ושימוש בחשמל, והוא בשימוש על ידי הנקודה הכחולה "המיקום שלי". אפשר לעיין בפעילות MyLocationDemoActivity בתיקייה לדוגמה של האפליקציות, כדי לקבל קוד לדוגמה או במדריך למפתחים בנושא מיקום.
הקרנה
getProjection()
מחזירה אובייקט Projection שבעזרתו אפשר להמיר בין קואורדינטות מסך לבין קואורדינטות של קווי אורך ורוחב.
הגדרות UiSettings
getUiSettings()
מקבל את הגדרות ממשק המשתמש עבור המפה.
boolean
isBuildingsEnabled()
מחזירה אם מופעלת שכבת מבנים בתלת-ממד.
boolean
isIndoorEnabled()
קובעת אם המפות הפנימיות מופעלות כרגע.
boolean
isMyLocationEnabled()
מקבל את הסטטוס של שכבת המיקום שלי.
boolean
isTrafficEnabled()
בודקת אם המפה אוספת נתוני תנועה.
ביטול
MoveCamera (עדכון של CameraUpdate)
ממקמת מחדש את המצלמה בהתאם להוראות שהוגדרו בעדכון.
ביטול
resetMinMaxZoom()
פונקציה זו מסירה את גבולות הזום הגבוהים והתחתונים שצוינו קודם לכן.
ביטול
setBuildingsEnabled(הפעלה בוליאנית)
מפעילה או משביתה את שכבת המבנים בתלת-ממד.
ביטול
setContentDescription(תיאור המחרוזת)
מגדיר תיאור תוכן עבור המפה.
boolean
setIndoorEnabled(תמיכה בבוליאני)
הגדרה זו קובעת אם יש להפעיל את מפות הפנים.
ביטול
setInfoWindowAdapter(GoogleMaps.InfoWindowAdapterמתאם
מגדיר כלי עיבוד מותאם אישית לתוכן של חלונות מידע.
ביטול
setLatLngBoundsForCameraTarget(LatLngBounds גבולות)
המדיניות הזו מגדירה את LatLngBounds כדי להגביל את יעד המצלמה, כך שכאשר משתמשים גוללים וזיזים את המפה, היעד של המצלמה לא זז מחוץ לגבולות האלה.
ביטול
setLocationSource(מקור LocationSource)
מחליפה את מקור המיקום של שכבת המיקום שלי.
boolean
setmapStyle(סגנון MapsStyleOptions)
הגדרת הסגנון של מפת הבסיס.
ביטול
setmapType(סוג מזהה)
הגדרת סוג אריחי המפה שאמורים להופיע.
ביטול
setMaxZoomPreferences(float maxZoompreferences)
מגדירה גבול עליון מועדף לזום המצלמה.
ביטול
setMinZoomPreferences(float minZoomPreferences)
מגדירה גבול תחתון מועדף לזום המצלמה.
ביטול
setMyLocationEnabled(הפעלה בוליאנית)
הפעלה או השבתה של שכבת 'המיקום שלי'.
ביטול
setOnCameraChangeListener(Googleמיפוי.OnCameraChangeListener מאזין)
השיטה הזו הוצאה משימוש. בוצעה החלפה ב-setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), ב-setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), ב-setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) וב-setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).
ביטול
setOnCameraIdleListener(GoogleMaps.OnCameraIdleListener מאזין)
הגדרה של קריאה חוזרת (callback) שמופעלת כשהתנועה במצלמה הסתיימה.
ביטול
setOnCameraMovecanceledListener(GoogleMaps.OnCameraMoveCanceledListener Listener)
הגדרה של קריאה חוזרת (callback) שמופעלת כשהמצלמה מפסיקה או מופסקת באמצעות סוג חדש של אנימציה.
ביטול
setOnCameraMoveListener(Googleמיפוי.OnCameraMoveListener מאזין)
הגדרה של קריאה חוזרת (callback) שמופעלת שוב ושוב כשהמצלמה בתנועה.
ביטול
setOnCameraMoveStartedListener(GoogleMaps.OnCameraMoveStartedListener Listener)
הגדרה של קריאה חוזרת (callback) שמופעלת כאשר המצלמה מתחילה לנוע או הסיבה לכך שתנועת המצלמה השתנתה.
ביטול
setOnעיגולClickListener(Googleמיפוי.Onעיגולקליקהאזנה)
הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על מעגל.
ביטול
setOnGroundGroundClickListener(Googleמיפוי.OnGroundLayerClickListener מאזינים)
הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על שכבת-על של קרקע.
ביטול
setOnIndoorStateChangeListener(Googleמיפוי.OnIndoorStateChangeListener Listener)
מגדיר או מנקה את אירועי ההאזנה עבור אירועים בפנים.
ביטול
setOnInfoWindowClickListener(Googleמיפוי.OnInfoWindowClickListener האזנה)
הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על חלון מידע של סמן.
ביטול
setOnInfoWindowCloseListener(GoogleMaps.OnInfoWindowCloseListener מאזינים)
הגדרה של קריאה חוזרת (callback) שמופעלת כשחלון המידע של הסמן סגור.
ביטול
setOnInfoWindowLongClickListener(Googleמיפוי.OnInfoWindowLongClickListener האזנה)
הגדרה של קריאה חוזרת (callback) שמופעלת כשחלון המידע של הסמן לוחץ לחיצה ארוכה.
ביטול
setOnmapClickListener(Googleמיפוי.OnMapsClickListener מאזין)
הגדרה של קריאה חוזרת (callback) שמופעלת כשמשתמשים מקישים על המפה.
ביטול
setOnmapLoadedCallback(Googleמיפוי.OnמיפויLoadedCallback קריאה חוזרת)
הגדרה של קריאה חוזרת (callback) שמופעלת כשהמפה הזו הסתיימה.
ביטול
setOnמיפויLongClickListener(Googleמיפוי.OnMapsLongClickListener האזנה)
הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים לחיצה ארוכה במפה.
ביטול
setOnMarkerClickListener(Googleמיפוי.OnMarkerClickListener מאזין)
הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על סמן.
ביטול
setOnMarkerDragListener(Googleמיפוי.OnMarkerDragListener האזנה)
הגדרה של קריאה חוזרת (callback) שמופעלת כשגוררים את הסמן.
ביטול
setOnMyLocationButtonClickListener(Googleמיפוי.OnMyLocationClickListener מאזין)
הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על לחצן המיקום שלי.
ביטול
setOnMyLocationChangeListener(Googleמיפוי.OnMyLocationChangeListener מאזין)
השיטה הזו הוצאה משימוש. השתמשו ב-com.google.android.gms.location.FusedLocationProviderApi במקום זאת. FuseLocationProviderApi מספק איתור מיקום משופר ושימוש בחשמל, והוא בשימוש על ידי הנקודה הכחולה "המיקום שלי". אפשר לעיין בפעילות MyLocationDemoActivity בתיקייה לדוגמה של האפליקציות, כדי לקבל קוד לדוגמה או במדריך למפתחים בנושא מיקום.
ביטול
setOnMyLocationClickListener(GoogleMaps.OnMyLocationClickListener מאזין)
מגדירה קריאה חוזרת שמופעלת כאשר הנקודה 'המיקום שלי' (שמציינת את המיקום של המשתמש) לוחצים.
ביטול
setOnPoiClickListener(Googleמיפוי.OnPoiClickListener מאזין)
מגדיר האזנה שמופעלת כשלוחצים על נקודת עניין או מקישים עליה.
ביטול
setOnPolygonClickListener(Googleמיפוי.OnPolygonClickListener מאזין)
הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על פוליגון.
ביטול
setOnPolylineClickListener(Googleמיפוי.OnPolylineClickListener מאזין)
הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על רב-קו.
ביטול
setPמרווח(int left, int top, int right, int down)
המדיניות מאפשרת להגדיר מרווח פנימי במפה.
ביטול
setTrafficEnabled (הפעלה בוליאנית)
הפעלה או השבתה של שכבת התנועה.
ביטול
snapshot (התקשרות חזרה ב-GoogleMaps.SnapshotReadyCallback)
צילום מסך של המפה.
ביטול
snapshot (התקשרות חזרה ב-Googlemap.SnapshotReadyCallback, מפת סיביות שלbitmap)
צילום מסך של המפה.
ביטול
עצור אנימציה()
הפסקת האנימציה של המצלמה אם מתבצע שידור כזה.

סיכום השיטות שהועברו בירושה

קבוע

ציבורי סטטי סופי MAP_TYPE_HYBRID

מפות לוויין עם שכבה שקופה של רחובות ראשיים.

ערך קבוע: 4

ציבורי סטטי סופי MAP_TYPE_NONE

אין משבצות של מפה בסיסית.

ערך קבוע: 0

גלוי לכול סטטי סופי MAP_TYPE_NORMAL

מפות בסיסיות.

ערך קבוע: 1

ציבורי סטטי סופי MAP_TYPE_SATELLITE

מפות לוויין ללא תוויות.

ערך קבוע: 2

ציבורי סטטי סופי MAP_TYPE_TERRAIN

מפות פני שטח.

ערך קבוע: 3

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

ציבורי עיגול addעיגול (אפשרויות עיגול)

הוספת מעגל למפה הזו.

פרמטרים
אפשרויות אובייקט אפשרויות מעגל שקובע איך לעבד את העיגול
החזרות
  • האובייקט Circle שנוסף למפה

גלוי לכול רקע שכבת-על addGroundשכבת על (אפשרויות קרקע לבחירה)

הוספת תמונה למפה הזו.

פרמטרים
אפשרויות אובייקט אפשרויות של שכבת-על שקובעת איך לעבד את שכבת-העל. לאפשרויות חייבת להיות תמונה (מעוגנת למיפוי) ומיקום.
החזרות
זריקות
חריג לא חוקי אם התמונה או המיקום לא צוינו באפשרויות.

גלוי לכול סמן addMarker (MarkerOptions options)

הוספת סמן למפה זו.

הסמל של הסמן'מעובד במפה במיקום הסמן. לחיצה על הסמן תמרכז את המצלמה על הסמן. אם הסמן סמן אם אפשר לגרור את הסמן, לוחצים עליו לחיצה ארוכה ואז גוררים אותו.

פרמטרים
אפשרויות אובייקט של אפשרויות סמן שמגדיר איך לעבד את הסמן.
החזרות

גלוי לכול פוליגון addPolygon (אפשרויות פוליגון)

מוסיף פוליגון למפה זו.

פרמטרים
אפשרויות אובייקט אפשרויות פוליגון המגדיר כיצד לעבד את הפוליגון.
החזרות
  • האובייקט Polygon שנוסף למפה.

Public Polyline addPolyline (PolylineOptions options)

הוספת מצולע למפה הזו.

פרמטרים
אפשרויות אובייקט של אפשרויות Polyline שמגדיר איך לעבד את ה-Polyline.
החזרות
  • האובייקט Polyline שנוסף למפה.

גלוי לכול שכבת משבצות addTile שכבת (אפשרויות אריח שכבת-על)

הוספת שכבת-על של אריח למפה הזו. מידע נוסף זמין בTileOverlay.

חשוב לזכור שבשונה משכבות-על אחרות, אם המפה נוצרת מחדש, שכבות-העל של כרטיס המידע לא ישוחזרו באופן אוטומטי ויש להוסיף אותן מחדש באופן ידני.

פרמטרים
אפשרויות אובייקט של אפשרויות שכבת-על של משבצות שקובע איך לעבד את שכבת-העל. כדי לציין אפשרויות, צריך לציין TileProvider. אחרת, המערכת תכניס IllegalArgumentException.
החזרות
זריקות
חריג לא חוקי אם לא מציינים את TileProvider באפשרויות.

Public null אנימציה של המצלמה (עדכון המצלמה)

אנימציה של תנועת המצלמה מהמיקום הנוכחי למיקום המוגדר בעדכון. במהלך האנימציה, קריאה ל-getCameraPosition() מחזירה מיקום ביניים של המצלמה.

להצגת עדכונים בקבוצה CameraUpdateFactory.

פרמטרים
עדכון השינוי שאמור לחול על המצלמה.

Public null animateCamera (עדכון CameraUpdate, GoogleMaps.CancelableCallback callback)

אנימציה של תנועת המצלמה מהמיקום הנוכחי למיקום המוגדר בעדכון וקריאה חוזרת (callback) אופציונלית לאחר הסיום. להצגת CameraUpdateFactory של קבוצת עדכונים

במהלך האנימציה, קריאה ל-getCameraPosition() מחזירה מיקום ביניים של המצלמה.

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

Public null אנימציה של המצלמה (עדכון המצלמה, מספר intMs, GoogleMaps.ביטול השיחה החוזרת התקשרות חזרה

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

אם תתבצע קריאה אל getCameraPosition() במהלך האנימציה, הפונקציה תחזיר את המיקום הנוכחי של המצלמה בטיסה.

פרמטרים
עדכון
משך זמן משך האנימציה באלפיות השנייה. זה חייב להיות חיובי לחלוטין, אחרת IllegalArgumentException יושלך.
קריאה חוזרת (callback) אפשרות אופציונלית לקבל הודעה בשרשור של ממשק המשתמש של Android כשהאנימציה מפסיקה. אם האנימציה תיפסק עקב השלמתה הטבעית, השיחה החוזרת תישלח אל onFinish(). אם האנימציה תיפסק בגלל הפרעה במצלמה מאוחר יותר או תנועת משתמש מאוחרת יותר, תתבצע קריאה ל-onCancel(). אין לנסות להפעיל את הקריאה החוזרת (callback) או ליצור אנימציה של המצלמה בשיטת הביטול. אם לא נדרשת שיחה חוזרת, יש להשאיר את הכתובת null.

Public null ניקוי ()

מתבצעת הסרה של כל הסמנים, הפוליגונים, הפוליגונים, שכבות-העל וכו' מהמפה.

גלוי לכול Cameraposition getCameraposition ()

מקבלת את המיקום הנוכחי של המצלמה.

העמודה CameraPosition שמוחזרת היא תמונת מצב של המיקום הנוכחי. היא לא תעודכן באופן אוטומטי כשהמצלמה זזה.

לקבלת מידע נוסף על שינוי המיקום של המצלמה, אפשר לעיין בקטע מצלמה ותצוגה.

החזרות
  • המיקום הנוכחי של המצלמה.

Public IndoorBuilding getTargetedBuilding ()

מקבל את המבנה שמתמקד כרגע.

החזרות
  • הבניין המודגש הנוכחי או null אם אין בניין.

Public int getמיפויType ()

מקבל את סוג המפה שמוצגת כעת. לעיון בערכים האפשריים: MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN.

החזרות
  • סוג המפה.

Public מספר ממשי (float) getMaxZoomLevel ()

מחזירה את רמת ההגדלה המקסימלית של מיקום המצלמה הנוכחי. כך נלקחים בחשבון סוגי המפה שבשימוש כרגע. לדוגמה, רמת הזום של הלוויין או פני השטח עשויה להיות נמוכה יותר מזו של המפה הנוכחית.

למידע נוסף על שינוי רמת הזום של המצלמה, עיין בקטע מצלמה ותצוגה.

החזרות
  • רמת הזום המקסימלית הזמינה במיקום המצלמה הנוכחי.

Public float getMinZoomLevel ()

מחזירה את רמת הזום המינימלית. הכלל הזה זהה בכל המיקומים (בניגוד לרמת הזום המקסימלית) אבל הוא עשוי להשתנות בהתאם למכשיר ולגודל המפה.

למידע נוסף על שינוי רמת הזום של המצלמה, עיין בקטע מצלמה ותצוגה.

החזרות
  • רמת המרחק מהתצוגה המינימלית זמינה.

גלוי לכול מיקום getMyLocation ()

השיטה הזו הוצאה משימוש.
במקומה יש להשתמש ב-com.google.android.gms.location.FusedLocationProviderApi. FuseLocationProviderApi מספק איתור מיקום משופר ושימוש בחשמל, והוא בשימוש על ידי הנקודה הכחולה "המיקום שלי". ניתן לעיין בפעילות MyLocationDemoActivity בתיקייה לדוגמה של האפליקציות, לקבלת קוד לדוגמה או במדריך למפתחים בנושא מיקום.

פונקציה זו מחזירה את מיקום המשתמש הנוכחי שמוצג, או null אם אין נתוני מיקום זמינים.

החזרות
זריקות
לא חוקי של StateState אם שכבת המיקום שלי לא מופעלת.

Public Projection getProjection ()

מחזירה אובייקט Projection שבעזרתו אפשר להמיר בין קואורדינטות מסך לבין קואורדינטות של קווי אורך ורוחב.

האפליקציה Projection שמוחזרת היא תמונת מצב של ההקרנה הנוכחית, ולא תתעדכן באופן אוטומטי כאשר המצלמה תנוע. הפעולה הזו יקרה, ולכן עליך להקרין רק פעם אחת לכל מסך. במפות Google משתמשים בתחזית של מרקטור כדי ליצור מפות מנתונים גיאוגרפיים ולהמיר נקודות במפה לקואורדינטות גיאוגרפיות.

החזרות

גלוי לכול UiSettings getUiSettings ()

מקבל את הגדרות ממשק המשתמש עבור המפה.

החזרות

Public בוליאני isBuildingsEnabled ()

מחזירה אם מופעלת שכבת מבנים בתלת-ממד.

החזרות
  • true אם מבנים מופעלים, false אחרת.

Public בוליאני isIndoorEnabled ()

קובעת אם המפות הפנימיות מופעלות כרגע.

החזרות
  • true אם מפות פנים מופעלות, false אם מפות פנים מושבתות;

Public בוליאני isMyLocationEnabled ()

מקבל את הסטטוס של שכבת המיקום שלי.

החזרות
  • true אם שכבת המיקום שלי מופעלת. false אחרת.

Public boolean isTrafficEnabled ()

בודקת אם המפה אוספת נתוני תנועה. בכפוף לזמינות של נתוני תנועה.

החזרות
  • true אם נתוני התנועה מופעלים. false אחרת.

Public null MoveCamera (עדכון המצלמה)

ממקמת מחדש את המצלמה בהתאם להוראות שהוגדרו בעדכון. ההעברה מתבצעת באופן מיידי, וכתוצאה מכך getCameraPosition() יופיע במיקום החדש. קבוצת עדכונים מפורטת: CameraUpdateFactory.

פרמטרים
עדכון השינוי שאמור לחול על המצלמה.

Public null resetMinMaxZoom ()

פונקציה זו מסירה את גבולות הזום הגבוהים והתחתונים שצוינו קודם לכן.

Public null setBuildingsEnabled (ערך בוליאני מופעל)

מפעילה או משביתה את שכבת המבנים בתלת-ממד.

פרמטרים
פעיל true כדי להפעיל את השכבה 'בניינים תלת-ממדיים'; false כדי להשבית מבנים בתלת-ממד.

Public null setContentDescription (תיאור המחרוזת)

מגדיר תיאור תוכן עבור המפה.

משמש להצגת תיאור של המפה במצב נגישות. ערך ברירת המחדל הוא "Google Maps"

פרמטרים
תיאור מחרוזת שתשמש כתיאור.

Public בוליאני setIndoorEnabled (ערך בוליאני מופעל)

הגדרה זו קובעת אם יש להפעיל את מפות הפנים. נכון לעכשיו, מפות הפנים יכולות להיות מוצגות במפה אחת בלבד בכל פעם, וכברירת מחדל, זו המפה הראשונה שנוספה לאפליקציה שלך. כדי להפעיל מפות מקורות במפה אחרת, תחילה עליך להשבית מפות מקורות במפה המקורית. אם מנסים להפעיל מפות מקורות כאשר האפשרות הזו מופעלת במפה אחרת, לא יקרה דבר ופעולה זו תחזיר את false. כשהאפשרות 'פנים' לא מופעלת במפה, כל האמצעים הקשורים לחדרים פנימיים יחזירו null או false.

פרמטרים
פעיל true כדי להפעיל מפות מקורות; false כדי להשבית מפות מקורות.
החזרות
  • אם אפשר להפעיל מפות פנים.

Public null setInfoWindowAdapter (מתאם GoogleMaps.InfoWindowAdapter)

מגדיר כלי עיבוד מותאם אישית לתוכן של חלונות מידע.

בדומה למאזינים לאירועים של המפה, מצב זה לא מופיע במפה. אם המפה נוצרה מחדש (למשל, בגלל שינוי בהגדרה), עליך לוודא שהתקשרת שוב לשיטה הזו כדי לשמור את ההתאמה האישית.

פרמטרים
מתאם המתאם שבו יש להשתמש לתוכן של חלון מידע, או null כדי להשתמש בעיבוד ברירת המחדל של התוכן בחלונות מידע.

Public null setLatLngBundsForCameraTarget (LatLngBunds bounds)

המדיניות הזו מגדירה את LatLngBounds כדי להגביל את יעד המצלמה, כך שכאשר משתמשים גוללים וזיזים את המפה, היעד של המצלמה לא זז מחוץ לגבולות האלה.

אפשר להגדיר את הערך null כדי למחוק לגמרי את התיבה התוחמת את התוכן. הגבול החדש מחליף את כל תיבות הגבולות שצוינו.

כש-LatLngBounds משתנה, ה-SDK מתאים את כל עדכוני המצלמה מאוחר יותר כדי לעמוד בגבולות האלה, אם הדבר אפשרי. חשוב לזכור שיש שיקולים טכניים שעשויים למנוע מה-SDK לשמור על יעד המצלמה בגבולות שנקבעו. לדוגמה, רמת הדיוק של הנקודה הצפה מעגלת שגיאות או רמת זום נמוכה מאוד.

פרמטרים
עם גבולות הגבולות כדי להגביל את יעד המצלמה בתוך.

Public null setLocationSource (מקור:LocationSource)

מחליפה את מקור המיקום של שכבת המיקום שלי.

פרמטרים
source מקור מיקום לשימוש בשכבת 'המיקום שלי'. יש להגדיר את הערך null כדי להשתמש במקור המיקום שמוגדר כברירת מחדל.

Public בוליאני setMapsStyle (מיפוי סגנוןאפשרויות)

הגדרת הסגנון של מפת הבסיס.

באמצעות אפשרויות הסגנון, אפשר להחיל סגנונות מותאמים אישית על התכונות והרכיבים במפה. בכתובת MapStyleOptions אפשר למצוא פרטים על הגדרת סגנון.

יש להגדיר את הערך null כדי לנקות עיצוב מותאם אישית קודם.

פרמטרים
style
החזרות
  • true אם הסגנון נותח בהצלחה; false אם זוהו בעיות ב-MapStyleOptions, כולל מזהה JSON שלא ניתן לניתוח, סוג תכונה לא מזוהה, סוג רכיב לא מזוהה או מפתחות סטיילר לא חוקיים. אם ערך ההחזרה הוא false, הסגנון הנוכחי יישאר ללא שינוי.

Public null setמיפויType (סוג מזהה)

הגדרת סוג אריחי המפה שאמורים להופיע. הערכים המותרים הם:

פרמטרים
סוג סוג המפה להצגה.

Public null setMaxZoompreferences (float maxZoompreferences)

מגדירה גבול עליון מועדף לזום המצלמה.

כשהזום המקסימלי משתנה, ה-SDK מתאים את כל עדכוני המצלמה מאוחר יותר כדי לשמור על הערך המקסימלי האפשרי. חשוב לזכור שיש שיקולים טכניים שעלולים למנוע מה-SDK לאפשר למשתמשים להתקרב יותר מדי למפה. לדוגמה, יכול להיות שמרחק התצוגה המקסימלי של לוויין או פני שטח יהיה נמוך מהמשבצות של מפת הבסיס.

ה-SDK פותר את כל ההתנגשויות בערכי המינימום והמקסימום. אם הגדרת את מרחק התצוגה המינימלי לרמת זום גבוהה יותר מהמקסימום הנוכחי, ה-SDK ישתמש בערך המינימלי החדש גם למינימום וגם למקסימום. אם הגדרת את מרחק התצוגה המקסימלי לרמת זום נמוכה יותר מזו ל-SDK, ה-SDK ישתמש בערך המקסימלי החדש למינימום ולמקסימום. לדוגמה: נניח שזום המינימום הנוכחי הוא 8 והמקסימום הוא 14. לאחר מכן תגדיר את מרחק התצוגה המקסימלי ל-6. ה-SDK משתמש בזום 6 מינימלי ובזום מקסימלי של 6.

פרמטרים
MaxZoomהעדפת הגבול העליון המועדף.

Public null setMinZoompreferences (float minZoompreferences)

מגדירה גבול תחתון מועדף לזום המצלמה.

כשהזום המינימלי משתנה, ה-SDK מתאים את כל עדכוני המצלמה מאוחר יותר כדי לכבד את המינימום הזה, אם זה אפשרי. חשוב לזכור שיש שיקולים טכניים שעלולים למנוע מה-SDK לאפשר למשתמשים להקטין את מרחק התצוגה.

ה-SDK פותר את כל ההתנגשויות בערכי המינימום והמקסימום. אם הגדרת את מרחק התצוגה המינימלי לרמת זום גבוהה יותר מהמקסימום הנוכחי, ה-SDK ישתמש בערך המינימלי החדש גם למינימום וגם למקסימום. אם הגדרת את מרחק התצוגה המקסימלי לרמת זום נמוכה יותר מזו ל-SDK, ה-SDK ישתמש בערך המקסימלי החדש למינימום ולמקסימום. לדוגמה: נניח שזום המינימום הנוכחי הוא 8 והמקסימום הוא 14. לאחר מכן, אתם מגדירים את מרחק התצוגה המינימלי ל-16. ה-SDK משתמש בזום 16 מינימלי ובזום מקסימלי של 16.

פרמטרים
minZoompreferences הגבול התחתון המועדף.

Public null setMyLocationEnabled (בוליאני מופעל)

הפעלה או השבתה של שכבת 'המיקום שלי'.

בזמן שהתכונה מופעלת והמיקום זמין, שכבת 'המיקום שלי' מסיקה באופן קבוע נוכחות של המיקום והגלגל הנוכחיים של המשתמש, ומציגה פקדי ממשק משתמש שמאפשרים למשתמש לבצע אינטראקציה עם המיקום שלו (לדוגמה, כדי להפעיל או להשבית מעקב אחר המצלמה במיקום ובמיסבים שלו).

כדי להשתמש בתכונה של שכבת המיקום שלי, עליך לבקש הרשאה עבור ACCESS_COARSE_LOCATION או ACCESS_FINE_LOCATION, אלא אם הגדרת מקור מיקום מותאם אישית.

אם הגדרת מקור מיקום מותאם אישית דרך setLocationSource(LocationSource), ה-SDK של מפות Google ל-Android לא יבדוק אם ניתנו ההרשאות שלמעלה. עם זאת, עדיין צריך לוודא שהמשתמש נתן את כל ההרשאות הנדרשות למקור המיקום המותאם אישית שלך.

פרמטרים
פעיל true להפעלה; false כדי להשבית.
זריקות
חריג אבטחה אם הרשאת המיקום לא אושרה.

Public null setOnCameraChangeListener (GoogleMaps.OnCameraChangeListener מאזין)

השיטה הזו הוצאה משימוש.
הוחלף על ידי setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) ו-setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

הגדרה של קריאה חוזרת (callback) שמופעלת כאשר המצלמה משתנה.

פרמטרים
listener השיחה החוזרת מופעלת כשהמצלמה משתנה. כדי לבטל את הקריאה החוזרת (callback), צריך להשתמש במדיניות null.

Public null setOnCameraIdleListener (GoogleMaps.OnCameraIdleListener מאזין)

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

פרמטרים
listener השיחה החוזרת הופעלה. כדי לבטל את השיחה החוזרת, צריך להשתמש במספר null.

Public null setOnCameraMoveCanceledListener (GoogleMaps.OnCameraMoveCanceledListener מאזין)

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

פרמטרים
listener השיחה החוזרת הופעלה. כדי לבטל את השיחה החוזרת, צריך להשתמש במספר null. אין לעדכן או להפעיל את המצלמה מתוך onCameraMoveCanceled().

Public null setOnCameraMoveListener (GoogleMaps.OnCameraMoveListener מאזין)

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

פרמטרים
listener השיחה החוזרת הופעלה. כדי לבטל את השיחה החוזרת, צריך להשתמש במספר null.

Public null setOnCameraMoveStartedListener (GoogleMaps.OnCameraMoveStartedListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כאשר המצלמה מתחילה לנוע או הסיבה לכך שתנועת המצלמה השתנתה.

פרמטרים
listener השיחה החוזרת הופעלה. כדי לבטל את השיחה החוזרת, צריך להשתמש במספר null. אין לעדכן או להפעיל את המצלמה מתוך onCameraMoveStarted().

Public null setOnעיגולClickListener (GoogleMaps.OnעיגולClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על מעגל.

פרמטרים
listener הקריאה החוזרת (callback) מופעלת כשלוחצים על מעגל. כדי לבטל את השיחה החוזרת, צריך להשתמש במספר null.

Public null setOnGroundLayerClickListener (GoogleMaps.OnGroundLayerClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על שכבת-על של קרקע.

פרמטרים
listener הקריאה החוזרת (callback) מופעלת כשלוחצים על שכבת-על של קרקע. כדי לבטל את השיחה החוזרת, צריך להשתמש במדיניות null.

Public null setOnIndoorStateChangeListener (GoogleMaps.OnIndoorStateChangeListener Listener

מגדיר או מנקה את אירועי ההאזנה עבור אירועים בפנים. ניתן להגדיר רק מאזינים אחד. הגדרת האזנה חדשה תסיר את ההאזנה הקודמת.

פרמטרים
listener השומע לאירועים בתוך הבית אם אין לו ערך null; אחרת, הוא מאזין להאזנה

Public null setOnInfoWindowClickListener (GoogleMaps.OnInfoWindowClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על חלון מידע של סמן.

פרמטרים
listener השיחה החוזרת מופעלת כשמפעילים לחיצה על חלון מידע של סמן. כדי לבטל את השיחה החוזרת, צריך להשתמש במדיניות null.

Public null setOnInfoWindowCloseListener (GoogleMaps.OnInfoWindowCloseListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשחלון המידע של הסמן סגור.

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

Public null setOnInfoWindowLongClickListener (GoogleMaps.OnInfoWindowLongClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשחלון המידע של הסמן לוחץ לחיצה ארוכה.

פרמטרים
listener השיחה החוזרת מופעלת כשמפעילים לחיצה ארוכה על חלון המידע של סמן. כדי לבטל את הקריאה החוזרת (callback), צריך להשתמש במדיניות null.

Public null setOnmapClickListener (Googleמיפוי.OnMapsClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשמשתמשים מקישים על המפה.

פרמטרים
listener הקריאה החוזרת (callback) מופעלת כשההקשה על המפה. כדי לבטל את הקריאה החוזרת (callback), צריך להשתמש במדיניות null.

Public null setOnmapLoadedCallback (GoogleMaps.OnמיפויLoadedCallback קריאה חוזרת)

הגדרה של קריאה חוזרת (callback) שמופעלת כשהמפה הזו הסתיימה. הקריאה החוזרת (callback) תופעל רק פעם אחת.

אם השיטה הזו תופעל כשהמפה תעובד במלואה, השיחה החוזרת תופעל באופן מיידי. האירוע הזה לא יופעל אם המפה לא תיטען אף פעם בשל בעיות קישוריות, או אם המפה משתנה כל הזמן ומעולם לא הושלמה הטעינה עקב פעולות קבועות של המשתמש במפה.

פרמטרים
קריאה חוזרת (callback) השיחה החוזרת מופעלת כשהמפה מסתיימת. כדי לבטל את השיחה החוזרת, צריך להשתמש במדיניות null.

Public null setOnmapLongClickListener (Googleמיפוי.OnמיפויLongClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים לחיצה ארוכה במפה.

פרמטרים
listener השיחה החוזרת מופעלת כשהלחיצה ארוכה על המפה. כדי לבטל את השיחה החוזרת, צריך להשתמש במדיניות null.

Public null setOnMarkerClickListener (Googleמיפוי.OnMarkerClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על סמן.

פרמטרים
listener הקריאה החוזרת (callback) מופעלת כשלוחצים על סמן. כדי לבטל את השיחה החוזרת, צריך להשתמש במספר null.

Public null setOnMarkerDragListener (GoogleMaps.OnMarkerDragListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשגוררים את הסמן.

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

Public null setOnMyLocationButtonClickListener (GoogleMaps.OnMyLocationClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על לחצן המיקום שלי.

אם הפונקציה listener מחזירה את true, האירוע יושמט והתנהגות ברירת המחדל לא תתרחש. אם הפונקציה מחזירה את false, התנהגות ברירת המחדל תתרחש (למשל, המצלמה תזיז אותה כך שהיא תתמקד במיקום של המשתמש).

פרמטרים
listener השיחה החוזרת מופעלת כשהלחיצה על הלחצן 'המיקום שלי' מתבצעת.

Public null setOnMyLocationChangeListener (GoogleMaps.OnMyLocationChangeListener מאזין)

השיטה הזו הוצאה משימוש.
במקומה יש להשתמש ב-com.google.android.gms.location.FusedLocationProviderApi. FuseLocationProviderApi מספק איתור מיקום משופר ושימוש בחשמל, והוא בשימוש על ידי הנקודה הכחולה "המיקום שלי". ניתן לעיין בפעילות MyLocationDemoActivity בתיקייה לדוגמה של האפליקציות, לקבלת קוד לדוגמה או במדריך למפתחים בנושא מיקום.

מגדירה קריאה חוזרת שמופעלת כאשר הנקודה 'המיקום שלי' משנה מיקום.

פרמטרים
listener הקריאה החוזרת (callback) מופעלת כשהנקודה של 'המיקום שלי' משתנה.

Public null setOnMyLocationClickListener (GoogleMaps.OnMyLocationClickListener מאזין)

מגדירה קריאה חוזרת שמופעלת כאשר הנקודה 'המיקום שלי' (שמציינת את המיקום של המשתמש) לוחצים.

פרמטרים
listener הקריאה החוזרת (callback) מופעלת כשהלחיצה על הנקודה 'המיקום שלי'.

Public null setOnPoiClickListener (Googleמיפוי.OnPoiClickListener מאזין)

מגדיר האזנה שמופעלת כשלוחצים על נקודת עניין או מקישים עליה.

עליך לעבור את null כדי לנקות את המאזינים.

פרמטרים
listener

Public null setOnPolygonClickListener (GoogleMaps.OnPolygonClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על פוליגון.

פרמטרים
listener הקריאה החוזרת (callback) מופעלת כשלוחצים על פוליגון. כדי לבטל את השיחה החוזרת, צריך להשתמש במספר null.

Public null setOnPolylineClickListener (GoogleMaps.OnPolylineClickListener מאזין)

הגדרה של קריאה חוזרת (callback) שמופעלת כשלוחצים על רב-קו.

פרמטרים
listener הקריאה החוזרת (callback) מופעלת כשלוחצים על רב-קו. כדי לבטל את השיחה החוזרת, צריך להשתמש במספר null.

Public null setPמרווח (int left, int top, int right, int down)

המדיניות מאפשרת להגדיר מרווח פנימי במפה.

אפשר להשתמש בשיטה הזו כדי להגדיר אזור גלוי במפה. כך יוצג במפה שחלקים מהמפה מטושטשים, על ידי הגדרת המרווח הפנימי בכל אחד מ-4 הקצוות של המפה. פונקציות המפה יותאמו למרווח הפנימי. לדוגמה, לחצני הבקרה, המצפן, הודעות זכויות היוצרים והלוגו של Google יועברו כדי שיתאימו לאזור שהוגדר, התנועות במצלמה יהיו יחסיות למרכז האזור הגלוי וכו'.

פרמטרים
שמאלה מספר הפיקסלים להוספת מרווח פנימי משמאל למפה.
התחלה מספר הפיקסלים להוספת הרווח מעל המפה.
ימינה מספר הפיקסלים של המרווח הפנימי שיתווסף משמאל למפה.
סיום מספר הפיקסלים להוספת הרווח בתחתית המפה.

Public null setTrafficEnabled (ערך בוליאני מופעל)

הפעלה או השבתה של שכבת התנועה.

פרמטרים
פעיל

Public null snapshot (GoogleMaps.SnapshotReadyCallback קריאה חוזרת)

צילום מסך של המפה.

ניתן להשתמש בתמונות מצב בתוך האפליקציה כשקשה או קשה להשתמש במפה אינטראקטיבית. לדוגמה, ניתן להשתמש בתמונות שנוצרו בשיטה snapshot() כדי להציג תמונה ממוזערת של המפה באפליקציה שלך, או תמונת מצב במרכז ההתראות.

הערה: אין להעביר לשרתים את התמונות של המפה או להשתמש בהן מחוץ לאפליקציה. אם עליך לשלוח מפה לאפליקציה אחרת או למשתמש אחר, עליך לשלוח נתונים שמאפשרים לו לשחזר את המפה עבור המשתמש החדש במקום תמונת מצב.

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

Public null snapshot (Googleמיפוי.SnapshotReadyCallback callback, מפת סיביות שלbitmap)

צילום מסך של המפה.

שיטה זו מקבילה ל-snapshot(SnapshotReadyCallback), אך באפשרותך לספק Bitmap שמוקצה מראש. אם מפת סיביות לא תואמת למאפיינים הנוכחיים במפה, תוקצה מפת סיביות אחרת שתואמת למאפייני המפה.

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

פרמטרים
קריאה חוזרת (callback) שיטת הקריאה החוזרת מופעלת כשמצלמים את תמונת המצב.
מפת סיביות מפת סיביות של הקצאה מראש. אם null, פועל בדיוק כמו snapshot(SnapshotReadyCallback).

Public null הפסקת אנימציה ()

הפסקת האנימציה של המצלמה אם מתבצע שידור כזה. כשהשיטה מופעלת, המצלמה מפסיקה לזוז באופן מיידי ונשארת במיקום הזה.