סקירה כללית על מיגרציה

מפתחים באזור הכלכלי האירופי (EEA)

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

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

שיטות מומלצות לחיוב במהלך העברה

ההנחיות האלה רלוונטיות אם השימוש שלכם ב-API גבוה מספיק כדי לעבור למחיר ברמה השנייה. כשעוברים לגרסה חדשה יותר של API, מחויבים גם על מק"ט אחר. כדי להימנע מעלויות מוגדלות במהלך חודש המעבר, מומלץ לעבור ל-API החדש בסביבת הייצור כמה שיותר קרוב לתחילת החודש. כך תוכלו להגיע לרמות התמחור החודשיות הכי משתלמות במהלך חודש המעבר. למידע על רמות תמחור, אפשר לעיין בדף המחירים ובשאלות הנפוצות בנושא תמחור.

הפעלת Places API (חדש)

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

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

מוודאים שיש לכם מספיק מכסת שימוש ב-Places API (חדש)

חשוב לוודא שיש מספיק מכסת שימוש ב-Places API (חדש) כדי לכסות את התנועה הנוכחית. במאמר מכסות והתראות על מכסות מוסבר איך בודקים את המכסות ומגבלות השימוש ואיך מנהלים אותן.

שימו לב להבדל:

  • המכסה של Places SDK ל-Android (מדור קודם) מבוססת על המכסה של שירות Places API. זהו סכום כל ה-methods של Places API.
  • המכסה של Places SDK ל-Android (חדש) מבוססת על המכסה של שירות Places API (חדש). לכל שיטת API יש מכסה נפרדת.

בדיקה אם Places API (חדש) כלול בהסכם המשא ומתן

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

שינויים כלליים

דוגמאות לשינויים כלליים שחלים על כמה ממשקי API:

  • משתמש במודל תמחור חדש. למידע על המחירים של כל ממשקי ה-API, אפשר לעיין ב מחירון הגלובלי.

  • צריך לאתחל את האפליקציה באמצעות הקריאה לשיטה Places.initializeWithNewPlacesApiEnabled(). מידע נוסף על בחירת שירות Places API זמין במאמר בנושא הגדרת פרויקט ב-Google Cloud.

  • בשיטות Place Details (חדש),‏ חיפוש בסביבה (חדש) ו- חיפוש טקסט (חדש) צריך להשתמש במסכות שדות כדי לציין אילו שדות רוצים לקבל בתגובה.

  • נוספו מחלקות חדשות להגדרת הבקשות או להוספת שדות חדשים לתשובה.

  • אובייקט התגובה Place מכיל את השיטה החדשה getReviews() שמחזירה רשימה של אובייקטים מסוג Review. אם האפליקציה מציגה מידע שהתקבל מהאובייקט Place כמו תמונות וביקורות, היא צריכה להציג גם את הקרדיטים הנדרשים.

    מידע נוסף מופיע במאמר בנושא שיוכים.

שינויים ספציפיים ל-API

בקטע הזה מופיעים מדריכי ההעברה הבאים לכל API: