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

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

מבוא

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

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

Place Details (New)

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

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

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

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

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

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

חיפוש טקסט (חדש) וחיפוש בסביבה (חדש)

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

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

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

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

  • חיפוש בסביבה (חדש)

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

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

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

השלמה אוטומטית (חדשה) וטוקנים של סשנים

‫Autocomplete (חדש) הוא שירות אינטרנט שמחזיר חיזויים של מקומות וחיזויים של שאילתות בתגובה לבקשת HTTP. בבקשה, מציינים מחרוזת לחיפוש טקסט וגבולות גיאוגרפיים שקובעים את אזור החיפוש.

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

שדות, מאפיינים ואפשרויות נגישות חדשים

‫Places API (חדש) כולל שדות, מאפיינים ואפשרויות חדשים של נגישות כדי לספק למשתמשים מידע נוסף על מקום מסוים. ההיבטים האלה מתוארים בקטעים הבאים.

שדות

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

שדה תיאור
regularSecondaryOpeningHours מתאר זמנים מסוימים לפעולות מסוימות. שעות פתיחה משניות שונות משעות הפתיחה העיקריות של העסק. לדוגמה, מסעדה יכולה לציין את השעות שבהן אפשר להזמין ולקבל משלוח או להזמין ולקבל את האוכל מהרכב כשעות פעילות משניות.
paymentOptions אפשרויות התשלום שהמקום מקבל. יכול להיות שבמקום מסוים מקבלים יותר מאפשרות תשלום אחת. אם נתוני אמצעי התשלום לא זמינים, השדה של אמצעי התשלום לא יוגדר. האפשרויות כוללות את הפעולות הבאות:
  • כרטיס אשראי
  • כרטיס חיוב
  • מזומן בלבד
  • תשלום דרך NFC
parkingOptions אפשרויות החניה שזמינות במקום. האפשרויות כוללות את הפעולות הבאות:
  • חניונים בחינם
  • מגרשי חניה בתשלום
  • חניה ברחוב בחינם
  • שירותי החניה של רכבים
  • חניון בחינם
  • חניון בתשלום
subDestinations מקומות ייחודיים שקשורים למקום מסוים. לדוגמה, טרמינלים בנמל תעופה נחשבים ליעדי משנה של נמל התעופה.
fuelOptions המידע העדכני ביותר על אפשרויות הדלק שזמינות בתחנת דלק. המידע הזה מתעדכן באופן קבוע. האפשרויות כוללות:
  • סולר
  • רגיל ללא עופרת
  • ביניים
  • פרימיום
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • גפ"מ
  • E80
  • E85
  • מתאן
  • ביו-דיזל
  • סולר למשאית
evChargeOptions מספר המטענים לרכבים חשמליים בתחנה. למרות שלחלק מעמדות הטעינה לרכבים חשמליים יש כמה מחברים, כל עמדת טעינה יכולה לטעון רק רכב אחד בכל פעם. לכן, השדה הזה משקף את מספר עמדות הטעינה לרכבים חשמליים שזמינות בזמן נתון.
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

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

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

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

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

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

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

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

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