סקירה כללית של 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 (New)	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() (הוצאה משימוש)

הוצא משימוש: השיטה Places.initialize הוצאה משימוש. במקום זאת, צריך להשתמש ב-Places.initializeWithNewPlacesApiEnabled(). שימו לב: כדי להשתמש ב-Places.initializeWithNewPlacesApiEnabled(), צריך להפעיל את Places API (חדש) במפתח ה-API במסוף Google Cloud.

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

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

• מעבר ל-Place Details (New)
• מעבר ל-Place Photos (חדש)
• מעבר להשלמה אוטומטית (חדש)

שיפורים ב-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:

• השלמה אוטומטית (חדש)
• Place Details (חדש)
• חיפוש בסביבה (חדש)
• תמונות של מקומות (חדש)
• חיפוש טקסט (חדש)

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

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

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

• התגובה של Place Details (New) כוללת עכשיו את המחלקה החדשה Review באובייקט Place. ה-class‏ Place מכילה את ה-method החדשה getReviews() כדי לתמוך בשדה הזה. מתקשרים אל 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) (חיפוש טקסט (חדש)). אפשר גם להשתמש בסוגים החדשים האלה, ובסוגים הקיימים, בחיפוש באמצעות חיפוש טקסט (חדש). הסוגים החדשים מופיעים בטבלה א'.