בחירה של גרסת ה-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 הקיימים. אם רק Places API מופעל עבור הפרויקט המשויך אל מפתח ה-API שמשמש את האפליקציה שלך, לא תהיה לאפליקציה שלך גישה לממשקי ה-API החדשים.

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

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

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

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

איזה API לבחור?

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

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

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

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

    למידע נוסף על מיגרציה, אפשר לעיין במאמר בנושא העברה סקירה כללית.