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

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

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

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

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

שגיאה: kGMSPlacesRateLimitExceeded

הודעה: אם אתם נתקלים בשגיאות באפליקציית iOS, יכול להיות שאתם משתמשים בגרסה שהוצאה משימוש של Places API.kGMSPlacesRateLimitExceeded גרסה 2.7.0 של Places API הוצאה משימוש ב-29 בינואר 2019, והושבתה ב-29 ביולי 2019. יש גרסה חדשה של Places API מומלץ לעדכן לגרסה החדשה בהקדם האפשרי. פרטים נוספים זמינים במדריך להעברת נתונים.

Places API (חדש)

‫Places SDK ל-iOS מסתמך על שירות Places API. כדי להשתמש בתכונות של Places SDK ל-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 (פרטי מקום) (חדש), Nearby Search (חיפוש בקרבת מקום) (חדש) ו- Text Search (חיפוש טקסט) (חדש) מחייבים שימוש במסכות שדות כדי לציין אילו שדות רוצים לקבל בתגובה.

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

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

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

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

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

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

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

• מעבר לפרטי מקום (חדש)
• מעבר ל-Place Photo (חדש)
• מעבר להשלמה אוטומטית (חדש)