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

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

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

  1. בפרויקט ב-Google Cloud, מפעילים את Places API, Places API (חדש) או את שניהם. מידע נוסף מופיע במאמר הפעלת ממשקי API.
  2. בהגבלות על מפתחות ה-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 Place , GMSPlace.isOpen ו-GMSPlaceisOpenAtDate.

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

אם ברצונך להשתמש במהדורת Preview של GooglePlacesSwift גרסה 0.1.0, צריך להפעיל את Places API (New) ולהתקין את ה-SDK של 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
יועץ מסוקים 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