ב-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: