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