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

‫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 API (חדש) לרשימת ממשקי ה-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: