התכונות של 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 שיהיו זמינות באפליקציה:
- בפרויקט Google Cloud, מפעילים את Places API, את Places API (חדש) או את שניהם. למידע נוסף קראו את המאמר הפעלת ממשקי API.
- בהגבלות על מפתחות ה-API, מפעילים את Places API, את Places API (חדש) או את שניהם. מידע נוסף זמין במאמר הגבלת מפתחות API.
בקובץ build.gradle ברמת האפליקציה, מציינים מספר גרסה. מידע נוסף זמין במאמר התקנה.
מפעילים את האפליקציה באמצעות קריאה לשיטה
Places.initializeWithNewPlacesApiEnabled()
או ל-methodPlaces.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