סקירה כללית של Places SDK ל-Android (מדור קודם)

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

תכונות SDK שזמינות בכל גרסה

בטבלה הבאה מפורטות הגרסאות של ה-SDK וה-API שנדרשות לכל תכונה של ה-SDK:

תכונה גרסת Places API שיטת האתחול גרסת SDK מינימלית
השלמה אוטומטית (חדש) Places API (חדש) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (חדש) Places API (חדש) initializeWithNewPlacesApiEnabled() 3.3.0
חיפוש בסביבה (חדש) Places API (חדש) initializeWithNewPlacesApiEnabled() 3.5.0
Place Photos (חדש) Places API (חדש) initializeWithNewPlacesApiEnabled() 3.4.0
חיפוש טקסט (חדש) Places API (חדש) initializeWithNewPlacesApiEnabled() 3.3.0
השלמה אוטומטית למקומות Places API (גרסה קודמת) ‫initialize() (הוצאה משימוש)
המיקום הנוכחי Places API (גרסה קודמת) ‫initialize() (הוצאה משימוש)
פרטי מקום Places API (גרסה קודמת) ‫initialize() (הוצאה משימוש)
Place Photos Places API (גרסה קודמת) ‫initialize() (הוצאה משימוש)

מעבר לממשקי ה-API החדשים

כדי לעבור לגרסאות החדשות של ממשקי ה-API, אפשר לעיין במדריכי המיגרציה הבאים:

שיפורים ב-Places SDK ל-Android (חדש)

בקטע הזה מפורטות התכונות העיקריות שנוספו ל-Places SDK ל-Android (חדש).

הטמעה בפלטפורמה הרגילה של Google Cloud

‫Places SDK ל-Android (חדש) מיושם בתשתית השירות ב-Google Cloud. ההטמעה הזו יוצרת פלטפורמה מאובטחת ומהימנה יותר. העיצוב הסטנדרטי הזה יוצר רמת עקביות בין ערכות ה-SDK, וכך משפר את היעילות של הפיתוח באמצעות Places SDK ל-Android (חדש).

ביצועים משופרים

‫Places SDK ל-Android (חדש) מספק ביצועים משופרים, ולכן כדאי להחליף את האפליקציות שמשתמשות ב-SDK הקיים.

תכונות חדשות

‫Places SDK ל-Android (חדש) כולל את הגרסאות העדכניות של כל התכונות של ה-SDK:

חיפוש טקסט (חדש)

חיפוש טקסט (חדש) מחזיר מידע על קבוצת מקומות על סמך מחרוזת – לדוגמה, 'פיצה בתל אביב', 'חנויות נעליים ליד ירושלים' או 'רחוב המלך ג'ורג' 123'. השירות מגיב עם רשימה של מקומות שתואמים למחרוזת הטקסט ולכל הטיה של מיקום שהוגדרה.

נתוני תגובה חדשים נוספו ל-Place Details (New) ול-Place Photos (New)

  • ‫Place Details (חדש) כולל עכשיו את המחלקה החדשה Review באובייקט Place של התגובה. המחלקה Place מכילה את ה-method החדש getReviews() כדי לתמוך בשדה הזה. ‫Call getReviews() כדי להחזיר עד חמש ביקורות על מקום.

  • ‫Place Photos (New) מוסיף את AuthorAttributions למחלקת PhotoMetadata. ‫AuthorAttributions מכיל List של אובייקטים מסוג AuthorAttribution.

נוספה תגובת URI חדשה ל-Place Photos (חדש)

מעכשיו אפשר להשתמש ב-Place Photos (New) כדי להחזיר URI למפת סיביות של תמונה. בעבר, יכולתם להחזיר רק את מפת הסיביות של התמונה עצמה.

תמחור פשוט

התמחור ב-Places SDK ל-Android (חדש) פשוט יותר, כך שאתם משלמים רק על הנתונים שבהם אתם משתמשים. תמחור פשוט מיושם באמצעות רשימות שדות, שנקראות גם מסכות שדות.

בשיטות Place Details (חדש) ו-חיפוש טקסט (חדש), משתמשים ברשימות שדות כדי לשלוט ברשימת השדות שיוחזרו בתגובה. החיוב מתבצע רק על הנתונים שביקשתם. שימוש ברשימת שדות הוא שיטת עיצוב מומלצת כדי לוודא שלא תבקשו נתונים מיותרים, וכך להימנע מזמן עיבוד מיותר ומחיובים מיותרים.

מידע נוסף על תמחור מופיע במאמר בנושא שימוש וחיוב.

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

ה-SDK החדש כולל סוגים חדשים של מקומות, שמוחזרים כחלק מהתגובה של Place Details (New) (פרטי מקום (חדש)) ושל Text Search (New) (חיפוש טקסט (חדש)). אפשר גם להשתמש בסוגים החדשים האלה, ובסוגים הקיימים, בחיפוש באמצעות חיפוש טקסט (חדש). הסוגים החדשים מופיעים בטבלה א'.