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