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