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