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

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

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

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

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

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

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

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

כל הבקשות ל-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 API ואתם רוצים להעביר את האפליקציה שלכם אל להשתמש בממשקי ה-API החדשים. תוכלו להיעזר במסמכי התיעוד הבאים בנושא ההעברה: