מבוא
ב-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:
- מעבר לחיפוש בסביבה (חדש)
- מעבר לחיפוש טקסט (חדש)
- העברה אל פרטי המקום (חדש)
- העברה אל 'תמונות במקום' (חדש)
- מעבר להשלמה אוטומטית (חדש)