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