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