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