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

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

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

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

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

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

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

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

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

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

תגובת 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
יועץ מסוקים מגרש משחקים 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