מידע על Places API (חדש)

Places API (החדש) כולל את ממשקי ה-API הבאים:

במסמך הזה תמצאו סקירה כללית של ממשקי ה-API החדשים.

פרטי מקום (חדש)

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

יש הרבה דרכים לקבל מזהה מקום. אתם יכולים להשתמש:

תמונה של מקום (חדש)

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

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

כדי לכלול את השם של מקור התמונה בתשובה מבקשה של פרטי מקום (חדש), חיפוש טקסט (חדש) או חיפוש בקרבת מקום (חדש), חשוב לכלול את השדה photos במסכת השדות של הבקשה.

חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש)

Places API כולל שני ממשקי API לחיפוש:

  • חיפוש טקסט (חדש)

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

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

  • חיפוש בקרבת מקום (חדש)

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

    מציינים סוג אחד או יותר של מקום שמגדירים את המאפיינים של המקום. לדוגמה, מציינים 'pizza_restaurant' ו-'shopping_mall' כדי לחפש פיצרייה שנמצאת בקניון באזור שצוין.

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

השלמה אוטומטית (חדשים) ואסימוני סשן

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

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

שדות, מאפיינים ואפשרויות נגישות חדשים

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

שדות

Places API (חדש) כולל כמה שדות חדשים:

שדה תיאור
regularSecondaryOpeningHours מתאר זמנים מסוימים לפעולות מסוימות. שעות הפתיחה המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה, מסעדה יכולה לציין את שעות הנסיעה או את שעות המשלוח כשעות משניות של מסעדה.
paymentOptions אפשרויות התשלום שהמקום מקבל. מקום יכול לקבל יותר מאפשרויות תשלום אחת. אם הנתונים של אפשרות התשלום לא זמינים, השדה של אפשרות התשלום לא יהיה מוגדר. האפשרויות כוללות:
  • כרטיס אשראי
  • כרטיס חיוב מיידי
  • מזומן בלבד
  • תשלום דרך NFC
parkingOptions אפשרויות החניה שמסופקות על ידי המקום. האפשרויות כוללות:
  • חניונים בחינם
  • חניונים בתשלום
  • חניה ברחוב בחינם
  • שירותי החניה של רכבים
  • חניון בחינם
  • חניון בתשלום
subDestinations מקומות ייחודיים שקשורים למקום מסוים. לדוגמה, טרמינלים של נמלי תעופה נחשבים ליעדי משנה של שדה תעופה.
fuelOptions המידע העדכני ביותר על אפשרויות דלק זמין בתחנת דלק. המידע הזה מתעדכן באופן קבוע. האפשרויות כוללות:
  • סולר
  • רגילה ללא עופרת
  • ביניים
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • גפ"מ
  • E80
  • E85
  • מתאן
  • ביו-דיזל
  • סולר למשאית
evChargeOptions מספר המטענים לרכב חשמלי (EV) בתחנה הזו. לחלק מהמטענים לרכב חשמלי יש כמה מחברים, אבל כל מטען יכול להטעין רק רכב אחד בכל פעם. כתוצאה מכך, השדה הזה משקף את מספר המטענים הזמינים כרגע.
shortFormattedAddress כתובת קצרה של מקום, שבודק אנושי יכול לקרוא.
primaryType הסוג הראשי של התוצאה הנתונה. לדוגמה: מקום יכול להיות מסווג כcafe או כairport. למקום יכול להיות רק סוג ראשי אחד. הרשימה המלאה של הערכים האפשריים זמינה במאמר סוגים נתמכים.
primaryTypeDisplayName השם המוצג של הסוג הראשי, שמותאם לשפת הבקשה, אם רלוונטי. הרשימה המלאה של הערכים האפשריים זמינה במאמר סוגים נתמכים.

מאפיינים

Places API (החדש) כולל מספר מאפיינים חדשים:

מאפיין תיאור
outdoorSeating יש במקום מקומות ישיבה בחוץ.
liveMusic במקום יש מופעי מוזיקה חיים.
menuForChildren יש במקום תפריט ילדים.
servesCocktails במקום מוגשים קוקטיילים.
servesDessert קינוחים במקום.
servesCoffee במקום מגישים קפה.
goodForChildren המקום מתאים לילדים.
allowsDogs מותר להכניס כלבים.
restroom במקום יש שירותים.
goodForGroups המקום יכול להתארח בקבוצות.
goodForWatchingSports המקום מתאים לצפייה באירועי ספורט.

אפשרויות של נגישות

Places API (חדש) כולל את השדות הבאים של אפשרויות נגישות:

שדה תיאור
wheelchairAccessibleParking במקום יש חניה נגישה לכיסאות גלגלים.
wheelchairAccessibleEntrance יש במקום כניסה נגישה לכיסאות גלגלים.
wheelchairAccessibleRestroom במקום יש שירותים נגישים לכיסאות גלגלים.
wheelchairAccessibleSeating במקום יש מקומות ישיבה נגישים לכיסאות גלגלים.

מעבר לממשקי ה-API של מקומות חדשים

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