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