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