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

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

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

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

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

שגיאה: kGMSPlacesRateLimitExceeded

Places API (חדש)

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

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

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

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

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

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

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

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

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

  • מודל תמחור חדש. מידע על התמחור של כל ממשקי ה-API זמין במאמר תמחור של Places SDK ל-iOS (חדש).

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

  • GMSPlacesClient מכיל שיטות חדשות לקריאה לממשקי ה-API החדשים האלה.

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

  • מופע התגובה GMSPlace מכיל את המאפיין החדש reviews מסוג GMSPlaceReview. כשהאפליקציה מציגה מידע שהתקבל מהמופע של GMSPlace, כמו תמונות וביקורות, היא צריכה להציג גם את השיוכים הנדרשים.

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

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

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