סקירה כללית על Places API (קודם)

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

‫Places API מאפשר לחפש ולאחזר מידע על מגוון סוגי מקומות באמצעות מחרוזת טקסט או לפי קרבה. ‫Places API (מדור קודם) הוא הגרסה הקודמת של Places API (חדש).

בטבלה הבאה מפורטות הגרסאות התואמות של שני ממשקי ה-API. המדריך הזה מסביר את ההבדלים העיקריים בין שני סוגי ה-API ומראה איך לעבור ל-Places API (חדש).

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

סוגי מקומות מורחבים

תגובת ה-API יכולה עכשיו להכיל את הסוג הראשי של מקום. לכל מקום יכול להיות ערך סוג יחיד שמוגדר כסוג הראשי של המקום, כמו שמפורט בטבלה א'.

בנוסף, ה-API החדש כולל כמה סוגים חדשים. אתם יכולים להשתמש בסוגים החדשים האלה, וגם בסוגים הקיימים, בחיפוש באמצעות חיפוש בסביבה (חדש) וחיפוש טקסט (חדש). כל הסוגים החדשים כלולים בטבלה א'.

נתוני מקום דינמיים

‫Places API (חדש) תומך בנתוני תגובה דינמיים, כמו הזמינות של תחנת טעינה לרכב חשמלי או מחירי הדלק העדכניים בתחנת דלק. אפשר להשתמש בשדות התגובה האלה כדי ליצור חוויות משתמש דינמיות.