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

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

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

רשימת ממשקי API

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

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

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

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

  • Places API (New): הפעלת כל ממשקי ה-API והתכונות החדשים שמתוארים במאמר תכונות עיקריות שנוספו ל-Places SDK ל-iOS (New). לאפליקציה לא תהיה גישה לממשקי ה-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 של Place Details, Nearby Search ו-Text Search החזירו נתוני תגובה שונים לגבי מקום מסוים. 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 (חדש) העביר את הסוגים הבאים מטבלה ב' מטבלה א'. כלומר, עכשיו אפשר להשתמש בסוגים האלה כחלק מהחיפוש:
  • 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 החדשים.

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