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

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

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

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

מזהה מקום הוא מזהה ייחודי של מקום במסד הנתונים של מקומות Google ובמפות 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 יש מקומות ישיבה נגישים לכיסאות גלגלים.

מעבר לממשקי Places API החדשים

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