באמצעות Places SDK אפשר לחפש מידע על מגוון סוגי מקומות ולשלוף אותו באמצעות מחרוזת טקסט או לפי קרבת מקום. Places SDK היא הגרסה הקודמת של Places SDK (חדש).
המדריך הזה יעזור לכם להבין את ההבדלים העיקריים בין הגרסאות של Places SDK ולעבור ל-Places SDK (חדש).
תכונות ה-SDK שזמינות בכל גרסה
בטבלה הבאה מפורטות גרסאות ה-SDK וה-API הנדרשות לכל מאפיין של ה-SDK:
| תכונה | Places API מופעל במפתח ה-API | שיטת האתחול | גרסת ה-SDK המינימלית |
|---|---|---|---|
| השלמה אוטומטית (חדש) | Places API (חדש) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| פרטי המקום (חדש) | Places API (חדש) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| חיפוש בקרבת מקום (חדש) | Places API (חדש) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| תמונות של המקום (חדש) | Places API (חדש) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| חיפוש טקסט (חדש) | Places API (חדש) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| השלמה אוטומטית למקומות | Places API | initialize() |
|
| המיקום הנוכחי | Places API | initialize() |
|
| פרטי המקום | Places API | initialize() |
|
| תמונות של המקום | Places API | initialize() |
מעבר לממשקי ה-API החדשים
כדי לעבור לממשקי ה-API החדשים, אפשר לעיין במדריכי המעבר הבאים:
שיפורים ב-Places SDK ל-Android (חדש)
בקטע הזה מפורטות תכונות מרכזיות שנוספו ל-Places SDK ל-Android (חדש).
הטמעה בפלטפורמה הרגילה של Google Cloud
Places SDK ל-Android (חדש) מוטמע בתשתית השירות ב-Google Cloud. ההטמעה הזו מאפשרת לכם ליהנות מפלטפורמה מאובטחת ואמינה יותר. העיצוב הסטנדרטי הזה מביא רמה של עקביות בין ערכות ה-SDK, שמשפרת את היעילות של הפיתוח באמצעות Places SDK ל-Android (חדש).
ביצועים משופרים
ב-Places SDK ל-Android (הגרסה החדשה) יש ביצועים משופרים, ולכן כדאי להחליף אפליקציות שמשתמשות ב-SDK הקיים.
תכונות חדשות
Places SDK ל-Android (הגרסה החדשה) כולל את הגרסאות העדכניות ביותר של כל התכונות של ה-SDK:
שירות חדש לחיפוש טקסט
חיפוש טקסט (חדש) מחזיר מידע על קבוצת מקומות על סמך מחרוזת – לדוגמה, 'פיצה בניו יורק' או 'חנויות נעליים ליד נתניה' או 'רחוב ראשי 123'. השירות יגיב עם רשימה של מקומות שתואמים למחרוזת הטקסט ולנטיית המיקום שהוגדרה.
נתוני תגובה חדשים נוספו ל'פרטי המיקום' (חדש) ול'תמונות של המקום' (חדש)
פרטי המקום (חדש) כולל עכשיו את הכיתה החדשה Review באובייקט התגובה
Place. השיטה החדשהgetReviews()לתמיכה בשדה הזה נמצאת בכיתה Place. אפשר להקיש עלgetReviews()כדי להציג עד חמש ביקורות על מקום מסוים.הוספת תמונה (חדש) – הוספת התמונה
AuthorAttributionsלכיתהPhotoMetadata.AuthorAttributionsמכילListשל אובייקטים מסוגAuthorAttribution.
תגובה חדשה של URI נוספה ל'תמונות של מקומות' (חדש)
מעכשיו אפשר להשתמש ב-Place Photo (חדש) כדי להחזיר URI לתמונה בפורמט bitmap. בעבר, אפשר היה להחזיר רק את ה-bitmap של התמונה עצמה.
תמחור פשוט
התמחור פשוט יותר ב-Places SDK ל-Android (חדש), כך שמשלמים רק על הנתונים שבהם משתמשים. התמחור המפושט מיושם באמצעות רשימות שדות, שנקראות גם מסכות שדות.
כשמשתמשים ב'פרטי מקום' וב'חיפוש טקסט', אפשר להשתמש ברשימות שדות כדי לקבוע אילו שדות יופיעו בתגובה. לאחר מכן, תחויבו רק על הנתונים שביקשת. שימוש ברשימת שדות הוא שיטה טובה לתכנון כדי לוודא שאתם לא מבקשים נתונים מיותרים, וכך להימנע מזמן עיבוד מיותר וחיובים מיותרים.
מידע מפורט על התמחור של שתי ערכות ה-SDK זמין במאמר שימוש וחיובים.
סוגי מקומות מורחבים
ה-SDK החדש כולל סוגי מקומות חדשים, שמוחזרים כחלק מהתגובה של 'פרטי המיקום' ו'חיפוש טקסט'. אפשר גם להשתמש בסוגי הנכסים החדשים האלה ובסוגי הנכסים הקיימים בחיפוש באמצעות חיפוש טקסט. הסוגים החדשים מפורטים בטבלה א.