Places API (חדש) מספק ביצועים משופרים ומודל תמחור חדש, ולכן כדאי לעדכן אפליקציות שמשתמשות ב-Places API. מידע נוסף על השוואת תכונות זמין במאמר בחירת ה-API.
המדריך הזה יעזור לכם להבין את ההבדלים העיקריים ב-Places API (חדש) בהשוואה ל-Places API, וגם איך לטפל בשינויים נחוצים.
הפעלת Places API (חדש)
כדי להשתמש בתכונות של Places API (חדש), צריך להפעיל קודם את Places API (New) בפרויקט Google Cloud. מידע נוסף זמין במאמר הגדרת הפרויקט ב-Google Cloud.
לאחר מכן עליכם לוודא שהוספתם את Places API (New) למפתח ה-API שבו האפליקציה משתמשת. מידע נוסף זמין במאמר שימוש במפתחות API.
שינויים כלליים
הנה כמה שינויים כלליים שחלים על כמה ממשקי API:
- כל ממשקי ה-API החדשים תומכים גם במפתחות API וגם באסימוני OAuth כמנגנון האימות.
- יש תמיכה רק ב-JSON כפורמט תגובה.
- כדי לציין אילו שדות רוצים להחזיר בתשובה, צריך לבצע אנונימיזציה של שדות באמצעות 'פרטי מקום (חדש'), 'חיפוש בקרבת מקום (חדש)' ו'חיפוש טקסט (חדש)'. למידע נוסף, ראו FieldMask.
- ממשקי ה-API של Nearby Search (חדש) ו-Text Search (New) מחזירים עכשיו את פרטי המקום המלאים, כדי שיתאימו לפרטי המקום שמוחזרים על ידי Place Details (New).
- הפורמט של התגובה בפורמט JSON לממשקי ה-API של פרטי מקום (חדש), חיפוש בקרבת מקום (חדש) וחיפוש טקסט (חדש) השתנה מהפורמט של ממשקי ה-API הקיימים. לפרטים נוספים קראו את המאמר העברת התגובה של Places API.
שינויים ספציפיים ל-API
בקטע הזה תמצאו את מדריכי ההעברה הבאים לכל API: