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

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

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

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

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

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

בנוסף לציון מספר הגרסה של ה-SDK, צריך לבחור גם את שירות Places API שה-SDK קורא לו במסוף Google Cloud: Places API או Places API (New). יחד עם מספר הגרסה של ה-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 (מקומות חדשים) או את שניהם. למידע נוסף, ראו הגבלת מפתחות API.

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

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

שירות חדש של חיפוש טקסט

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

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

  • השדה Place Details (New) כולל עכשיו את המחלקה החדשה Review באובייקט Place של התשובה. המחלקה Place מכילה את ה-method החדש 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 לטבלה א' של Places API (חדש). המשמעות היא שעכשיו אפשר להשתמש בסוגים האלה כחלק מהחיפוש:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality