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

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

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

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

Place Details (New)

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

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

Place Photos (New)

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

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

כדי לכלול את שם המשאב של התמונה בתשובה לבקשה של Place Details (חדש), חיפוש טקסט (חדש) או חיפוש בסביבה (חדש), צריך לכלול את השדה 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 השם המוצג של הסוג הראשי, מותאם לשפה של הבקשה, אם רלוונטי. רשימה מלאה של הערכים האפשריים מופיעה בקטע סוגים נתמכים.
entrances כניסות ליעד. כניסה היא זוג קואורדינטות יחיד של קו רוחב וקו אורך שמגדיר את המיקום של נקודת כניסה ויציאה של מקום.
navigationPoints נקודות ניווט ליעד. נקודת ניווט היא מיקום ליד כביש שבו הניווט יכול להסתיים, כולל אמצעי הגעה ושימושים נתמכים.

מאפיינים

‫Places API (החדש) כולל כמה מאפיינים חדשים:

מאפיין תיאור
outdoorSeating יש במקום מקומות ישיבה בחוץ.
liveMusic במקום יש מוזיקה חיה.
menuForChildren יש במקום תפריט ילדים.
servesCocktails מגישים במקום קוקטיילים.
servesDessert מגישים במקום קינוחים.
servesCoffee מגישים במקום קפה.
goodForChildren המקום מתאים לילדים.
allowsDogs מותר להכניס כלבים למקום.
restroom יש במקום שירותים.
goodForGroups המקום מתאים לקבוצות.
goodForWatchingSports המקום מתאים לצפייה באירועי ספורט.

אפשרויות נגישות

‫Places API (החדש) כולל את שדות האפשרויות הבאים שקשורים לנגישות:

שדה תיאור
wheelchairAccessibleParking במקום יש חנייה נגישה לכיסאות גלגלים.
wheelchairAccessibleEntrance יש במקום כניסה נגישה לכיסאות גלגלים.
wheelchairAccessibleRestroom יש במקום שירותים נגישים לכיסאות גלגלים.
wheelchairAccessibleSeating יש במקום מקומות ישיבה נגישים לכיסאות גלגלים.

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

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

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

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

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

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

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

מעבר ל-Places API (חדש)

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