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