התכונות של Places SDK ל-iOS שזמינות באפליקציה שלכם נקבעות על סמך שילוב של מספר גרסת ה-SDK (למשל 9.0.0) שציינתם ביחסי התלות של החבילות, וממשקי ה-API שהופעלו במפתח ה-API. במדריך הזה מוסבר מה ההבדלים בין הגרסאות ואיך בוחרים אילו גרסאות יופעלו באפליקציה.
מספרי גרסאות SDK
מספר הגרסה של ה-SDK שציינתם ביחסי התלות של החבילות קובע אם לאפליקציה יש גישה לתכונות שנוספו במהדורה מסוימת. לדוגמה, התכונה 'השלמה אוטומטית (חדשה)' זמינה רק ב-SDK בגרסה 9.0.0 ואילך.
מידע נוסף על השינויים שנוספו בכל גרסה של ה-SDK זמין בהערות המוצר של Places SDK ל-iOS.
גרסאות של Places API ל-Places SDK ל-iOS
בנוסף לציון מספר גרסת ה-SDK, צריך גם לבחור את שירות Places API שאליו ה-SDK קורא במסוף Google Cloud: Places API או Places API (חדש). יחד עם מספר גרסת ה-SDK, שירות ה-API שבוחרים קובע איזו גרסה של תכונות ספציפיות תהיה זמינה באפליקציה, כמו השלמה אוטומטית או השלמה אוטומטית (חדש). אפשר לציין רק מספר גרסה אחד של SDK, אבל אפשר להפעיל את Places API וגם את Places API (חדש) במפתח ה-API בו-זמנית. עם זאת, ברוב המקרים כדאי להפעיל את Places API (חדש) ולהשתמש בגרסאות (חדש) של תכונות ה-SDK באפליקציה.
בחירת גרסת ה-SDK ושירותי ה-API
כדי לבחור אילו תכונות של ה-SDK יהיו זמינות באפליקציה, מבצעים את הפעולות הבאות:
- בפרויקט ב-Google Cloud, מפעילים את Places API, Places API (חדש) או את שניהם. מידע נוסף זמין במאמר הפעלת ממשקי API
- בהגבלות על מפתח ה-API, מפעילים את Places API, את Places API (חדש) או את שניהם. מידע נוסף זמין במאמר הגבלת מפתחות API.
- כשמתקינים את ה-SDK, מציינים את מספר הגרסה. מידע נוסף זמין במאמר הגדרת פרויקט ב-Xcode.
מידע נוסף על בחירת השירות של Places API זמין במאמר הגדרת הפרויקט ב-Google Cloud.
תכונות ה-SDK שזמינות בכל גרסה
בטבלה הבאה מפורטות גרסאות ה-SDK וה-API הנדרשות לכל מאפיין של ה-SDK:
| Places SDK ל-iOS (חדש) | גרסת ה-SDK המינימלית | SDK של מקומות ל-iOS | גרסת ה-SDK המינימלית |
|---|---|---|---|
| פרטי המקום (חדש) | 9.0.0 | פרטי המקום | 3.0.0 |
| Place Photo (חדש) | 9.0.0 | Place Photo | 3.0.0 |
| חיפוש טקסט (חדש) | 8.5.0 | ||
| חיפוש בקרבת מקום (חדש) | 9.0.0 | ||
| השלמה אוטומטית (חדש) | 9.0.0 | השלמה אוטומטית | 3.0.0 |
| המיקום הנוכחי | 3.0.0 |
שיקולים לבחירת הגרסאות להפעלה
- אם אתם לקוחות חדשים שמתחילים להשתמש ב-Places SDK ל-iOS, כדאי להתחיל עם Places API (החדש) ועם ה-SDK החדש.
- לקוחות קיימים יכולים להמשיך להשתמש ב-SDK הקיים. עם זאת, כדי ליהנות משיפורי הביצועים ומשיפורים בתכונות של Places SDK ל-iOS (חדש), צריך להפעיל את Places API (חדש) ולהשתמש ב-SDK החדש. אין צורך בהעברה כשעוברים ל-SDK החדש. פשוט פועלים לפי השלבים שמפורטים בקטע בחירת גרסת ה-SDK ושירותי ה-API.
- ב-Places API (חדש) לא ניתן להשתמש בתכונות קיימות מסוימות, כמו המיקום הנוכחי,
GMSPlace.isOpenו-GMSPlace.isOpenAtDate.
שימוש ב-Places Swift SDK ל-iOS (גרסת טרום-השקה)
כדי להשתמש ב-Places Swift SDK ל-iOS (גרסת טרום-השקה), צריך לבצע את השלבים הבאים:
- מפעילים את Places API (חדש).
- מוסיפים את Places Swift SDK for iOS (Preview) ליחסי התלות.
- מפעילים את לקוח Places באמצעות
PlacesClient.
מידע נוסף על Places Swift SDK ל-iOS (בטא) זמין בסקירה הכללית או במדריך ההעברה.
מעבר לממשקי ה-API החדשים
אם אתם משתמשים ב-API קיים ואתם רוצים לעבור ל-API החדש, תוכלו לעיין במדריכי ההעברה הבאים לכל API:
שיפורים ב-Places SDK ל-iOS (חדש)
בקטע הזה מפורטות תכונות מרכזיות שנוספו ל-Places SDK ל-iOS (חדש).
הטמעה בפלטפורמה הרגילה של Google Cloud
Places SDK ל-iOS (חדש) מוטמע בתשתית השירות ב-Google Cloud. ההטמעה הזו מאפשרת לכם ליהנות מפלטפורמה מאובטחת ואמינה יותר. העיצוב הסטנדרטי הזה מביא רמה של עקביות בין ערכות ה-SDK, שמשפרת את יעילות הפיתוח באמצעות Places SDK ל-iOS (חדש).
ביצועים משופרים
Places SDK ל-iOS (הגרסה החדשה) מספק ביצועים משופרים, ולכן כדאי להחליף אפליקציות שמשתמשות ב-SDK הקיים.
תכונות חדשות
Places SDK ל-iOS (הגרסה החדשה) כולל את הגרסאות העדכניות ביותר של כל התכונות של ה-SDK:
תמחור פשוט
התמחור פשוט יותר ב-Places SDK ל-iOS (חדש), כך שמשלמים רק על הנתונים שבהם משתמשים. התמחור המפושט מיושם באמצעות רשימות שדות, שנקראות גם מסכות שדות.
ב-Places SDK ל-iOS ובחיפוש טקסט, משתמשים ברשימות שדות כדי לקבוע את רשימת השדות שתוחזר בתגובה. לאחר מכן, תחויבו רק על הנתונים שביקשת. שימוש ברשימת שדות הוא שיטה טובה לתכנון כדי לוודא שאתם לא מבקשים נתונים מיותרים, וכך להימנע מזמן עיבוד מיותר וחיובים מיותרים.
מידע מפורט על התמחור של שתי ערכות ה-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 (חדש). כלומר, עכשיו אפשר להשתמש בסוגי הנתונים הבאים כחלק מחיפוש:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality