מחלקה שמכילה שיטות ליצירת CameraUpdate
אובייקטים שמשנים את המצלמה של המפה.
כדי לשנות את המצלמה של המפה צריך להתקשר אל animateCamera(CameraUpdate)
, animateCamera(CameraUpdate, GoogleMap.CancelableCallback)
או moveCamera(CameraUpdate)
באמצעות אובייקט CameraUpdate
שנוצר עם המחלקה הזו.
לדוגמה, כדי להגדיל את התצוגה במפה, תוכלו להשתמש בקוד הבא:
GoogleMap map = ...;
map.animateCamera(CameraUpdateFactory.zoomIn());
לפני השימוש ב-methods של הכיתה הזו, צריך לבצע אחת מהפעולות הבאות כדי לוודא שהמחלקה הזו מאותחלת:
- יש להמתין עד ש-
GoogleMap
יהיה זמין ב-MapFragment
או ב-MapView
שהוספת לאפליקציה. כדי למצוא את המופע שלGoogleMap
, צריך להתקשר אלgetMapAsync()
ולהמתין לקריאה החוזרת (callback) שלonMapReady(GoogleMap map)
. - התקשרו אל
initialize(Context)
. כל עודGooglePlayServicesNotAvailableException
לא זורקים, המחלקה הזו תופעל באופן תקין.
מדריך למפתחים
לקבלת מידע נוסף, ניתן לעיין במדריך למפתחים בנושא מצלמה ותצוגה.
סיכום אמצעי תשלום ציבורי
CameraUpdate סטטי |
newCameraPosition(CameraPosition CameraPosition)
הפונקציה מחזירה
CameraUpdate שמעביר את המצלמה ל-CameraPosition שצוין. |
CameraUpdate סטטי |
newLatLng(LatLng latLng)
הפונקציה מחזירה את
CameraUpdate שמעביר את מרכז המסך לקו הרוחב וקו האורך שצוינו על ידי אובייקט LatLng . |
CameraUpdate סטטי |
newLatLngBounds(אורך LatLngBounds, רוחב int, גובה int, מרווח פנימי int)
הפונקציה מחזירה את הערך
CameraUpdate שמשנה את המצלמה כך שקווי הרוחב/האורך שצוינו ממורכזים במסך בתוך תיבה תוחמת של מימדים שצוינו
ברמת הזום הגבוהה ביותר האפשרית. |
CameraUpdate סטטי |
newLatLngBounds(שוליים של LatLngBounds, מרווח פנימי int)
הפונקציה מחזירה את
CameraUpdate שמשנה את המצלמה כך שקווי הרוחב/האורך שצוינו ממורכזים במסך ברמת הזום הגבוהה ביותר האפשרית. |
CameraUpdate סטטי |
newLatLngZoom(אורך LatLng, זום צף)
הפונקציה מחזירה את
CameraUpdate שמזיז את מרכז המסך לקו הרוחב והאורך שצוינו על ידי אובייקט LatLng , וזזת לרמת הזום הנתונה. |
CameraUpdate סטטי |
scrollBy(float xPixel, yPixel לצוף)
הפונקציה מחזירה
CameraUpdate שגוללת את המצלמה מעל המפה, ומשנה את מרכז התצוגה לפי מספר הפיקסלים שצוין בכיוונים x ו-y. |
CameraUpdate סטטי |
zoomBy(כמות ציפה, מיקוד נקודה)
הפונקציה מחזירה
CameraUpdate שמשנה את רמת הזום של נקודת המבט הנוכחית במצלמה. |
CameraUpdate סטטי |
zoomBy(כמות צפה)
הפונקציה מחזירה
CameraUpdate שמשנה את רמת הזום של נקודת המבט הנוכחית במצלמה. |
CameraUpdate סטטי |
zoomIn()
הפונקציה מחזירה
CameraUpdate שמקרבת את הגובה של נקודת המבט לפני השטח של כדור הארץ. |
CameraUpdate סטטי |
zoomOut()
הפונקציה מחזירה
CameraUpdate שמקטינה את התצוגה במפה על ידי הזזת גובה נקודת המבט למרחק גדול יותר מפני כדור הארץ. |
CameraUpdate סטטי |
zoomTo(זום צף)
הפונקציה מחזירה את הערך
CameraUpdate שמזיז את נקודת המבט של המצלמה לרמת זום מסוימת. |
סיכום שיטות שעברו בירושה
שיטות ציבוריות
ציבורי סטטי CameraUpdate newCameraPosition (CameraPosition CameraPosition)
הפונקציה מחזירה CameraUpdate
שמעביר את המצלמה ל-CameraPosition
שצוין. למעשה, נוצרת טרנספורמציה על סמך קו הרוחב,
קו האורך, המרחק מהתצוגה, הכיוון וההטיה של האובייקט CameraPosition
.
פרמטרים
cameraPosition |
---|
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate newLatLng (LatLng latLng)
הפונקציה מחזירה את CameraUpdate
שמעביר את מרכז המסך לקו הרוחב וקו האורך שצוינו על ידי אובייקט LatLng
. פעולה זו ממרכזת את המצלמה על האובייקט LatLng
.
פרמטרים
latLng | אובייקט LatLng שמכיל את קווי האורך והרוחב הרצויים. |
---|
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate newLatLngBounds (LatLngBounds bounds, intwidth, int height, int מרווח)
הפונקציה מחזירה את הערך CameraUpdate
שמשנה את המצלמה כך שקווי הרוחב/האורך שצוינו ממורכזים במסך בתוך תיבה תוחמת של מימדים שצוינו
ברמת הזום הגבוהה ביותר האפשרית. אפשר לציין מרווח פנימי נוסף כדי להגביל עוד יותר את גודל התיבה התוחמת. ל-CameraUpdate
שמוחזר יש נושא של 0 וההטיה
של 0.
בשונה מ-newLatLngBounds(LatLngBounds, int)
, אפשר להשתמש בפונקציה CameraUpdate
שמוחזרת בשיטה הזו כדי לשנות את המצלמה לפני שלב הפריסה של המפה, כי
הארגומנטים מציינים את הגודל הרצוי של התיבה התוחמת.
פרמטרים
גבולות | את האזור כך שיתאים לתיבה התוחמת |
---|---|
רוחב | רוחב תיבה תוחמת בפיקסלים (px) |
גובה | גובה התיבה התוחמת בפיקסלים (px) |
padding | הגבלת גודל נוספת (בפיקסלים) של התיבה התוחמת. |
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate newLatLngBounds (LatLngBounds bounds, int מרווח)
הפונקציה מחזירה את CameraUpdate
שמשנה את המצלמה כך שקווי הרוחב/האורך שצוינו ממורכזים במסך ברמת הזום הגבוהה ביותר האפשרית. אפשר לציין מרווח פנימי כדי להציב את התיבה התוחמת מהקצוות של תצוגת המפה. הערך של CameraUpdate
שמוחזר הוא 0 והטיה של 0.
אין להחליף את המצלמה עם עדכון המצלמה הזה לפני שהמפה עוברת פריסה (כדי
שהשיטה הזו תקבע בצורה נכונה את התיבה התוחמת המתאימה ואת רמת המרחק מהתצוגה, המפה חייבת להיות בגודל). אחרת, יוקצה IllegalStateException
. כדי שהמפה תהיה זמינה,
התצוגה שמכילה את המפה חייבת גם לעבור פריסה, כך שהמידות שלה נקבעו. אם לא ניתן לדעת בוודאות שזה קרה, יש להשתמש במקום זאת ב-newLatLngBounds(LatLngBounds, int, int, int)
ולציין את
מידות המפה באופן ידני.
פרמטרים
גבולות | אזור להתאמה למסך |
---|---|
padding | רווח (בפיקסלים) כדי לצאת בין הקצוות של התיבה התוחמת לבין הקצוות של התצוגה. הערך הזה מוחל על כל ארבעת הצדדים של התיבה התוחמת. |
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate newLatLngZoom (LatLng latLng, זום צף)
הפונקציה מחזירה את CameraUpdate
שמזיז את מרכז המסך לקו הרוחב והאורך שצוינו על ידי אובייקט LatLng
, וזזת לרמת הזום הנתונה.
פרמטרים
latLng | אובייקט LatLng שמכיל את קווי האורך והרוחב הרצויים. |
---|---|
זום, zoom | את המרחק הרצוי מהתצוגה, בטווח של 2.0 עד 21.0. הערכים שמתחת לטווח הזה מוגדרים ל-2.0, והערכים שמעליו מוגדרים ל-21.0. מגדילים את הערך כדי להגדיל את התצוגה. לא בכל האזורים יש משבצות ברמת הזום הגדולה ביותר. |
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate scrollBy (float xPixel, float yPixel)
הפונקציה מחזירה CameraUpdate
שגוללת את המצלמה מעל המפה, ומשנה את מרכז התצוגה לפי מספר הפיקסלים שצוין בכיוונים x ו-y.
דוגמאות:
- אם xPixel = 5 ו-yPixel = 0, המערכת גוללת ימינה על ידי הזזת המצלמה כך שנראה שהמפה הוזזה 5 פיקסלים שמאלה.
- אם xPixel = 0 ו-yPixel = 5, המערכת גוללת למטה על ידי הזזת המצלמה כך שהמפה זזה 5 פיקסלים למעלה.
הגלילה היא יחסית לכיוון הנוכחי של המצלמה. לדוגמה, אם המצלמה מייצרת 90 מעלות, אז מזרח היא "למעלה" וגלילה ימינה תזיז את המצלמה דרומה.
פרמטרים
xPixel | מספר הפיקסלים שיש לגלול אופקית. ערך חיובי מעביר את המצלמה ימינה, ביחס לכיוון הנוכחי שלה. ערך שלילי מזיז את המצלמה לשמאל, ביחס לכיוון הנוכחי שלה. |
---|---|
yPixel | מספר הפיקסלים לגלילה אנכית. ערך חיובי מזיז את המצלמה למטה ביחס לכיוון הנוכחי שלה. ערך שלילי מזיז את המצלמה כלפי מעלה, ביחס לכיוון הנוכחי שלה. |
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate zoomBy (float amount, Point Focus)
הפונקציה מחזירה CameraUpdate
שמשנה את רמת הזום של נקודת המבט הנוכחית במצלמה.
נקודה שמצוינת על ידי המוקד תישאר קבועה (כלומר, היא תואמת לאותו קו אורך/קו אורך לפני ואחרי תהליך המרחק מהתצוגה).
השיטה הזו שונה מ-zoomTo(float)
מבחינת הזום הזה ביחס למצלמה הנוכחית.
לדוגמה, אם הערך LatLng
(11.11, 22.22) נמצא כרגע במיקום המסך (23, 45). אחרי שמפעילים את השיטה הזו עם שינוי מרחק התצוגה והLatLng
, מיקום המסך של ה-LatLng
הזה עדיין יהיה (23, 45).
פרמטרים
את הסכום | כדי לשנות את רמת הזום. ערכים חיוביים מציינים התקרבות לפני השטח של כדור הארץ, וערכים שליליים מציינים התקרבות מפני השטח של כדור הארץ. |
---|---|
מיקוד | מיקום הפיקסל במסך שיישאר קבוע לאחר תהליך שינוי המרחק מהתצוגה. קו הרוחב/אורך שהיה במיקום הפיקסל הזה לפני הזזת המצלמה לא ישתנה אחרי הזזת המצלמה. |
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate zoomBy (float amount)
הפונקציה מחזירה CameraUpdate
שמשנה את רמת הזום של נקודת המבט הנוכחית במצלמה.
השיטה הזו שונה מ-zoomTo(float)
מבחינת הזום הזה ביחס למצלמה הנוכחית.
פרמטרים
את הסכום | כדי לשנות את רמת הזום. ערכים חיוביים מציינים התקרבות לפני השטח של כדור הארץ, וערכים שליליים מציינים התקרבות מפני השטח של כדור הארץ. |
---|
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate zoomIn ()
הפונקציה מחזירה CameraUpdate
שמקרבת את הגובה של נקודת המבט לפני השטח של כדור הארץ. הגדלת הזום היא 1.0.
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate zoomOut ()
הפונקציה מחזירה CameraUpdate
שמקטינה את התצוגה במפה על ידי הזזת גובה נקודת המבט למרחק גדול יותר מפני כדור הארץ. הגדלת הזום היא 1.0-.
החזרות
CameraUpdate
שמכיל את הטרנספורמציה.
ציבורי סטטי CameraUpdate zoomTo (זום צף)
הפונקציה מחזירה את הערך CameraUpdate
שמזיז את נקודת המבט של המצלמה לרמת זום מסוימת.
פרמטרים
זום, zoom | את המרחק הרצוי מהתצוגה, בטווח של 2.0 עד 21.0. הערכים שמתחת לטווח הזה מוגדרים ל-2.0, והערכים שמעליו מוגדרים ל-21.0. מגדילים את הערך כדי להגדיל את התצוגה. לא בכל האזורים יש משבצות ברמת הזום הגדולה ביותר. |
---|