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

ב-Places API יש תמיכה בשתי גרסאות API: Places API הן ממשקי ה-API הקיימים, ו-Places API (חדש) הן הגרסה הבאה של ממשקי ה-API.

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

רשימת ממשקי ה-API

שתי קבוצות ממשקי ה-API מפורטות בטבלה הבאה. לקוחות קיימים יכולים להיעזר בטבלה הזו כדי לזהות את ממשק ה-API החדש שמחליף את ממשק ה-API שבו הם משתמשים כרגע.

Places API Places API (חדש) הערה
חיפוש מקום חיפוש טקסט (חדש) אין גרסה חדשה של 'חיפוש מקום'. הוא הוחלף בתכונה 'חיפוש טקסט (חדש)'.
חיפוש בקרבת מקום חיפוש בקרבת מקום (חדש) בכל הבקשות שמשתמשות ב-API הקיים וכוללות שאילתה בטקסט, צריך להשתמש ב-חיפוש טקסט (חדש) כי חיפוש בקרבת מקום (חדש) לא תומך בקלט טקסט.
חיפוש טקסט חיפוש טקסט (חדש)
פרטי המקום פרטי המקום (חדש)
Place Photo Place Photo (חדש)
השלמה אוטומטית למקומות השלמה אוטומטית (חדש)
השלמה אוטומטית של שאילתות השלמה אוטומטית (חדש) יכולות נוספות להשלמה אוטומטית (חדש)

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

  • Places API: מפעיל את ממשקי ה-API הקיימים. אם רק Places API מופעל בפרויקט שמשויך למפתח ה-API שמשמש את האפליקציה, לא תהיה לאפליקציה גישה לממשקי ה-API החדשים.

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

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

כשמשתמשים ב-Details of Place (חדש), ב-Nearby Search (חדש) וב-Text Search (חדש), אפשר להשתמש במסכת השדות כדי לקבוע את רשימת השדות שתוחזר בתגובה. לאחר מכן, תחויבו רק על הנתונים שביקשת. שימוש בהסוואת שדות הוא שיטה טובה לתכנון כדי לוודא שאתם לא מבקשים נתונים מיותרים, וכך להימנע מזמן עיבוד מיותר וחיובים מיותרים.

נתוני תגובות עקביים לגבי מקום

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

איזה ממשק API בוחרים?

לפני שמתחילים לפתח אפליקציה, צריך לבחור את ממשק ה-API:

  1. אם אתם לקוחות חדשים שמתחילים להשתמש ב-Places API, כדאי להתחיל עם ממשקי ה-API החדשים.

  2. אם אתם לקוחות חדשים ועדיין אין תחליף לממשק API קיים, כמו השלמה אוטומטית של מקומות או השלמה אוטומטית של שאילתות, תוכלו להשתמש בשילוב של ממשקי API חדשים וקיימים.

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

    מידע נוסף על העברת נתונים זמין במאמר סקירה כללית על העברת נתונים.