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