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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שדות

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

שדה תיאור
regularSecondaryOpeningHours תיאור של זמני ביצוע ספציפיים לפעולות מסוימות. שעות הפתיחה המשניות שונות משעות הפעילות הראשיות של העסק. לדוגמה, מסעדה יכולה לציין את שעות הפעילות של חלון השירות או של המשלוחים כשעות הפעילות המשניות שלה.
paymentOptions אפשרויות התשלום שהמקום מקבל. מקום יכול לקבל יותר מאפשרות תשלום אחת. אם הנתונים של אפשרות התשלום לא זמינים, השדה של אפשרות התשלום לא יוגדר. האפשרויות הן:
  • כרטיס אשראי
  • כרטיס חיוב
  • מזומן בלבד
  • תשלום דרך NFC
parkingOptions אפשרויות החניה שמוצעות במקום. האפשרויות הן:
  • חניונים בחינם
  • מגרשי חניה בתשלום
  • חניה ברחוב בחינם
  • שירותי החניה של רכבים
  • חניון בחינם
  • חניון בתשלום
subDestinations מקומות ייחודיים שקשורים למיקום מסוים. לדוגמה, טרמינלים בנמלי תעופה נחשבים ליעדי משנה של נמל התעופה.
fuelOptions המידע העדכני ביותר על סוגי הדלק שזמינים בתחנת דלק. המידע הזה מתעדכן באופן קבוע. האפשרויות כוללות:
  • סולר
  • בנזין רגיל ללא עופרת
  • ביניים
  • פרימיום
  • 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

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