ב-Places API (החדש) יש ביצועים משופרים ומודל תמחור חדש, ולכן כדאי לעדכן אפליקציות שמשתמשות ב-Places API. פרטים נוספים על השוואת תכונות זמינים במאמר בחירת ה-API.
המדריך הזה יעזור לכם להבין את ההבדלים העיקריים בין Places API (החדש) לבין Places API, וגם איך לבצע את השינויים הנדרשים.
שיטות מומלצות לחיוב במהלך העברה
ההנחיה הזו רלוונטית אם נפח השימוש שלכם ב-API גבוה מספיק כדי לעבור לתמחור ברמה השנייה. כשעוברים לגרסה חדשה יותר של ממשק API, מחויב גם מק"ט אחר. כדי להימנע מעלייה בעלויות במהלך חודש המעבר, מומלץ לעבור לממשקי ה-API החדשים בסביבת הייצור כמה שיותר קרוב לתחילת החודש. כך תוכלו להגיע לרמות התמחור החודשיות הכי משתלמות במהלך חודש ההעברה. מידע על רמות התמחור זמין בדף התמחור ובשאלות הנפוצות בנושא תמחור.
הפעלת Places API (חדש)
כדי להשתמש בתכונות של Places API (חדש), תחילה צריך להפעיל את Places API (חדש) בפרויקט ב-Google Cloud. למידע נוסף, קראו את המאמר הגדרת הפרויקט ב-Google Cloud.
לאחר מכן, צריך לוודא שהוספתם את Places API (חדש) למפתח ה-API שבו האפליקציה משתמשת. למידע נוסף, ראו שימוש במפתחות API.
שינויים כלליים
חלק מהשינויים הכלליים שחלים על כמה ממשקי API כוללים:
- כל ממשקי ה-API החדשים תומכים גם במפתחות API וגם באסימוני OAuth כמנגנון אימות.
- יש תמיכה רק בפורמט JSON בתור פורמט תגובה.
- אנונימיזציה של שדות נדרשת ב'פרטי המקום' (חדש), ב'חיפוש בקרבת מקום' (חדש) וב'חיפוש טקסט' (חדש) כדי לציין אילו שדות רוצים שיוחזר בתגובה. למידע נוסף, ראו FieldMask.
- ממשקי ה-API של החיפוש בקרבת מקום (חדש) ושל החיפוש בטקסט (חדש) מחזירים עכשיו את פרטי המקום המלאים, בהתאם לפרטי המקום שמוחזרים על ידי פרטי המקום (חדש).
- פורמט התגובה ב-JSON של ממשקי ה-API פרטי מקום (חדש), חיפוש בקרבת מקום (חדש) וחיפוש טקסט (חדש) השתנה מהפורמט של ממשקי ה-API הקיימים. מידע נוסף זמין במאמר העברת התגובה של Places API.
שינויים ספציפיים ל-API
בקטע הזה מופיעים מדריכי ההעברה הבאים לכל ממשק API: