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

Places SDK ל-iOS בגרסה 8.5.0 תומך בשתי גרסאות SDK: Places SDK עבור iOS היא הגרסה הקיימת של Places SDK ל-iOS (חדש) – הגרסה הבאה של ה-SDK.

הערה: כל התכונות החדשות שכלולות בגרסה הזו הן חלק מ-Places SDK ל-iOS (חדש) והן לא זמינות ב-Places SDK ל-iOS.

בגרסה 8.5.0 של Places SDK ל-iOS, המשימה הראשונה שלכם היא להחליט באיזה SDK להשתמש. הדבר רלוונטי ללקוחות חדשים או ללקוחות קיימים שכבר משתמשים ב-SDK. המדריך הזה יעזור לכם להבין את ההבדלים העיקריים בין שתי ערכות ה-SDK.

איך בוחרים את גרסת ה-SDK

Places SDK ל-iOS מסתמך על השירות Places API. כדי להשתמש ב-Places SDK ל-iOS, צריך להפעיל את השירות Places API בפרויקט שלכם ב-Google Cloud.

הגרסה של שירות Places API שמפעילים שולטים בגרסת ה-SDK שבה האפליקציה משתמשת:

• Places API: מפעיל את Places SDK ל-iOS הקיים. אם רק Places API מופעל בפרויקט שמשויך למפתח ה-API שבו האפליקציה משתמשת, לא תהיה לאפליקציה גישה לתכונות החדשות שנוספו ב-Places SDK for iOS בגרסה 8.5.0 ואילך.

• Places API (חדש): מפעיל את האפשרות Places SDK ל-iOS (חדש) כולל חיפוש טקסט וכל התכונות החדשות שמתוארות במאמר תכונות עיקריות שנוספו ל-Places SDK עבור iOS (חדש). התכונה לא מפעילה תכונות קיימות כמו פרטי מקום, תמונות של מקום, המקום הנוכחי והשלמה אוטומטית של מקום.

• שניהם: הפעלה של כל התכונות עבור Places SDK ל-iOS (New) ו-Places SDK ל-iOS.

למידע נוסף על בחירת השירות Places API, קראו את המאמר הגדרת הפרויקט ב-Google Cloud.

באיזה SDK בחרת?

כדי להחליט באיזו גרסה לבחור:

1. אם אתם לקוחות חדשים שרק מתחילים להשתמש ב-Places SDK ל-iOS, כדאי לכם להתחיל עם Places API (New) ו-Places API כדי לקבל גישה לכל התכונות.

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

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

תכונות עיקריות שנוספו ל-Places SDK ל-iOS (חדש)

בקטע הזה מתוארים תכונות עיקריות שנוספו ל-Places SDK for iOS (חדש).

הטמעה בפלטפורמה הסטנדרטית של Google Cloud

ה-Places SDK ל-iOS (חדש) מוטמע בתשתית השירות ב-Google Cloud. ההטמעה הזו מספקת פלטפורמה מאובטחת ומהימנה יותר. עיצוב סטנדרטי זה מספק רמה של עקביות בין ערכות ה-SDK שמשפרות את יעילות הפיתוח באמצעות Places SDK for iOS (New).

ביצועים משופרים

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

שירות חדש של חיפוש טקסט

חיפוש טקסט מחזיר מידע על קבוצת מקומות על סמך מחרוזת, לדוגמה "פיצה בתל אביב" או "חנויות נעליים ליד אוטווה" או "הרצל 123". בתגובה לשירות מוצגת רשימה של מקומות שתואמים למחרוזת הטקסט ולכל הטיה של המיקום שהוגדרה.

תמחור פשוט

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

בעזרת Places SDK ל-iOS ו-Text Search, אפשר להשתמש ברשימות של שדות כדי לקבוע את רשימת השדות שיוחזרו בתגובה. לאחר מכן תחויבו רק על הנתונים המבוקשים. מומלץ להשתמש ברשימת שדות כדי להבטיח שלא תבקשו נתונים מיותרים, וכך להימנע מזמן עיבוד ומחיובים מיותרים.

למידע מפורט על התמחור של שתי ערכות ה-SDK, ראו שימוש וחיוב.

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

• country
• administrative_area_level_1
• administrative_area_level_2
• postal_code
• locality