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

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

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

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

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

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

בנוסף לציון מספר גרסת SDK, צריך לבחור גם את שירות Places API ש-SDK קורא ב-Google Cloud Console: 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() או ל-method 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.
  • ב-Place SDK ל-Android (חדש), אסימוני הפעלה זמינים החל מגרסה 3.5.0. מידע נוסף זמין במאמר אסימוני סשן.
  • קריאות שמבוצעות באמצעות ווידג'טים של השלמה אוטומטית של מקומות קוראות תמיד להשלמה אוטומטית של מקום, ולא להשלמה אוטומטית של מקום (חדש). קריאות לווידג'ט לא מושפעות משיטת האתחול.
  • האפשרות Place Photos (New) מחזירה רק URI לתמונה של מפת סיביות (bitmap), והאפשרות Place Photos מחזירה רק תמונה של מפת סיביות (bitmap).
  • המיקום הנוכחי זמין רק ב-Place SDK ל-Android, ולא ב-Places SDK ל-Android (חדש).

שיפורים ב-Place 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) כולל עכשיו את המחלקה החדשה Review באובייקט התגובה Place. המחלקה Place כוללת את השיטה החדשה getReviews() שתומכת בשדה הזה. אפשר להתקשר אל getReviews() כדי להחזיר עד חמש ביקורות על מקום.

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

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

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

תמחור פשוט

התמחור פשוט יותר באמצעות 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
יועץ מנחת מסוקים playground 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 ל-Table A של Places API (חדש). כלומר, עכשיו אפשר להשתמש בסוגים האלה כחלק מהחיפוש:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality