Places SDK ל-iOS (חדש) מספק ביצועים משופרים ומודל תמחור חדש, ולכן כדאי לעדכן אפליקציות שמשתמשות ב-Places SDK ל-iOS (גרסה קודמת). לפרטים נוספים על השוואת תכונות, אפשר לעיין במאמר בנושא בחירת ה-SDK.
המדריך הזה נועד לעזור לכם להבין את ההבדלים העיקריים בין Places SDK ל-iOS (חדש) לבין Places SDK ל-iOS (גרסה קודמת), וגם איך לבצע את השינויים הנדרשים.
שיטות מומלצות לחיוב במהלך העברה
ההנחיות האלה רלוונטיות אם השימוש שלכם ב-API גבוה מספיק כדי לעבור לתמחור ברמה השנייה. כשעוברים לגרסה חדשה יותר של API, מחויבים גם על מק"ט אחר. כדי להימנע מעלויות מוגדלות במהלך חודש המעבר, מומלץ לעבור ל-API החדש בסביבת הייצור כמה שיותר קרוב לתחילת החודש. כך תוכלו להגיע לרמות התמחור החודשיות הכי משתלמות במהלך חודש המעבר. מידע על רמות התמחור מופיע בדף המחירים ובשאלות הנפוצות בנושא מחירים.
שגיאה: kGMSPlacesRateLimitExceeded
הפעלת Places SDK ל-iOS (חדש)
Places SDK ל-iOS מסתמך על השירות Places API. כדי להשתמש בתכונות של Places SDK for iOS (חדש), צריך קודם להפעיל את Places API (חדש) בפרויקט ב-Google Cloud. למידע נוסף, ראו הגדרת פרויקט Google Cloud.
לאחר מכן, צריך לוודא שהוספתם את Places API (חדש) למפתח ה-API שבו האפליקציה משתמשת. למידע נוסף, ראו שימוש במפתחות API.
שינויים כלליים
שינויים כלליים שחלים על כמה ממשקי API:
משתמש במודל תמחור חדש. מידע על התמחור של כל ממשקי ה-API זמין במאמר תמחור של Places SDK ל-iOS (חדש).
בשיטות Place Details (פרטי מקום) (חדש), Nearby Search (חיפוש בקרבת מקום) (חדש) ו- Text Search (חיפוש טקסטואלי) (חדש) צריך להשתמש במסכות שדות כדי לציין אילו שדות רוצים לקבל בתגובה.
GMSPlacesClient
כולל שיטות חדשות לקריאה לממשקי ה-API החדשים האלה.נוספו מחלקות חדשות כדי להגדיר את הבקשה לכל אחד מהממשקי ה-API החדשים.
מופע התגובה
GMSPlace
מכיל את המאפיין החדשreviews
מסוגGMSPlaceReview
. אם האפליקציה מציגה מידע שהתקבל ממופעGMSPlace
, כמו תמונות וביקורות, היא צריכה להציג גם את הקרדיטים הנדרשים.מידע נוסף זמין במאמר בנושא שיוכים.
שינויים ספציפיים ל-API
בקטע הזה מופיעים מדריכי ההעברה הבאים לכל API: