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

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

מבוא

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

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

Place Details (חדש)

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

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

Place Photos (New)

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

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

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

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

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

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

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

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

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

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

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

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

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

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