מבוא
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.
- חובה להשתמש במיסוך שדות בשיטות Place Details (חדש), Nearby Search (חדש) ו-Text Search (חדש) כדי לציין אילו שדות רוצים להחזיר בתגובה. מידע נוסף זמין במאמר בנושא FieldMask.
- ממשקי Nearby Search (New) ו-Text Search (New) מחזירים עכשיו את כל פרטי המקום, כמו בממשק Place Details (New).
- פורמט התגובה ב-JSON עבור ממשקי ה-API של פרטי מקום (חדש), חיפוש בקרבת מקום (חדש) וחיפוש טקסט (חדש) שונה מהפורמט של ממשקי ה-API הקיימים. מידע נוסף מופיע במאמר העברה של תגובת Places API.
שינויים ספציפיים ל-API
בקטע הזה מופיעים מדריכי ההעברה הבאים לכל API:
- מעבר לחיפוש בסביבה (חדש)
- מעבר לחיפוש טקסט (חדש)
- מעבר לפרטי מקומות (חדש)
- העברה לתמונות של מקומות (חדש)
- העברה להשלמה אוטומטית (חדש)