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