מבוא
באמצעות Places API אפשר לחפש ולאחזר מידע על מגוון סוגי מקומות באמצעות מחרוזת טקסט או לפי קרבה. Places API (מדור קודם) הוא הגרסה הקודמת של Places API (חדש).
בטבלה הבאה מפורטות הגרסאות התואמות של שני ממשקי ה-API. המדריך הזה יעזור לכם להבין את ההבדלים העיקריים בין שתי הגרסאות ולעבור ל-Places API (החדש).
| Places API (הגרסה הקודמת) | Places API (חדש) | הערות |
|---|---|---|
| חיפוש מקום (גרסה קודמת) | חיפוש טקסט (חדש) | אין גרסה חדשה של Find Place (Legacy). היא הוחלפה בגרסה החדשה של חיפוש טקסט. |
| חיפוש בסביבה (גרסה קודמת) | חיפוש בסביבה (חדש) | בכל הבקשות שמשתמשות ב-API הקודם וכוללות שאילתת טקסט, צריך להשתמש בחיפוש טקסט (חדש) כי "חיפוש בסביבה (חדש)" לא תומך בקלט טקסט. |
| חיפוש טקסט (גרסת קודמת) | חיפוש טקסט (חדש) | |
| Place Details (דור קודם) | פרטי מקום (חדש) | |
| Place Photos (דור קודם) | תמונות של מקומות (חדש) | |
| השלמה אוטומטית למקומות (גרסה קודמת) | השלמה אוטומטית (חדש) | |
| השלמה אוטומטית של שאילתות (דור קודם) | השלמה אוטומטית (חדש) | יכולות חדשות נוספו להשלמה האוטומטית (חדש). |
מעבר לממשקי ה-API החדשים
כדי לעבור לממשקי ה-API החדשים, אפשר לעיין במדריכים הבאים להעברת נתונים (מיגרציה):
- מעבר לגרסה החדשה של "חיפוש בסביבה"
- מעבר לחיפוש טקסט (חדש)
- מעבר ל-Place Details (New)
- מעבר ל-Place Photos (חדש)
- מעבר ל-Autocomplete (New)
תכונות עיקריות שנוספו ל-Places API (חדש)
בקטע הזה מפורטות התכונות העיקריות שנוספו ל-Places API (החדש).
מיושם בפלטפורמה הרגילה של Google Cloud
Places API (החדש) מוטמע בתשתית השירות ב-Google Cloud. ההטמעה הזו מספקת פלטפורמה מאובטחת ומהימנה יותר, עם אפשרויות אבטחה משופרות כמו OAuth. התכנון הסטנדרטי הזה של ה-API יוצר עקביות בין ממשקי ה-API, ומשפר את יעילות הפיתוח באמצעות Places API (חדש).
ביצועים משופרים
Places API (חדש) מספק ביצועים משופרים, ולכן כדאי להחליף אפליקציות שמשתמשות ב-Places API הקיים.
תמחור פשוט
התמחור ב-Places API (החדש) פשוט יותר, כך שאתם משלמים רק על הנתונים שאתם משתמשים בהם. כדי להטמיע תמחור פשוט, משתמשים במסכת שדה.
בגרסאות החדשות של Place Details, חיפוש בסביבה ו-חיפוש טקסט, אתם יכולים להשתמש במסכת שדות כדי לקבוע אילו שדות יוחזרו בתגובה. לאחר מכן, החיוב מתבצע רק על הנתונים שביקשתם. שימוש במסכת שדות הוא שיטה טובה לוודא שאתם לא מבקשים נתונים מיותרים, וכך להימנע מזמן עיבוד מיותר ומחיובים מיותרים.
נתוני תגובה עקביים לגבי מקום
בממשקי ה-API הקודמים, ממשקי ה-API של Place Details (מדור קודם), חיפוש בסביבה (מדור קודם) ו-חיפוש טקסט (מדור קודם) החזירו נתוני תגובה שונים לגבי מקום. Places API (החדש) יוצר סטנדרטיזציה של התגובה, כך שכל ממשקי ה-API האלה מחזירים את אותם נתונים לגבי מקום.
סוגי מקומות מורחבים
התגובה מה-API יכולה עכשיו להכיל את הסוג הראשי של המקום. לכל מקום יכול להיות ערך סוג אחד שמוגדר כסוג הראשי של המקום, כפי שמפורט בטבלה א'.
ה-API החדש כולל גם כמה סוגים חדשים. אתם יכולים להשתמש בסוגים החדשים האלה, ובסוגים הקיימים, בחיפוש באמצעות "חיפוש בסביבה (חדש)" ו"חיפוש טקסט (חדש)". הסוגים החדשים מפורטים בטבלה א'.
נתוני מקום דינמיים
Places API (החדש) תומך בנתוני תגובה דינמיים, כמו הזמינות של תחנת טעינה לרכב חשמלי או מחירי הדלק העדכניים בתחנת דלק. אפשר להשתמש בשדות התגובה האלה כדי ליצור חוויות משתמש דינמיות.