בחירה של גרסת ה-SDK

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

מספרי גרסאות של SDK

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

מידע נוסף על השינויים בכל גרסה של ה-SDK זמין בהערות לגרסה של Places SDK ל-Android.

גרסאות Places API ל-Places SDK ל-Android

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

בחירת גרסת ה-SDK ושירותי ה-API

כדי לבחור אילו תכונות של ה-SDK יהיו זמינות באפליקציה, מבצעים את הפעולות הבאות:

  1. בפרויקט ב-Google Cloud, מפעילים את Places API,‏ Places API (חדש) או את שניהם. מידע נוסף זמין במאמר הפעלת ממשקי API
  2. בהגבלות של מפתח ה-API, מפעילים את Places API, את Places API (חדש) או את שניהם. מידע נוסף זמין במאמר הגבלת מפתחות API.

  3. בקובץ build.gradle ברמת האפליקציה, מציינים את מספר הגרסה. למידע נוסף, ראו התקנה.

  4. כדי לאתחל את האפליקציה, צריך להפעיל את השיטה Places.initializeWithNewPlacesApiEnabled() או את השיטה Places.initialize().

מידע נוסף על בחירת שירות Places API זמין במאמר הגדרת הפרויקט ב-Google Cloud.

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

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

תכונה הפעלת Places API במפתח 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()
פרטי המקום Places API initialize()
מיקום תמונות Places API initialize()

שיקולים לבחירת הגרסאות להפעלה

כדי לעזור לכם להחליט איזו גרסה לבחור, כדאי להביא בחשבון את הדברים הבאים:

  • אם אתם לקוחות חדשים שמתחילים להשתמש ב-Places SDK ל-Android, כדאי להתחיל עם Places API (חדש) ועם ה-SDK החדש.
  • לקוחות קיימים יכולים להמשיך להשתמש ב-SDK הקיים. עם זאת, כדי ליהנות משיפורי הביצועים ומשיפורי התכונות של Places SDK ל-Android (הגרסה החדשה), מומלץ להשתמש ב-SDK החדש. אין צורך בהעברה כשעוברים ל-SDK החדש. פשוט פועלים לפי השלבים שמפורטים בקטע בחירת גרסת ה-SDK ושירותי ה-API.
  • ב-Places SDK ל-Android (הגרסה החדשה), אסימוני סשנים זמינים החל מגרסה 3.5.0. מידע נוסף זמין במאמר אסימוני סשן.
  • קריאות שמבוצעות באמצעות ווידג'טים של השלמה אוטומטית של מקומות מתבצעות תמיד ל-Place Autocomplete ולא ל-Place Autocomplete (New). קריאות לווידג'טים לא מושפעות משיטת האיניציאציה.
  • Place Photos (חדש) מחזירה רק URI לתמונה בפורמט bitmap, ואילו Place Photos מחזירה רק תמונה בפורמט bitmap.
  • המיקום הנוכחי זמין רק ב-Places SDK ל-Android, ולא ב-Places SDK ל-Android (חדש).

שיפורים ב-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'. השירות משיב עם רשימה של מקומות שתואמים למחרוזת הטקסט ולנטייה למיקום שהוגדרה.

נתוני תגובה חדשים נוספו ל'פרטי המיקום' (חדש) ול'תמונות של המיקום' (חדש)

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

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

תגובה חדשה של URI נוספה לתמונות של מקומות (חדש)

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

תמחור פשוט

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

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

מידע מפורט על התמחור של שתי ערכות ה-SDK זמין במאמר שימוש וחיובים.

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

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

סוג
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant חווה korean_restaurant sporting_goods_store
barber_shop לינה ועבודה בחווה lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal שוק steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant תפירה
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant מוטל thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
יועץ מנחת מסוקים מגרש משחקים vegetarian_restaurant
convention_center hiking_area גן ילדים vietnamese_restaurant
קוטג' historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center אכסניה resort_hotel סיטונאי
dental_clinic hotel rest_stop

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

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality