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

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

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

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

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

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

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

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

כל הבקשות ל-Place Photos 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 יש במקום מקומות ישיבה נגישים לכיסאות גלגלים.

סיכומים מבוססי-AI

Places API (חדש) סיכומים מבוססי-AI שמשתמשים ביכולות של מודל Gemini כדי להציג סיכומים של מקומות ואזורים שיכולים לעזור למשתמשים להחליט לאן ללכת.

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

תכונות מבוססות-AI נוספו ל-Places API (חדש)

סיכומים מבוססי-AI נתמכים בפרטי המיקום (חדש), בחיפוש טקסט (חדש) ובחיפוש בקרבת מקום (חדש). הסיכומים הבאים מבוססי-AI זמינים בתשובות של Places API (חדש):

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

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

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

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