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

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

בחירת גרסה של SDK ושירותי API

כדי לבחור אילו תכונות של ה-SDK יהיו זמינות באפליקציה, מבצעים את הפעולות הבאות:

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

  1. מפעילים את Places API (חדש).
  2. מוסיפים את Places Swift SDK for iOS (Preview) ליחסי התלות.
  3. מפעילים את לקוח 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
יועץ מנחת מסוקים 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