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