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

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

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

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

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

Places גרסאות API של Places SDK ל-iOS

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

שיקולים לבחירת גרסאות להפעלה

  • אם אתם לקוחות חדשים שרק מתחילים לעבוד עם Places SDK ל-iOS, בתור Places API (חדש) ובערכת ה-SDK החדשה.
  • לקוחות קיימים יכולים להמשיך להשתמש בערכת ה-SDK הקיימת. עם זאת, כדי לנצל את השיפור בביצועים ואת התכונה שיפורים של Places SDK ל-iOS (חדש), כדאי להפעיל את Places API (חדש) ומשתמשים בערכת ה-SDK החדשה. לא נדרשת העברה כשעוברים אל ערכת ה-SDK החדשה, פשוט פועלים לפי השלבים שמפורטים בקטע בחירה של גרסת ה-SDK וה-API שירותים שונים.
  • Places API (חדש) לא מפעיל חלק קיים תכונות כגון Current מקום, GMSPlace.isOpen וגם GMSPlaceisOpenAtDate.

שימוש בגרסת טרום-השקה (Preview) של GooglePlacesSwift

כדי להשתמש ב-GooglePlacesSwift, יש לבצע את השלבים הבאים:

  1. הפעלת Places API (חדש).
  2. מוסיפים את GooglePlacesSwiftSDK ליחסי התלות שלכם.
  3. אתחול הלקוח של 'מקומות' עם PlacesClient

למידע נוסף על GooglePlacesSwift, כדאי לעיין בחומר העזר תיעוד.

מעבר לממשקי ה-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 (חדש). המשמעות היא שעכשיו אפשר להשתמש בסוגים האלה חיפוש:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality