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

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

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

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

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

תכונה	גרסת Places API	שיטת האתחול	גרסת SDK מינימלית
השלמה אוטומטית (חדש)	Places API (חדש)	initializeWithNewPlacesApiEnabled()	3.5.0
פרטי מקום (חדש)	Places API (חדש)	initializeWithNewPlacesApiEnabled()	3.3.0
חיפוש בסביבה (חדש)	Places API (חדש)	initializeWithNewPlacesApiEnabled()	3.5.0
תמונות של מקומות (חדש)	Places API (חדש)	initializeWithNewPlacesApiEnabled()	3.4.0
חיפוש טקסט (חדש)	Places API (חדש)	initializeWithNewPlacesApiEnabled()	3.3.0
השלמה אוטומטית למקומות	Places API (הגרסה הקודמת)	‫initialize() (הוצאה משימוש)
המיקום הנוכחי	Places API (הגרסה הקודמת)	‫initialize() (הוצאה משימוש)
Place Details	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 (חדש)
• מעבר ל-Autocomplete (New)

שיפורים ב-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 (חדש) ול-Place Photos (חדש)

• פרטי מקום (חדש) כוללים עכשיו את המחלקה החדשה ביקורת באובייקט Place של התגובה. המחלקה Place מכילה את השיטה החדשה getReviews() כדי לתמוך בשדה הזה. מפעילים את getReviews() כדי להחזיר עד חמש ביקורות על מקום.

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

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

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

תמחור פשוט

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

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

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

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

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