ב-Places SDK ל-Android (הגרסה החדשה) יש ביצועים משופרים ומודל תמחור חדש, ולכן כדאי לעדכן אפליקציות שמשתמשות ב-Places SDK ל-Android. למידע נוסף על השוואת תכונות, ראו בחירת ה-SDK.
במדריך הזה מוסבר מהם ההבדלים העיקריים בין Places SDK for Android (הגרסה החדשה) לבין Places SDK for Android, וגם איך לבצע את השינויים הנדרשים.
שיטות מומלצות לחיוב במהלך העברה
ההנחיה הזו רלוונטית אם נפח השימוש שלכם ב-API גבוה מספיק כדי לעבור לתמחור ברמה השנייה. כשעוברים לגרסה חדשה יותר של ממשק API, מחויב גם מק"ט אחר. כדי להימנע מעלייה בעלויות במהלך חודש המעבר, מומלץ לעבור לממשקי ה-API החדשים בסביבת הייצור כמה שיותר קרוב לתחילת החודש. כך תוכלו להגיע לרמות התמחור החודשיות הכי משתלמות במהלך חודש ההעברה. מידע על רמות התמחור זמין בדף התמחור ובשאלות הנפוצות בנושא תמחור.
הפעלת Places SDK ל-Android (חדש)
Places SDK ל-Android מסתמך על השירות Places API. כדי להשתמש בתכונות של Places SDK ל-Android (חדש), קודם צריך להפעיל את Places API (חדש) בפרויקט ב-Google Cloud. מידע נוסף זמין במאמר הגדרת הפרויקט ב-Google Cloud.
לאחר מכן, צריך לוודא שהוספתם את Places API (חדש) למפתח ה-API שבו האפליקציה משתמשת. מידע נוסף זמין במאמר שימוש במפתחות API.
שינויים כלליים
חלק מהשינויים הכלליים שחלים על כמה ממשקי API כוללים:
נעשה שימוש במודל תמחור חדש. למידע על התמחור של כל ממשקי ה-API, ראו Places SDK ל-Android (חדש).
כדי לציין אילו שדות יוחזרו בתגובה, צריך להשתמש בהסוואת שדות בפרטי המקום (חדש), בחיפוש בקרבת מקום (חדש) ובחיפוש טקסט (חדש).
נוספו כיתות חדשות כדי להגדיר את הבקשות או להוסיף שדות חדשים לתגובה.
אובייקט התגובה
Place
מכיל את השיטה החדשהgetReviews()
שמחזירה רשימה של אובייקטים מסוגReview
. כשמוצג באפליקציה מידע שהתקבל מהאובייקטPlace
, כמו תמונות וביקורות, צריך להציג באפליקציה גם את הקרדיטים הנדרשים.למידע נוסף, קראו את המאמר שיוך.
שינויים ספציפיים ל-API
בקטע הזה מופיעים מדריכי ההעברה הבאים לכל ממשק API: