סקירה כללית על ההעברה

ב-Places SDK ל-Android (הגרסה החדשה) יש ביצועים משופרים ומודל תמחור חדש, ולכן כדאי לעדכן אפליקציות שמשתמשות ב-Places SDK ל-Android. למידע נוסף על השוואת תכונות, ראו בחירת SDK.

המדריך הזה יעזור לכם להבין את ההבדלים העיקריים בין Places SDK ל-Android (הגרסה החדשה) לבין Places SDK ל-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: