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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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