SDK של מפות לספריית השירותים ב-Android

בחירת פלטפורמה: Android iOS

רוצים להוסיף תכונות מתקדמות למפות שלכם? ‫SDK של מפות ל-Android Utility Library היא ספריית קוד פתוח של מחלקות שמועילות למגוון אפליקציות. המאגר ב-GitHub כולל את מחלקות השירות ואפליקציית הדגמה שממחישה את השימוש בכל מחלקה.

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

הגדרה מהירה

כדי להתקין את ‫SDK של מפות ל-Android Utility Library, פועלים לפי המדריך להגדרה.

הכלים

	ייבוא GeoJSON למפה אתם יכולים לאחסן תכונות בפורמט GeoJSON ולהשתמש בכלי הזה כדי לעבד אותן כשכבה מעל המפה. מפעילים את addLayer() כדי להוסיף את נתוני ה-GeoJSON למפה. אפשר גם להוסיף תכונות ספציפיות באמצעות קריאה ל-addFeature(), והעברת אובייקט GeoJsonFeature. פרטים נוספים זמינים במסמכי התיעוד של Google Maps Android GeoJSON Utility.
	ייבוא קובץ KML למפה בעזרת הכלי הזה, אתם יכולים להמיר אובייקטים של KML לצורות גיאוגרפיות ולעבד אותם כשכבה מעל המפה. מפעילים את addLayerToMap() כדי להוסיף את השכבה למפה. אפשר לגשת למאפיינים באובייקט KML על ידי קריאה ל-getProperties() בכל Placemark, ‏ GroundOverlay, ‏ Document או Folder. פרטים נוספים זמינים במסמכי התיעוד של Google Maps Android KML Utility.
	הוספת מפות חום למפה מפות חום עוזרות לצופים להבין את ההתפלגות ואת העוצמה היחסית של נקודות על הגרף במפה. במקום להציב סמן בכל מיקום, במפות חום משתמשים בצבע ובצורה כדי לייצג את התפלגות הנתונים. יוצרים HeatmapTileProvider ומעבירים לו אוסף של אובייקטים מסוג LatLng שמייצגים נקודות עניין במפה. לאחר מכן יוצרים TileOverlay חדש, מעבירים אליו את ספק המשבצות של מפת החום ומוסיפים את שכבת-העל של המשבצות למפה. פרטים נוספים זמינים במסמכי התיעוד של Google Maps Android Heatmap Utility.
	התאמה אישית של סמנים באמצעות סמלי בועה מוסיפים IconGenerator כדי להציג קטעי מידע על הסמנים. הכלי הזה מאפשר לגרום לסמלי הסמנים להיראות קצת כמו חלונות מידע, בכך שהסמן עצמו יכול להכיל טקסט ותוכן אחר. היתרון הוא שאפשר להשאיר יותר מסמן אחד פתוח בו-זמנית, בעוד שרק חלון מידע אחד יכול להיות פתוח בכל פעם. אפשר גם לעצב את הסמנים, לשנות את הכיוון של הסמן או של התוכן, ולשנות את תמונת הרקע או את ה-nine-patch של הסמן.
	הוספת אנימציה לסמנים אפשר להוסיף אנימציה לסמן כדי שהוא יעבור בצורה חלקה מהמיקום הנוכחי שלו למיקום חדש. היכולת הזו קיימת במחלקה AnimationUtil. דוגמה לשימוש ב-AnimationUtilDemoActivity מופיעה במאגר GitHub של ספריית הכלים.
	ניהול מקבצי סמנים ה-ClusterManager עוזר לנהל כמה סמנים ברמות זום שונות. כך אפשר להציב מספר גדול של סמנים במפה בלי לפגוע בקריאות שלה. כשמשתמש צופה במפה ברמת זום גבוהה, הסמנים הבודדים מוצגים במפה. כשהמשתמש מקטין את התצוגה לרמת זום נמוכה יותר, הסמנים מתקבצים לאשכולות כדי שיהיה קל יותר לראות את המפה. פרטים נוספים זמינים במסמכי התיעוד של כלי השירות של מפות Google לקיבוץ סמנים ב-Android.
	הוספה של כמה שכבות לאותה מפה אתם יכולים להציג תכונות מ-GeoJSON, מ-KML ומאשכולות – וגם סמנים, קווים פוליגוניים ופוליגונים משלכם – כולם באותה מפה. אפשר גם להפוך את השכבות האלה לאינטראקטיביות על ידי הוספת רכיב click listener לכל שכבה. כדי לעשות את זה, צריך ליצור מופע של המחלקות MarkerManager,‏ GroundOverlayManager,‏ PolygonManager ו-PolylineManager ולהעביר אותן ל-constructors של GeoJsonLayer,‏ KmlLayer ו-ClusterManager כשמגדירים אותם. אחר כך תוכלו להשתמש במחלקות האלה של Manager ישירות כדי להוסיף למפה סמנים, קווים פוליגוניים ופוליגונים משלכם. פרטים נוספים זמינים במסמכי התיעוד של Google Maps Android Multi Layer Demo.
	קידוד ופענוח של קווים פוליגוניים הסוג PolyUtil ממיר קווים פוליגוניים ופוליגונים מקודדים לקואורדינטות של קווי רוחב/אורך, וממיר קואורדינטות לקווים פוליגוניים ופוליגונים מקודדים. במפות Google, הקואורדינטות של קווי הרוחב והאורך שמגדירות קו פוליגוני או פוליגון מאוחסנות כמחרוזת מקודדת. הסבר מפורט על קידוד קו פוליגוני יכול להיות שתקבלו את המחרוזת המקודדת הזו בתגובה מ-Google API, כמו Directions API (מדור קודם). אפשר להשתמש ב-PolyUtil ב-SDK של מפות ל-Android Utility Library כדי לקודד רצף של קואורדינטות קו רוחב/קו אורך (LatLngs) למחרוזת נתיב מקודדת, ולפענח מחרוזת נתיב מקודדת לרצף של LatLngs. כך תוכלו להבטיח יכולת פעולה הדדית עם שירותי האינטרנט של Google Maps APIs.
	חישוב מרחקים, שטחים וכיוונים באמצעות גיאומטריה כדורית בעזרת כלי העזר לגיאומטריה כדורית ב-SphericalUtil, אפשר לחשב מרחקים, שטחים וכיוונים על סמך קווי רוחב וקווי אורך. הנה כמה מהשיטות שזמינות בכלי: ‫computeDistanceBetween() – מחזירה את המרחק במטרים בין שתי קואורדינטות של קו רוחב/אורך. ‫computeHeading() – הפונקציה מחזירה את הכיוון, במעלות, בין שתי קואורדינטות של קו רוחב/קו אורך. ‫computeArea() – מחזירה את השטח, במטרים רבועים, של נתיב סגור בכדור הארץ. ‫interpolate() – מחזירה את הקואורדינטות של קו הרוחב/קו האורך של נקודה שנמצאת בחלק נתון מהמרחק בין שתי נקודות נתונות. לדוגמה, אפשר להשתמש בזה כדי ליצור אנימציה של סמן בין שתי נקודות. רשימה מלאה של השיטות בכלי מופיעה במאמרי העזרה.
	איך בודקים אם מיקום מסוים נתמך ב-Street View הכיתה StreetViewUtil מספקת פונקציונליות לבדיקה אם מיקום נתמך ב-Street View. כדי למנוע שגיאות כשמוסיפים פנורמה ב-Street View לאפליקציה ל-Android, אפשר להפעיל את כלי המטא-נתונים הזה ולהוסיף פנורמה ב-Street View רק אם התגובה היא OK. פרטים נוספים זמינים במסמכי התיעוד של כלי המטא-נתונים של Street View ב-GitHub.